Geolocation Guide

Test location-based features by overriding browser geolocation. Perfect for testing maps, location-based content, and geo-restricted features.

Overview

Override the browser's geolocation to test how your website behaves in different locations without physically being there. Useful for testing maps, location services, geo-restricted content, and store locators.

When to use geolocation?

• Test location-based features from different cities/countries
• Verify map applications show correct data
• Test geo-restricted content or services
• Capture screenshots of store locator results

Geolocation Parameters

geolocation_latitude & geolocation_longitude

Set the GPS coordinates (latitude and longitude) for the browser geolocation. Must provide both values together to override location.

Latitude Range:-90 to 90

Longitude Range:-180 to 180

Set Custom Location•javascript

const response = await fetch('https://www.snapshotai.dev/api/v1/screenshots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://maps-app.com',
    options: {
      geolocation_latitude: 40.7128,   // New York City
      geolocation_longitude: -74.0060,
      geolocation_accuracy: 10
    }
  })
});

geolocation_accuracy

Set the accuracy radius in meters. Lower values indicate more precise location data.

Type:number

Unit:meters

Recommended: Use 10-100 meters for realistic accuracy.

Common Locations

Quick reference for testing popular cities:

🗽 New York City, USA

bash

latitude: 40.7128
longitude: -74.0060

🇬🇧 London, UK

bash

latitude: 51.5074
longitude: -0.1278

🗼 Paris, France

bash

latitude: 48.8566
longitude: 2.3522

🗾 Tokyo, Japan

bash

latitude: 35.6762
longitude: 139.6503

Use Cases

🗺️ Test Maps Applications

python

import requests

response = requests.post(
    'https://www.snapshotai.dev/api/v1/screenshots',
    headers={'Authorization': 'Bearer sk_live_YOUR_API_KEY'},
    json={
        'url': 'https://your-map-app.com',
        'options': {
            'geolocation_latitude': 37.7749,  # San Francisco
            'geolocation_longitude': -122.4194,
            'geolocation_accuracy': 50,
            'wait_for_selector': '#map-loaded'
        }
    }
)

🏪 Store Locator Testing

javascript

// Test store locator from different cities
const cities = [
  { name: 'NYC', lat: 40.7128, lng: -74.0060 },
  { name: 'LA', lat: 34.0522, lng: -118.2437 },
  { name: 'Chicago', lat: 41.8781, lng: -87.6298 }
];

for (const city of cities) {
  await fetch('https://www.snapshotai.dev/api/v1/screenshots', {
    method: 'POST',
    body: JSON.stringify({
      url: 'https://store-locator.com',
      options: {
        geolocation_latitude: city.lat,
        geolocation_longitude: city.lng,
        geolocation_accuracy: 100
      }
    })
  });
}

Best Practices

Use Realistic Accuracy Values

GPS typically provides 10-100m accuracy. Use values in this range for realistic testing.

Wait for Map Load

Use wait_for_selector or delay to ensure maps fully load before capturing.

Test Multiple Locations

Verify your app works correctly across different cities and countries.

Related Resources

API Reference →

Complete geolocation parameter documentation

Wait & Timing →

Wait for maps and location content to load

Need help with geolocation testing?

Our team can help you test location-based features across different regions.

Contact Support

Overview

When to use geolocation?

• Test location-based features from different cities/countries
• Verify map applications show correct data
• Test geo-restricted content or services
• Capture screenshots of store locator results

Geolocation Parameters

geolocation_latitude & geolocation_longitude

Set the GPS coordinates (latitude and longitude) for the browser geolocation. Must provide both values together to override location.

Latitude Range:-90 to 90

Longitude Range:-180 to 180

Set Custom Location•javascript

const response = await fetch('https://www.snapshotai.dev/api/v1/screenshots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://maps-app.com',
    options: {
      geolocation_latitude: 40.7128,   // New York City
      geolocation_longitude: -74.0060,
      geolocation_accuracy: 10
    }
  })
});

geolocation_accuracy

Set the accuracy radius in meters. Lower values indicate more precise location data.

Type:number

Unit:meters

Recommended: Use 10-100 meters for realistic accuracy.

Use Cases

🗺️ Test Maps Applications

python

import requests

response = requests.post(
    'https://www.snapshotai.dev/api/v1/screenshots',
    headers={'Authorization': 'Bearer sk_live_YOUR_API_KEY'},
    json={
        'url': 'https://your-map-app.com',
        'options': {
            'geolocation_latitude': 37.7749,  # San Francisco
            'geolocation_longitude': -122.4194,
            'geolocation_accuracy': 50,
            'wait_for_selector': '#map-loaded'
        }
    }
)

🏪 Store Locator Testing

javascript

// Test store locator from different cities
const cities = [
  { name: 'NYC', lat: 40.7128, lng: -74.0060 },
  { name: 'LA', lat: 34.0522, lng: -118.2437 },
  { name: 'Chicago', lat: 41.8781, lng: -87.6298 }
];

for (const city of cities) {
  await fetch('https://www.snapshotai.dev/api/v1/screenshots', {
    method: 'POST',
    body: JSON.stringify({
      url: 'https://store-locator.com',
      options: {
        geolocation_latitude: city.lat,
        geolocation_longitude: city.lng,
        geolocation_accuracy: 100
      }
    })
  });
}

Best Practices

Use Realistic Accuracy Values

GPS typically provides 10-100m accuracy. Use values in this range for realistic testing.

Wait for Map Load

Use wait_for_selector or delay to ensure maps fully load before capturing.

Test Multiple Locations

Verify your app works correctly across different cities and countries.