Định dạng phản hồi cho
Thông tin về địa điểm,
Tìm kiếm lân cận
và
Tìm kiếm văn bản
API đã 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 mà mỗi phương thức trả về, như mô tả trong
Các thay đổi đối với đối tượng Place (Đị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 có thay đổi cho 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 giao diện mới
Đối tượng Place
trong câu trả lờ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 công cụ hiện có
đối tượng Place.
Đố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ó.
| 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ỉ đặ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á. Sử dụng iconMaskBaseUri và
iconBackgroundColor Xem
Biểu tượng địa điểm cho
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 bằng văn bản hiện có thể truy cập được như displayName.text và
language theo phong cách displayName.languageCode |
| Giờ mở cửa | opening_hours |
regularOpeningHours |
|
| Ảnh | photos |
photos |
Định dạng của photos đã thay đổi trong giao diện mới
Đối tượng Place. Để biết thêm thông tin, hãy xem
Chuyển sang tham chiếu hình ả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ừ các trường hợp ngoại lệ) 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 |
|
| 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ả các hoạt động khác dữ liệu | 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 trình bà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 công cụ Tìm kiếm văn bản hiện tại 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.
| Trường | 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 những thay đổi đối với các trường cấp cao nhất của phản hồi
đối tượng
cho tính năng Tìm kiếm lân cận hiện có và phản hồi
đối tượng
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ú |
|---|---|---|---|
| Thông tin ghi nhận sự đóng góp về địa điểm | html_attributions |
Đã di chuyển đến Địa điểm mới
đối tượng 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 giá trị mới
Đối tượng Place (Địa điểm) |
|
| 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 những thay đổi đối với các trường cấp cao nhất của phản hồi
đối tượng
cho Chi tiết địa điểm hiện có và phản hồi
đối tượng
để biết 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ó) | 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 đến Địa điểm mới
đối tượng 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) |