Di chuyển phản hồi của API Địa điểm

Định dạng phản hồi cho các API mới Thông tin chi tiết về địa điểm, Tìm kiếm lân cận và Tìm kiếm bằng văn bản đã thay đổi so với định dạng của các API hiện có. Điểm khác biệt chính là ở định dạng của đối tượng Place mà mỗi phương thức trả về, như mô tả trong Các thay đổi đối với đối tượng Place (Địa điểm) phản hồi.

Ngoài ra, các trường cấp cao nhất của đối tượng phản hồi cũng có thay đổi cho từng API. Hãy xem:

Thay đổi đối với đối tượng Địa điểm trong phản hồi

Bảng này cho thấy những thay đổi đối với đối tượng Place mới trong phản hồi cho Thông tin chi tiết về địa điểm (Mới), Tìm kiếm địa điểm lân cận (Mới) và Tìm kiếm bằng văn bản (Mới) so với đối tượng Place hiện có.

Đối tượng phản hồi mới sử dụng cách viết hoa camel-casing cho tên trường, chứa các trường mới và đổi tên một số trường hiện có.

Trường Đối tượng Địa điểm hiện có Đối tượng Địa điểm mới Ghi chú
Thành phần địa chỉ address_components addressComponents
Địa chỉ ở định dạng vi mô adr_address adrFormatAddress
Trạng thái doanh nghiệp business_status businessStatus
Giờ mở cửa tuần tới current_opening_hours currentOpeningHours
Tóm tắt nội dung biên tập editorial_summary editorialSummary
Địa chỉ được định dạng formatted_address formattedAddress
Số điện thoại quốc gia formatted_phone_number nationalPhoneNumber
Vị trí geometry.location location
Khung nhìn geometry.viewport viewport
Thông tin ghi nhận sự đóng góp cho địa điểm html_attributions attributions Trường cấp cao nhất của phản hồi trong các API hiện có
URL biểu tượng icon Đã xoá. Sử dụng iconMaskBaseUri và iconBackgroundColor. Hãy xem phần Biểu tượng địa điểm để biết thêm thông tin.
Màu nền biểu tượng icon_background_color iconBackgroundColor
URL mặt nạ biểu tượng icon_mask_base_uri iconMaskBaseUri
Số điện thoại quốc tế international_phone_number internationalPhoneNumber
Tên địa điểm dạng văn bản name displayName Tên địa điểm bằng văn bản hiện có thể truy cập được như displayName.text và language theo phong cách displayName.languageCode
Giờ mở cửa opening_hours regularOpeningHours
Ảnh photos photos Định dạng của photos đã thay đổi trong giao diện mới Đối tượng Place. Để biết thêm thông tin, hãy xem Chuyển sang tham chiếu hình ảnh.
Mã địa điểm place_id id
Plus code plus_code plusCode
Mức giá price_level priceLevel
Rating rating rating
Bài đánh giá reviews reviews
Giờ mở cửa phụ cho tuần tới từ hôm nay (trừ các trường hợp ngoại lệ) tất cả dữ liệu khác secondary_opening_hours currentSecondaryOpeningHours
Loại địa điểm types types
URL của địa điểm trên Google Maps url googleMapsUri
Số điểm xếp hạng của người dùng user_ratings_total userRatingCount
Chênh lệch UTC utc_offset utcOffsetMinutes
Dạng địa chỉ ngắn bao gồm tên đường phố và thị trấn vicinity shortFormattedAddress
Trang web về địa điểm website websiteUri
Thông tin về khả năng tiếp cận cho xe lăn wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance hiện đang ở accessibilityOptions.wheelchairAccessibleEntrance
Thuộc tính địa điểm takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
Tên tài nguyên Trường name ở dạng places/PLACE_ID Trong API hiện có, trường name chứa tên địa điểm dưới dạng chuỗi văn bản. Trong API mới, thông tin đó nằm trong displayName.
Loại địa điểm chính primaryTypeName Mới
Đặt loại chính dưới dạng chuỗi văn bản primaryTypeDisplayName Mới
Giờ mở cửa phụ hằng tuần, ngoại lệ và tất cả các hoạt động khác dữ liệu regularSecondaryOpeningHours Mới
Các lựa chọn thanh toán mà địa điểm này chấp nhận paymentOptions Mới
Lựa chọn đỗ xe parkingOptions Mới
Danh sách các điểm đến phụ liên quan đến địa điểm subDestinations Mới
Thông tin mới nhất về các lựa chọn nhiên liệu ở trạm xăng fuelOptions Mới
Thông tin về trạm sạc xe điện cho một địa điểm evChargeOptions Mới
Thuộc tính địa điểm outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports Mới

Thay đổi về nội dung phản hồi của tính năng Tìm kiếm bằng văn bản

Bảng sau đây cho thấy những thay đổi đối với các trường cấp cao nhất của đối tượng phản hồi cho Tìm kiếm bằng văn bản hiện tại và đối tượng phản hồi cho Tìm kiếm bằng văn bản (Mới). Đối với API mới, trường cấp cao nhất duy nhất trong phản hồi là mảng places.

Trường Tìm kiếm văn bản (Đã có) Tìm kiếm văn bản (Mới) Ghi chú
Ghi công địa điểm html_attributions Đã di chuyển vào đối tượng Place mới cho từng địa điểm dưới dạng place.attributions
Mảng địa điểm Mảng results của đối tượng Place hiện có Mảng places của đối tượng Place mới
Trạng thái của yêu cầu status Đã chuyển sang phản hồi HTTP tiêu chuẩn (mã và thông báo phản hồi HTTP)
Mọi thông báo lỗi error_message Chuyển sang phản hồi HTTP chuẩn (mã và thông báo phản hồi HTTP)
Mọi thông báo thông tin info_messages Đã xóa
Mã thông báo trang next_page_token Đã xóa

Các thay đổi đối với câu trả lời cho tính năng Tìm kiếm lân cận

Bảng sau đây cho thấy những thay đổi đối với các trường cấp cao nhất của phản hồi đối tượng cho tính năng Tìm kiếm lân cận hiện có và phản hồi đối tượng cho Tìm kiếm lân cận (Mới). Đối với API mới, trường cấp cao nhất duy nhất trong phản hồi là mảng places.

Trường Tìm kiếm lân cận (Hiện có) Tìm kiếm lân cận (Mới) Ghi chú
Thông tin ghi nhận sự đóng góp cho địa điểm html_attributions Đã di chuyển đến Địa điểm mới đối tượng cho mỗi địa điểm dưới dạng place.attributions
Mảng địa điểm Mảng results của đối tượng Place hiện có Mảng places của giá trị mới Đối tượng Place (Địa điểm)
Trạng thái của yêu cầu status Đã chuyển sang phản hồi HTTP tiêu chuẩn (mã và thông báo phản hồi HTTP)
Mọi thông báo lỗi error_message Chuyển sang phản hồi HTTP chuẩn (mã và thông báo phản hồi HTTP)
Mọi thông báo thông tin info_messages Đã xóa
Mã thông báo trang next_page_token Đã xóa

Thay đổi về nội dung phản hồi của tính năng Thông tin chi tiết về địa điểm

Bảng sau đây cho thấy những thay đổi đối với các trường cấp cao nhất của phản hồi đối tượng cho Chi tiết địa điểm hiện có và phản hồi đối tượng để biết Chi tiết địa điểm (Mới). Đối với API mới, trường cấp cao nhất duy nhất trong phản hồi là mảng places.

Trường Thông tin chi tiết về địa điểm (hiện có) Chi tiết địa điểm (Mới) Ghi chú
Thông tin ghi nhận sự đóng góp về địa điểm html_attributions Đã di chuyển đến Địa điểm mới đối tượng dưới dạng attributions
Thông tin chi tiết về địa điểm result chứa đối tượng Place hiện có Đối tượng Place (Địa điểm) mới
Trạng thái của yêu cầu status Chuyển sang phản hồi HTTP chuẩn (mã và thông báo phản hồi HTTP)
Mọi thông báo thông tin info_messages Chuyển sang phản hồi HTTP chuẩn (mã và thông báo phản hồi HTTP)