GET /v1/reverse

Returns the places nearest to a coordinate.

Required scope: geocoding:read

Request

GET /v1/reverse?point.lat=10.7769&point.lon=106.7009
X-API-Key: gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Query parameters

Name	Required	Description
`point.lat`	yes	Latitude in decimal degrees.
`point.lon`	yes	Longitude in decimal degrees.
`size`	no	Max results, 1–5. Default 1.
`boundary.circle.radius`	no	Search radius in km. Default 0.05, capped at 0.1.
`lang`	no	Language code, default `vi`.
`boundary.country`	no	Comma-separated ISO codes (`VN,TH`).

Response

{
  "results": [
    {
      "place_id": "ChIJO3p-WAAvdTER8L3Uli6PgXM",
      "address": "114 Nguyễn Huệ, Bến Nghé, Quận 1, Thành phố Hồ Chí Minh, Vietnam",
      "lat": 10.7768196,
      "lon": 106.7009035,
      "district": "Phường Sài Gòn",
      "city": "Thành phố Hồ Chí Minh",
      "country": "VN",
      "confidence": 1,
      "distance_km": 0.0089
    }
  ],
  "source": "postgres_cache"
}

Response fields

Field	Type	Description
`results[].place_id`	string	Place identifier. Note: snake_case here for historical reasons.
`results[].address`	string	Full formatted address.
`results[].lat`	number	Latitude.
`results[].lon`	number	Longitude.
`results[].district`	string	Ward / district. May be null.
`results[].city`	string	City / province. May be null.
`results[].country`	string	ISO alpha-2 country code.
`results[].confidence`	number	0..1 match confidence.
`results[].distance_km`	number	Distance from the query point.
`source`	string	Layer that served the response (`postgres_cache`, `elastic`, `google`, …).

Common errors

400 BAD_REQUEST — missing point.lat / point.lon.
401 INVALID_API_KEY / 403 INSUFFICIENT_SCOPE — auth/scope failure.
503 — service unavailable.

GET /v1/reverse

Request

Query parameters

Response

Response fields

Common errors

On this page