Chi tiết địa điểm (Mới)

Chọn nền tảng: Android iOS JavaScript Dịch vụ web

Bạn có thể yêu cầu thêm thông tin chi tiết về một cơ sở hoặc địa điểm cụ thể sở thích bằng cách sử dụng vị trí của nó và tạo một Yêu cầu Chi tiết địa điểm (Mới). Trả về thông tin chi tiết về địa điểm (Mới) đầy đủ hơn thông tin về địa điểm được chỉ định, chẳng hạn như địa chỉ đầy đủ, số điện thoại số lượng, xếp hạng của người dùng và bài đánh giá.

Có nhiều cách để lấy mã địa điểm. Bạn có thể sử dụng:

Yêu cầu Chi tiết địa điểm (Mới)

Bạn có thể yêu cầu chi tiết địa điểm bằng cách gọi PlacesClient.fetchPlace() và chuyển một FetchPlaceRequest đối tượng chứa mã địa điểm và danh sách trường, cũng như dưới dạng thông số không bắt buộc:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

Câu trả lời cho Thông tin chi tiết về địa điểm (Mới)

Chi tiết địa điểm (Mới) trả về dữ liệu dưới dạng Place , chỉ bao gồm các trường mà bạn đã yêu cầu bằng cách sử dụng trường danh sách. Không được để trống kết quả dữ liệu địa điểm, vì vậy, chỉ kết quả về địa điểm có dữ liệu sẽ được trả về (ví dụ: nếu một địa điểm được yêu cầu không có ảnh, trường ảnh sẽ không xuất hiện trong kết quả).

Để truy cập các trường dữ liệu, hãy gọi hàm phương thức. Ví dụ: để truy cập tên địa điểm, hãy gọi getName().

Thông số bắt buộc

Các tham số bắt buộc cho FetchPlaceRequest là:

Thông số tùy chọn

Các tham số không bắt buộc cho FetchPlaceRequest là:

  • Mã vùng

    Mã vùng dùng để định dạng phản hồi, được chỉ định làm mã CLDR gồm hai ký tự. Không có giá trị mặc định.

    Nếu tên quốc gia của trường Place.Field.ADDRESS trong câu trả lời khớp với regionCode, mã quốc gia bị bỏ khỏi Place.Field.ADDRESS.

    Hầu hết mã CLDR đều giống với mã ISO 3166-1, với một số ngoại lệ đáng chú ý. Ví dụ: ccTLD (miền cấp cao nhất theo mã quốc gia) của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 của trang web là "gb" (về mặt kỹ thuật cho pháp nhân "Vương quốc Anh và Bắc Ireland"). Tuỳ theo luật hiện hành, thông số này có thể ảnh hưởng đến kết quả.

    Để đặt tham số mã khu vực, hãy gọi phương thức setRegionCode() khi tạo đối tượng FetchPlaceRequest.

  • Mã thông báo phiên

    Mã thông báo phiên là các chuỗi do người dùng tạo để theo dõi Lệnh gọi Tự động hoàn thành (Mới) dưới dạng "phiên". Tính năng Tự động hoàn thành (Mới) sử dụng mã thông báo phiên để nhóm các giai đoạn truy vấn và chọn địa điểm trong tính năng tự động hoàn thành tìm kiếm của người dùng thành một phiên riêng biệt cho mục đích thanh toán. Mã thông báo phiên được chuyển vào Chi tiết địa điểm (Mới) những lệnh gọi theo sau lệnh gọi Tự động hoàn thành (Mới). Để biết thêm thông tin, hãy xem Mã thông báo phiên.

    Để đặt tham số mã thông báo phiên, hãy gọi phương thức setSessionToken() khi tạo đối tượng FetchPlaceRequest.

Ví dụ về Thông tin chi tiết về địa điểm

Ví dụ sau đây yêu cầu các trường ID, NAME và ADDRESS cho thuộc tính Toà nhà Empire State ở Thành phố New York.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);