> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qawolf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mock device location (Android)

> Set a custom GPS location on the Android emulator to test location-aware features in your app.

Use `device.setGeoLocation()` to override the emulator's GPS coordinates during a flow. This lets you test location-aware features — such as store finders, delivery zones, or region-specific content — without physically moving a device.

See the [Android Device Reference](/qawolf/libraries/flows/api-reference/android-device-reference) for the full `setGeoLocation` API.

## Examples

**Set a GPS location**

```typescript theme={null}
await device.setGeoLocation({
  latitude: 40.78222,
  longitude: -73.96528,
});
```

## When to use

* Your app shows location-aware content such as store finders, delivery zones, or regional pricing.
* Your app restricts features by geography and you need to test from a specific location.
* Your app uses GPS coordinates to personalize content and you need to assert on that behavior.
* Your test needs to simulate a device in a different city or country.

## Troubleshooting

Some apps don't immediately respond to a location change. Try one or more of the following.

**Grant location permissions automatically**

Pass `autoGrantPermissions: true` in your launch options.

```typescript theme={null}
const { driver } = await launch({
  appPackage: "com.example.app",
  autoGrantPermissions: true,
});
```

**Toggle location services**

```typescript theme={null}
await driver.toggleLocationServices();
await driver.toggleLocationServices();
```

**Reload the session**

```typescript theme={null}
await device.setGeoLocation({
  latitude: 40.78222,
  longitude: -73.96528,
});

await driver.reloadSession();
```

**Prime location tracking via Google Maps**

Some apps rely on the system location provider being active. Open Google Maps and trigger location tracking before your app reads the location, then reload the session.

```typescript theme={null}
await driver.activateApp("com.google.android.apps.maps");

const skipBtn = driver.$(`//android.widget.Button[@text='SKIP']`);
if (await skipBtn.isExisting()) {
  await skipBtn.click();
}

const locationBtn = driver.$(
  `//android.widget.FrameLayout[@resource-id='com.google.android.apps.maps:id/mylocation_button']`,
);
const contentDesc = await locationBtn.getAttribute("content-desc");
if (contentDesc.includes("Re-center")) {
  await locationBtn.click();
}

const permissionBtn = driver.$(
  `//android.widget.Button[@resource-id='com.android.permissioncontroller:id/permission_allow_foreground_only_button']`,
);
if (await permissionBtn.isExisting()) {
  await permissionBtn.click();
}

await driver.reloadSession();
```

## Full sample test

```typescript theme={null}
import { device, flow, launch } from "@qawolf/flows/android";

export default flow(
  "Test location feature",
  { target: "Android - Pixel", launch: true },
  async ({ driver, test }) => {
    await test("set location and verify location-based content", async () => {
      // Arrange
      await driver.$(`//*[@text='Find Stores']`).click();

      // Act
      await device.setGeoLocation({
        latitude: 40.78222,
        longitude: -73.96528,
      });

      // Assert
      await driver
        .$(`//*[@text='Stores near Central Park']`)
        .waitForDisplayed({ timeout: 10_000 });
    });
  },
);
```