V2

Tìm kiếm các từ khóa và trả về danh sách các địa điểm liên quan.

Endpoint

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

outputFormat

outputFormat	Mô tả
`json` (khuyến nghị)	cho biết đầu ra ở định dạng JavaScript Object Notation (JSON)
`xml`	cho biết đầu ra ở định dạng XML

Parameters

Parameter	Values	Mô tả	Ví dụ
address	String (required)	Địa chỉ đường phố mà bạn muốn geocode. Chỉ định địa chỉ theo định dạng được sử dụng bởi dịch vụ bưu chính quốc gia của quốc gia liên quan. Nên tránh các yếu tố địa chỉ bổ sung như tên doanh nghiệp và số đơn vị, dãy phòng hoặc tầng. Các yếu tố địa chỉ đường phố nên được phân tách bằng dấu cách (hiển thị ở đây dưới dạng url-escaped thành %20)	Landmark 81
`key`	String (required)	API key	public_key
`size`	Number	Số lượng kết quả tối đa trả về từ tìm kiếm.	5

Example Code

Yêu cầu này minh họa việc sử dụng cờ đầu ra JSON:

https://maps.track-asia.com/api/v2/geocode/json?address=Landmark 81&key=public_key

Yêu cầu này minh họa việc sử dụng cờ đầu ra XML:

https://maps.track-asia.com/api/v2/geocode/xml?address=Landmark 81&size=1&key=public_key

CurlJavascript

curl -G "https://maps.track-asia.com/api/v2/geocode/json" \
--data-urlencode "address=Landmark 81" \
--data-urlencode "size=2" \
--data-urlencode "key=public_key"

const response = await fetch("https://maps.track-asia.com/api/v2/geocode/xml?address=Landmark 81&size=1&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 phân loại của đị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