Giới thiệu
Định dạng phản hồi cho API Chi tiết về đị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 Các thay đổi đối với đối tượng Place trong 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:
- Các thay đổi về phản hồi của tính năng Tìm kiếm bằng văn bản
- Các 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 về phản hồi của Place Details
Các 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 mới Place 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 bằng văn bản (Mới) so với đối tượng cũ Place.
Đối tượng phản hồi mới sử dụng kiểu chữ lạc đà 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ỉ vi định dạng của địa điểm | adr_address |
adrFormatAddress |
|
| Trạng thái kinh doanh | business_status |
businessStatus |
|
| Giờ mở cửa vào 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 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 |
|
| Tên địa điểm bằng văn bản | name |
displayName |
Tên địa điểm dạng văn bản hiện có thể truy cập 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 ảnh tham khảo. |
| 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ó 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ượt xếp hạng của người dùng | user_ratings_total |
userRatingCount |
|
| Độ lệch UTC | utc_offset |
utcOffsetMinutes |
|
| Địa chỉ rút gọn, 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 có giá
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 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 một chuỗi văn bản | primaryTypeDisplayName |
Mới | |
| Giờ mở cửa phụ hằng tuần thông thường, có ngoại lệ và tất cả dữ liệu khác | regularSecondaryOpeningHours |
Mới | |
| Phương thức thanh toán mà địa điểm chấp nhận | paymentOptions |
Mới | |
| Các lựa chọn đỗ xe tại địa điểm | parkingOptions |
Mới | |
| Danh sách các địa điểm 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 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 |
Thay đổi về 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ính năng Tìm kiếm văn bản (Phiên bản cũ) và đối tượng phản hồi cho tính năng Tìm kiếm văn bản (Phiê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 (Cũ) | Tìm kiếm bằng văn bản (Mới) | Ghi chú |
|---|---|---|---|
| Thông tin ghi nhận sự đóng góp về địa điểm | html_attributions |
Đã 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 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 và thông báo HTTP) | |
| 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 và thông báo HTTP) | |
| Mọi thông báo thông tin | info_messages |
Đã xoá | |
| Mã thông báo trang | next_page_token |
Đã xoá |
Các thay đổi về 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 (Phiên bản cũ) và đối tượng phản hồi cho Tìm kiếm lân cận (Phiê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 | Nearby Search (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 |
Đã 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 cũ |
Mảng places của đối tượng Đị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 và thông báo HTTP) | |
| 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 và thông báo HTTP) | |
| Mọi thông báo thông tin | info_messages |
Đã xoá | |
| Mã thông báo trang | next_page_token |
Đã xoá |
Các thay đổi về phản hồi của Place Details (Mới)
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 Thông tin chi tiết về địa điểm (Phiên bản cũ) và đối tượng phản hồi cho Thông tin chi tiết về địa điểm (Phiê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 | Thông tin chi tiết về địa điểm (cũ) | Place Details (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 |
|
| Place Details (Mới) | result chứa đối tượng Place 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 và thông báo HTTP) | |
| Mọi thông báo thông tin | info_messages |
Chuyển sang phản hồi HTTP tiêu chuẩn (mã phản hồi và thông báo HTTP) |