Giới thiệu
Places API hỗ trợ Thông tin chi tiết về địa điểm (Cũ). Nếu bạn quen thuộc với Places API (Cũ), thì Chi tiết về địa điểm (Mới) sẽ thực hiện các thay đổi sau:
- Bạn phải che trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong phản hồi. Không có danh sách mặc định về các trường được trả về. Nếu bạn bỏ qua danh sách này, các phương thức sẽ trả về lỗi. Để biết thêm thông tin, hãy xem FieldMask.
- Chi tiết về địa điểm (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
- Chỉ JSON được hỗ trợ làm định dạng phản hồi trong Chi tiết về địa điểm (Mới).
- Định dạng phản hồi JSON cho Places API (Mới) đã thay đổi so với định dạng của các API cũ. Để biết thêm thông tin, hãy xem bài viết Di chuyển phản hồi Places API.
Bảng sau đây liệt kê các tham số trong Place Details (Legacy) (Chi tiết về địa điểm (Phiên bản cũ)) đã được đổi tên hoặc sửa đổi cho Place Details (New) (Chi tiết về địa điểm (Phiên bản mới)), hoặc các tham số không còn được hỗ trợ.
| Tham 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 của địa điểm. Trong phản hồi từ yêu cầu Place Details (New), Nearby Search (New) và Text Search (New), chuỗi này nằm trong trường name của phản hồi.
Mã địa điểm độc lập nằm trong trường id của phản hồi. |
language |
languageCode |
|
region |
regionCode |
Ví dụ về yêu cầu
Yêu cầu GET mẫu sau đây sử dụng Place Details (Legacy). Trong ví dụ này, bạn yêu cầu một phản hồi JSON chứa thông tin về một mã địa điểm và truyền tất cả các tham số dưới dạng tham số URL. 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 Place Details (New), bạn thực hiện một yêu cầu GET và truyền tất cả các tham số trong tham số URL và tiêu đề trong yêu cầu. Ví dụ này cũng sử dụng một mặt nạ trường để 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 -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à tên tài nguyên của địa điểm. Trong phản hồi từ yêu cầu Place Details (New), Nearby Search (New) và Text Search (New), chuỗi này nằm trong trường name của phản hồi. Mã địa điểm độc lập nằm trong trường id của phản hồi.