Bỏ qua

Tìm địa điểm hoặc địa chỉ gần cặp kinh độ/vĩ độ

Endpoint

https://maps.track-asia.com/api/v2/geocode/{outputFormat}

outputFormat

outputFormat Mô tả
json (khuyến nghị) định dạng JSON
xml định dạng XML

Tham số

Tham số Giá trị Mô tả Ví dụ
latlng {vĩ độ},{kinh độ}
(bắt buộc)		 Tọa độ địa điểm để tìm địa chỉ gần nhất có thể đọc được bằng tiếng người dùng. 10.7952219,106.7217912
key Chuỗi (bắt buộc) Khóa API public_key
radius Số nguyên Bán kính tìm kiếm tính bằng mét (m) 500, 100, 50, etc.
new_admin Boolean Return address according to new administrative boundaries true
include_old_admin Boolean (Use with new_admin) Return both new and old addresses true

Mã ví dụ

Ví dụ này minh họa cách sử dụng định dạng JSON trong phản hồi.

https://maps.track-asia.com/api/v2/geocode/json?latlng=10.7952219,106.7217912&key=public_key

Ví dụ này minh họa cách sử dụng định dạng XML trong phản hồi

https://maps.track-asia.com/api/v2/geocode/xml?latlng=10.7952219,106.7217912&key=public_key

# JSON
curl -G "https://maps.track-asia.com/api/v2/geocode/json?latlng=10.7952219,106.7217912&key=public_key"

 # XML
curl -G "https://maps.track-asia.com/api/v2/geocode/xml?latlng=10.7952219,106.7217912&key=public_key"

// JSON
const response = await fetch("https://maps.track-asia.com/api/v2/geocode/json?latlng=10.7952219,106.7217912&key=public_key")
const data = await response.json()
console.log(data)

 // XML
const response = await fetch("https://maps.track-asia.com/api/v2/geocode/xml?latlng=10.7952219,106.7217912&key=public_key")
const data = await response.text()
console.log(data)

Phản hồi

JSON Phản hồi

Phản hồi là một đối tượng JSON với cấu trúc như sau:

  • plus_code: Đối tượng với global_code (và có thể có compound_code).
  • status: Chuỗi trạng thái (ví dụ: "OK").
  • results: Mảng các đối tượng kết quả. Mỗi đối tượng gồm:
    • place_id: Định danh duy nhất cho địa điểm.
    • name: Tên địa điểm.
    • formatted_address: Địa chỉ đầy đủ đã được chuẩn hóa.
    • address_components: Mảng các đối tượng với long_name, short_name, và types cho từng thành phần địa chỉ.
    • geometry: Đối tượng với location (lat/lng), location_type, và viewport (northeast/southwest).
    • plus_code: Đối tượng với compound_code và global_code (có thể lặp lại trong từng kết quả).
    • partial_match: Boolean cho biết kết quả có phải là khớp một phần không.
    • icon, icon_background_color: Thông tin hiển thị biểu tượng (nếu có).
    • types: Mảng các loại địa điểm.
XML Phản hồi

Phản hồi XML có cấu trúc tương tự, các trường sẽ là các thẻ XML tương ứng với các trường JSON ở trên. Một số khác biệt:

  • Kết quả XML được bọc trong phần tử gốc <GeocodeResponse>.
  • Các mảng trong JSON (như results, address_components, types) sẽ là các phần tử lặp lại trong XML (như <result>, <address_component>, <type>).
  • Các trường rỗng được thể hiện bằng mảng rỗng trong JSON, nhưng sẽ không có phần tử nào trong XML.

Lưu ý quan trọng

  • Các trường trong phản hồi tuân theo chuẩn Google Maps Places API.
  • Phản hồi không bao gồm toàn bộ thông tin chi tiết của địa điểm. Để lấy thông tin đầy đủ nhất, hãy sử dụng API Place Detail.

Status

Status Mô tả
OK cho biết không có lỗi xảy ra; địa chỉ đã được phân tích cú pháp thành công và ít nhất một geocode đã được trả về.
ZERO_RESULTS cho biết geocode thành công nhưng không trả về kết quả nào. Điều này có thể xảy ra nếu geocoder được truyền một địa chỉ không tồn tại.

Error messages

Khi geocoder trả về mã trạng thái khác OK, có thể có trường error_message bổ sung trong đối tượng phản hồi Geocoding. Trường này chứa thông tin chi tiết hơn về lý do đằng sau mã trạng thái đã cho.

Các bước tiếp theo