Định dạng phản hồi cho các API mới Chi tiết địa điểm, Tìm kiếm lân cận và Tìm kiếm văn bản đã thay đổi từ định dạng của các API hiện có. Điểm khác biệt chính nằm ở định dạng của đối tượng Place mà 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 đối với từng API. Hãy xem:
- Thay đổi về câu trả lời của tính năng Tìm kiếm văn bản
- Thay đổi về phản hồi của tính năng Tìm kiếm lân cận
- Các thay đổi đối với câu trả lời cho Thông tin chi tiết về địa điểm
Các thay đổi đối với đối tượng Địa điểm của 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 lân cận (Mới) và Tìm kiếm 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 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ó.
| Kỹ thuật | Đố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ỉ đặt vi định dạng | 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 về đị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á. Hãy 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 |
|
| Văn bản tên địa điểm | name |
displayName |
Tên địa điểm dạng văn bản hiện có thể truy cập được dưới dạng displayName.text và language dưới dạng displayName.languageCode |
| Giờ mở cửa | opening_hours |
regularOpeningHours |
|
| Photos | 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 Chuyển sang 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 từ hôm nay (trừ trường hợp ngoại lệ) và mọi 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ố lượt 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ề lối đi 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 chính của địa điểm | primaryTypeName |
Mới | |
| Đặt loại chính làm 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ả dữ liệu khác | 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 |
Các thay đổi về câu trả lời của tính năng Tìm kiếm 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 văn bản hiện có và đối tượng phản hồi cho Tìm kiếm 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.
| Kỹ thuật | Tìm kiếm văn bản (Hiện có) | Tìm kiếm văn bản (Mới) | Ghi chú |
|---|---|---|---|
| Thông tin ghi nhận sự đóng góp về đị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 tiêu chuẩn (mã và thông báo phản hồi HTTP) | |
| Mọi thông báo cung cấp 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 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 tính năng Tìm kiếm lân cận hiện có và đối tượng phản hồi cho tính năng 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.
| Kỹ thuật | 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 về địa điểm | html_attributions |
Đã di chuyển vào đối tượng Place (Địa điểm) 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 tiêu chuẩn (mã và thông báo phản hồi HTTP) | |
| Mọi thông báo cung cấp thông tin | info_messages |
Đã xóa | |
| Mã thông báo trang | next_page_token |
Đã xóa |
Các thay đổi trong câu trả lời về Thông tin chi tiết về địa điểm
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 Chi tiết địa điểm hiện có và đối tượng phản hồi cho 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.
| Kỹ thuật | 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 vào đối tượng Place
mới 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 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 cung cấp thông tin | info_messages |
Đã chuyển sang phản hồi HTTP tiêu chuẩn (mã và thông báo phản hồi HTTP) |