GET /v1/reverse-geocode

Phân giải tọa độ thành tỉnh / quận thông qua ranh giới hành chính PostGIS.

Tra cứu ranh giới hành chính chứa một tọa độ. Đây là cách tra cứu dựa trên ranh giới, không phải khớp theo độ gần.

Scope yêu cầu: geocoding:read

Request

GET /v1/reverse-geocode?lat=10.7769&lng=106.7009
X-API-Key: gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx

curl -G "https://api.gogoduk.com/v1/reverse-geocode" \
-H "X-API-Key: $GOGODUK_API_KEY" \
--data-urlencode "lat=10.7769" \
--data-urlencode "lng=106.7009"

Query parameters

Name	Bắt buộc	Mô tả
`lat`	có	Latitude (-90..90).
`lng`	có	Longitude (-180..180).
`levels`	không	Các cấp hành chính ngăn cách bằng dấu phẩy (mặc định `4,8`). Cấp 4 ≈ tỉnh, cấp 8 ≈ quận.

Response

{
  "lat": 10.7769,
  "lng": 106.7009,
  "city": "Thành phố Hồ Chí Minh",
  "district": "Phường Sài Gòn"
}

Response fields

Field	Type	Mô tả
`lat`	number	Phản hồi lại latitude đầu vào.
`lng`	number	Phản hồi lại longitude đầu vào.
`city`	string \| null	Tỉnh ở cấp 4. Có thể là `null` nếu không có ranh giới nào chứa điểm này.
`district`	string \| null	Quận / phường ở cấp 8. Có thể là `null`.

Common errors

400 BAD_REQUEST — tọa độ ngoài khoảng cho phép hoặc không phải số.
401 INVALID_API_KEY / 403 INSUFFICIENT_SCOPE — lỗi xác thực/scope.
500 INTERNAL_ERROR — PostGIS không khả dụng.