Imagery API

Search, download, and order aerial imagery.

Search Imagery

GET /v1/imagery

Parameters

Parameter	Type	Required	Description
lat	float	Yes*	Latitude (WGS 84)
lng	float	Yes*	Longitude (WGS 84)
bounds	string	Yes*	Bounding box: south,west,north,east
radius	integer	No	Search radius in metres (default: 1000)
resolution	string	No	Filter by resolution: 2cm, 5cm, 10cm, 25cm
from	string	No	Captured after date (ISO 8601)
to	string	No	Captured before date (ISO 8601)
limit	integer	No	Results per page (default: 20, max: 100)
cursor	string	No	Pagination cursor

*Provide either lat/lng or bounds.

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.geolocarta.com/v1/imagery?lat=-27.4698&lng=153.0251&resolution=5cm&from=2026-01-01"

Response

{
  "data": [
    {
      "id": "img_abc123",
      "captured_at": "2026-02-10T08:30:00Z",
      "resolution_cm": 5,
      "format": "geotiff",
      "file_size_mb": 245.8,
      "bounds": {
        "north": -27.4650,
        "south": -27.4750,
        "east": 153.0300,
        "west": 153.0200
      },
      "download_url": "https://api.geolocarta.com/v1/imagery/img_abc123/download"
    }
  ],
  "meta": {
    "total": 1,
    "cursor": null
  }
}

Download Imagery

GET /v1/imagery/{id}/download

Parameter	Type	Description
format	string	geotiff (default), jpeg, jp2, png
crs	string	Output CRS (default: EPSG:4326)

Create Order

POST /v1/imagery/orders

See Ordering Imagery for full details.