v2

Truy xuất thông tin chi tiết về một địa điểm cụ thể bằng place_id duy nhất.

Điểm cuối (Endpoint)

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

Định dạng đầu ra (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

Tham số (Parameters)

Tham số	Giá trị	Mô tả	Ví dụ
`key`	Chuỗi (bắt buộc)	Khóa API	public_key
`place_id`	Chuỗi (bắt buộc)	Định danh duy nhất cho địa điểm. Dùng để truy xuất thông tin chi tiết về địa điểm cụ thể.	17:venue:67addea7-6e98-5a17-8769-8399bbcea42f
new_admin	Boolean	Trả về địa chỉ theo địa giới hành chính mới	`true`
include_old_admin	Boolean	(Dùng kèm new_admin) Trả song song cả địa chỉ cũ và mới	`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/place/details/json?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&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/place/details/xml?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&key=public_key

CurlJavascript

# JSON
curl -G "https://maps.track-asia.com/api/v2/place/details//json" \
--data-urlencode "place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f" \
--data-urlencode "key=public_key"


# XML
 curl -G "https://maps.track-asia.com/api/v2/place/details//xml" \
--data-urlencode "place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f" \
--data-urlencode "key=public_key"

// JSON
const response = await fetch("https://maps.track-asia.com/api/v2/place/details/json?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&key=public_key")
const data = await response.json()
console.log(data)

// XML
const response = await fetch("https://maps.track-asia.com/api/v2/place/details/xml?place_id=17:venue:67addea7-6e98-5a17-8769-8399bbcea42f&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:

status: Chuỗi trạng thái (ví dụ: "OK")
html_attributions: Mảng các chuỗi attribution HTML
result: Đối tượng chứa thông tin chi tiết về địa điểm, bao 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
- vicinity: Địa chỉ/vùng lân cận (nếu có)
- adr_address: Chuỗi địa chỉ có gắn thẻ HTML để hiển thị trên giao diện (nếu có)
- editorial_summary: Đối tượng với trường overview (nếu có)
- address_components: Mảng các đối tượng với:
  - long_name: Tên đầy đủ
  - short_name: Tên viết tắt
  - types: Mảng các loại địa chỉ
- geometry: Đối tượng với:
  - location: Tọa độ (lat/lng)
  - location_type: Loại vị trí
  - viewport: Khu vực hiển thị (northeast/southwest)
- plus_code: Đối tượng với:
  - compound_code: Mã khu vực
  - global_code: Mã toàn cầu
- types: Mảng các loại địa điểm
- icon: Tên biểu tượng
- icon_background_color: Màu nền biểu tượng
- photos: Mảng các đối tượng ảnh (nếu có)
  - url: Đường dẫn ảnh
- opening_hours: Đối tượng giờ mở cửa (nếu có)
- rating: Đánh giá (nếu có)
- user_ratings_total: Tổng số lượt đánh giá (nếu có)
- website: Website của địa điểm (nếu có)
- phone_number: Số điện thoại (nếu có)
- socials: Mảng các đường dẫn mạng xã hội (nếu có)
- url: Link đến địa điểm trên TrackAsia Maps (nếu có)
- utc_offset: Độ lệch UTC tính bằng phút (nếu có)
- old_address_components: (Chỉ có khi include_old_admin=true) Mảng các thành phần địa chỉ theo địa giới cũ, cùng cấu trúc với address_components
- old_formatted_address: (Chỉ có khi include_old_admin=true) Địa chỉ đầy đủ theo địa giới cũ

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 <PlaceDetailResponse>
Các mảng trong JSON sẽ là các phần tử lặp lại trong XML
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; truy vấn thành công và đã trả về thông tin chi tiết.
`ZERO_RESULTS`	cho biết truy vấn thành công nhưng không trả về kết quả nào.
`INVALID_REQUEST`	cho biết yêu cầu không hợp lệ (ví dụ: thiếu tham số bắt buộc, giá trị tham số không hợp lệ).

Error

Khi API 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. 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