# Geolocation options

> Reference for the geolocation options of the shotkit screenshot API, with an example request for each.

Grant the page the geolocation permission and report these coordinates. Latitude and longitude must be set together. Pages served over plain `http://` can't read the location (browser rule).

### `geolocation_latitude`

Latitude.

Type: `number` · Range: `-90`–`90`

```bash
curl -X POST "https://shotkit.net/api/take" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.openstreetmap.org","geolocation_latitude":48.8566,"geolocation_longitude":2.3522}' \
  --fail-with-body -o shot.jpg
```

### `geolocation_longitude`

Longitude.

Type: `number` · Range: `-180`–`180`

```bash
curl -X POST "https://shotkit.net/api/take" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.openstreetmap.org","geolocation_latitude":48.8566,"geolocation_longitude":2.3522}' \
  --fail-with-body -o shot.jpg
```

### `geolocation_accuracy`

Accuracy in meters.

Type: `number` · Min: `0`

```bash
curl -X POST "https://shotkit.net/api/take" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.openstreetmap.org","geolocation_latitude":48.8566,"geolocation_longitude":2.3522,"geolocation_accuracy":50}' \
  --fail-with-body -o shot.jpg
```
