V2

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

Endpoint

https://sg-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.	1.501998,103.81143
`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.

Mã ví dụ

https://sg-maps.track-asia.com/api/v2/geocode/json?latlng=1.301998,103.81143&radius=100&key=public_key

https://sg-maps.track-asia.com/api/v2/geocode/xml?latlng=1.301998,103.81143&radius=100&key=public_key

CurlJavascript

curl -G "https://sg-maps.track-asia.com/api/v2/geocode/xml?latlng=1.301998,103.81143&radius=100&key=public_key"

const response = await fetch("https://sg-maps.track-asia.com/api/v2/geocode/json?latlng=1.301998,103.81143&radius=100&key=public_key")
const data = await response.json()
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.
- sublabel: Địa chỉ hoặc thông tin bổ sung.
- 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, class, subclass: Thông tin phân loại và hiển thị.
- 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.

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

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

Thử API playground