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

Định dạng phản hồi cho các API Chi tiết địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm bằng văn bản (Mới) đã thay đổi so với định dạng của các API cũ. Điểm khác biệt chính là ở định dạng của đối tượng Place do mỗi phương thức trả về, như mô tả trong phần Thay đổi đối với đối tượng Đị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 đã thay đổi cho từng API. Hãy xem:

Thay đổ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 Chi tiết địa điểm (Mới), Tìm kiế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 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 cũ.

Trường Đối tượng Places API (Cũ) Đối tượng Places API (Mới) Ghi chú
Thành phần địa chỉ address_components addressComponents
Địa chỉ theo định dạng vi mô của địa điểm adr_address adrFormatAddress
Trạng thái kinh doanh business_status businessStatus
Giờ mở cửa trong 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
Ghi công địa điểm html_attributions attributions Trường cấp cao nhất của phản hồi trong các API cũ
URL biểu tượng icon Đã xoá. Sử dụng iconMaskBaseUri và iconBackgroundColor. 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 Giờ đây, bạn có thể truy cập tên địa điểm dạng văn bản dưới dạng displayName.text và language dưới dạng displayName.languageCode
Giờ mở cửa opening_hours regularOpeningHours
Ảnh photos photos Định dạng của photos đã thay đổi trong đối tượng Place mới. Để biết thêm thông tin, hãy xem phần Thay đổi thành tệp tham chiếu ả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 kể từ hôm nay, cùng với các trường hợp ngoại lệ và 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
Độ lệch UTC utc_offset utcOffsetMinutes
Biểu mẫu ngắn của địa chỉ, bao gồm tên đường và thị trấn vicinity shortFormattedAddress
Trang web về địa điểm website websiteUri
Thông tin về sự phù hợp cho xe lăn wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance hiện ở 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 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 theo lịch, cùng với các trường hợp ngoại lệ và tất cả dữ liệu khác regularSecondaryOpeningHours Mới
Các phương thức thanh toán mà địa điểm chấp nhận paymentOptions Mới
Lựa chọn đỗ xe tại địa điểm parkingOptions Mới
Danh sách các đích đến phụ liên quan đến địa điểm subDestinations Mới
Thông tin mới nhất về các loại nhiên liệu tại một trạm xăng fuelOptions Mới
Thông tin về trạm sạc xe điện tại 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ề câu trả lờ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ính năng Tìm kiếm bằng văn bản (Cũ) và đối tượng phản hồi cho tính năng 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 (Địa điểm) mới 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 cũ Mảng places của đố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 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 Đã xoá
Mã thông báo trang next_page_token Đã xoá

Thay đổi về nội dung phản hồi của Nearby Search

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 lân cận (Cũ) và đối tượng phản hồi 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 (Cũ) Tìm kiếm lân cậ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 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 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 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 Đã xoá
Mã thông báo trang next_page_token Đã xoá

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

Bảng sau đây cho thấy các thay đổi đối với các trường cấp cao nhất của đối tượng phản hồi cho Thông tin chi tiết về địa điểm (Cũ) và đối tượng phản hồi cho Thông tin chi tiết về đị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 (Cũ) Thông tin chi tiết về địa điểm (Mới) Ghi chú
Ghi công địa điểm html_attributions Di chuyển vào đối tượng Place mới dưới dạng attributions
Thông tin chi tiết về địa điểm (Mới) result chứa đối tượng Place cũ Đối tượng Place (Đặt) 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)