Định dạng phản hồi cho các API 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 (mới) đã 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 bài viết 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 cho tính năng Tìm kiếm văn bản
- Các thay đổi về phản hồi đối với tính năng Tìm kiếm lân cận
- Các thay đổi về nội dung phản hồi đối với Thông tin chi tiết về địa điểm
Các thay đổi đối với đối tượng Place (Địa điểm) phản hồi
Bảng này cho thấy các thay đổi đối với đối tượng mới Place trong nội dung 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 kiểu 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 |
|
| Đặt địa chỉ vi định dạng | adr_address |
adrFormatAddress |
|
| Trạng thái doanh nghiệp | business_status |
businessStatus |
|
| Giờ mở cửa cho 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á. Hãy sử dụng iconMaskBaseUri và iconBackgroundColor. Hãy xem phần Đặt biểu tượng để 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 Thay đổi đối với 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, với 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ố lượng xếp hạng từ người dùng | user_ratings_total |
userRatingCount |
|
| Chênh lệch múi giờ UTC | utc_offset |
utcOffsetMinutes |
|
| Địa chỉ dạng ngắn, bao gồm tên đường và thị trấn | vicinity |
shortFormattedAddress |
|
| Trang web của địa điểm | website |
websiteUri |
|
| Thông tin về tình trạng có lối đi cho xe lăn | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance hiện đang ở mức
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 trong biểu mẫu 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 thông thườ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 về địa điểm đỗ 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ề việc sạc xe điện cho 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 |
Các thay đổi đối với phản hồi Tìm kiếm văn bả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 đối với 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ính năng 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 cho đị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 (Địa điểm) hiện 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 tiêu chuẩn (mã phản hồi HTTP và nội dung) | |
| Mọi thông báo lỗi | error_message |
Chuyển sang phản hồi HTTP tiêu chuẩn (mã phản hồi HTTP và nội dung) | |
| Thông báo dạng thông tin bất kỳ | info_messages |
Đã xóa | |
| Mã thông báo trang | next_page_token |
Đã xóa |
Các thay đổi về phản hồi của 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 đối với 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 cho đị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 (Địa điểm) 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ã phản hồi HTTP và nội dung) | |
| Mọi thông báo lỗi | error_message |
Chuyển sang phản hồi HTTP tiêu chuẩn (mã phản hồi HTTP và nội dung) | |
| Thông báo dạng thông tin bất kỳ | 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 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 Thông tin chi tiết về địa điểm hiện 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.
| Kỹ thuật | Thông tin về địa điểm (Hiện có) | Thông tin về địa điểm (Mới) | Ghi chú |
|---|---|---|---|
| Thông tin ghi nhận sự đóng góp cho địa điểm | html_attributions |
Di chuyển vào đối tượng Place mới dưới dạng attributions |
|
| Chi tiết địa điểm | result chứa đối tượng Địa điểm 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ã phản hồi HTTP và nội dung) | |
| Thông báo dạng thông tin bất kỳ | info_messages |
Chuyển sang phản hồi HTTP tiêu chuẩn (mã phản hồi HTTP và nội dung) |