Đị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 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 về nội dung phản hồi của Tìm kiếm bằng văn bản
- Thay đổi về nội dung phản hồi của Tìm kiếm địa điểm lân cận
- 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
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 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 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 |
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 của đị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 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 của một địa điểm | evChargeOptions |
Mới | |
| Thuộc tính của đị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 bằng văn bản (Hiệ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 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 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 hiện tại 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 (Hiệ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 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 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 trong phần 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 đố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.
| Trường | Thông tin chi tiết về địa điểm (hiện 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 | 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) |