Di chuyển đến thông tin chi tiết về địa điểm (Mới)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Places API hỗ trợ Chi tiết địa điểm (Cũ). Nếu bạn đã quen thuộc với Places API (Cũ), thì Chi tiết địa điểm (Mới) sẽ có những thay đổi sau:

  • Bạn phải cung cấp mặt nạ 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 cho 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.
  • Place Details (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ợ dưới dạng định dạng phản hồi trong Place Details (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 của Places API.

Bảng sau đây liệt kê các tham số trong Place Details (Cũ) đã được đổi tên hoặc sửa đổi cho Place Details (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ũng đượ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 (Mới), Nearby Search (Mới) và Tìm kiếm văn bản (Mới), 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

Yêu cầu mẫu

Ví dụ sau đây về yêu cầu GET sử dụng Place Details (Cũ). 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ã địa điểm và truyền tất 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 (Mới), bạn tạo một yêu cầu GET và truyền tất cả tham số trong các tham số URL và tiêu đề dưới dạng một phần của yêu cầu. Ví dụ này cũng sử dụng 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ũng đượ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 (Mới), Nearby Search (Mới) và Tìm kiếm văn bản (Mới), 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.