Places API hỗ trợ API địa điểm Chi tiết địa điểm. Nếu bạn đã quen thuộc với Places API hiện có, phiên bản Chi tiết địa điểm mới thực hiện các thay đổi sau:
- Bắt buộc phải che trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong câu trả lời. Không có danh sách mặc định các trường được trả về. Nếu bạn bỏ qua danh sách này, phương thức sẽ trả về một lỗi. Để biết thêm thông tin, hãy xem FieldMask (Mặt nạ trường).
- Thông tin chi tiết về địa điểm mới hỗ trợ cả Khoá API và OAuth làm cơ chế xác thực.
- Chỉ JSON được hỗ trợ làm định dạng phản hồi trong Thông tin chi tiết về địa điểm.
- Định dạng phản hồi JSON cho Thông tin chi tiết về địa điểm (Mới) API đã thay đổi so với định dạng của các API hiện có. Để biết thêm thông tin, hãy xem Di chuyển phản hồi của API Địa điểm.
Bảng sau đây liệt kê các tham số trong thành phần Chi tiết địa điểm đã được đổi tên hoặc sửa đổi Chi tiết địa điểm mới hoặc các thông số không còn được hỗ trợ.
| Thông số hiện tại | Thông số mới | Ghi chú |
|---|---|---|
place_id |
places/PLACE_ID |
Chuỗi places/PLACE_ID còn được gọi là
tên tài nguyên địa điểm. Trong câu trả lời của một Địa điểm chi tiết (Mới),
Tìm kiếm lân cận (Mới) và Tìm kiếm văn bản (Mới)
yêu cầu, chuỗi này có trong trường name của phản hồi.
Mã địa điểm độc lập có trong trường id của phản hồi. |
language |
languageCode |
|
region |
regionCode |
Yêu cầu mẫu
Yêu cầu GET trong ví dụ sau đây sử dụng phương thức
Thông tin chi tiết về địa điểm. Trong ví dụ này, bạn yêu cầu một tệp JSON
nội dung phản hồi chứa thông tin về mã địa điểm và chuyển tất cả các thông số dưới dạng URL
tham số. Ví dụ này cũng sử dụng fields để phản hồi chỉ bao gồm
tên hiển thị và địa chỉ được định dạng của địa điểm:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Với Chi tiết địa điểm (Mới), bạn đưa ra yêu cầu GET và chuyển tất cả các tham số trong tiêu đề và tham số URL dưới dạng một phần của yêu cầu. Chiến dịch này Ví dụ này cũng sử dụng một mặt nạ trường để phản hồi chỉ chứa tên hiển thị và định dạng địa chỉ của địa điểm đó:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Chuỗi places/PLACE_ID còn được gọi là địa điểm
tên tài nguyên. Trong câu trả lời của một Địa điểm
(Mới), Tìm kiếm lân cận (Mới) và
Yêu cầu Tìm kiếm văn bản (Mới), chuỗi này có trong
trường name của phản hồi. Mã địa điểm độc lập có trong
Trường id của phản hồi.