GoGoDuk

GET /v1/place/resolve

Tra cứu bản ghi đầy đủ cho một place ID.

Trả về bản ghi địa chỉ đầy đủ cho một placeId được trả về từ /v1/suggest.

Scope yêu cầu: geocoding:read

Request

GET /v1/place/resolve?id=ChIJi85p5P0ldTERfqSM08G0C1Q
X-API-Key: gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx
curl -G "https://api.gogoduk.com/v1/place/resolve" \
-H "X-API-Key: $GOGODUK_API_KEY" \
--data-urlencode "id=ChIJi85p5P0ldTERfqSM08G0C1Q"

Query parameters

NameBắt buộcMô tả
idcóplaceId từ một lần gọi /v1/suggest trước đó.
langkhôngMã ngôn ngữ, mặc định là vi.
sessionTokenkhôngCùng sessionToken đã dùng trong lần gọi suggest khởi tạo.

Response

{
  "result": {
    "placeId": "ChIJi85p5P0ldTERfqSM08G0C1Q",
    "name": "201 Trần Não",
    "address": "201 Trần Não, Thành phố, An Khánh, Hồ Chí Minh 700000, Việt Nam",
    "lat": 10.7866056,
    "lon": 106.7298182,
    "district": "Phường An Khánh",
    "city": "Thành phố Hồ Chí Minh",
    "country": "VN"
  }
}

Response fields

FieldTypeMô tả
result.placeIdstringCùng định danh đã truyền vào.
result.namestringTên hiển thị ngắn gọn (tên POI hoặc số nhà + tên đường).
result.addressstringĐịa chỉ đầy đủ đã được định dạng.
result.latnumberLatitude theo độ thập phân.
result.lonnumberLongitude theo độ thập phân. (Lưu ý: là lon, không phải lng.)
result.districtstringTên phường / quận hành chính. Có thể là null.
result.citystringTên thành phố / tỉnh. Có thể là null.
result.countrystringMã quốc gia ISO 3166 alpha-2.

Common errors

  • 400 BAD_REQUEST — thiếu id.
  • 401 INVALID_API_KEY / 403 INSUFFICIENT_SCOPE — lỗi xác thực/scope.
  • 503 — không thể resolve được địa điểm (không có provider upstream khả dụng).

Previous

GET /v1/suggest

Next

GET /v1/reverse

On this page