Skip to main content
Transform your testing process with: Real Device Features, Company-wide Licences, & App Percy

Simulate GPS Location

GPS Geolocation testing enables you to simulate the location of the device to specific GPS coordinates in order to test location-based scenarios for your app.

In order to specify the GPS coordinates, you need to pass the gpsLocation parameter in the REST API request to start XCUI test execution. You will be required to pass the latitude and longitude of the desired location.

REST API endpoint :

POST /app-automate/xcuitest/v2/build
Parameter Description Value
gpsLocation Simulate the location of the device to a specific GPS location. Latitude followed by longitude
Acceptable range for latitude is -90 to +90 and for longitude is -180 to +180.
Example: 40.730610,-73.935242

Example cURL request :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"gpsLocation": "40.730610,-73.935242", "devices": ["iPhone 8 Plus-11.0"], "app": "bs://f5L3azt9pLzE995f49376eb1fa3c284dc321f8d", "testSuite": "bs://6eb1fa3c284ddbe9971b2d1aee0d52943b9c081"}' \
-H "Content-Type: application/json"

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback!

Talk to an Expert
Download Copy