Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Di chuyển phản hồi của Places API (Cũ)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Định dạng phản hồi cho các API Chi tiết đị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) đã thay đổi so với định dạng của các API 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 cho từng API. Hãy xem:

Thay đổi đối với phản hồ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
Thay đổi về phản hồi của Place Details

Thay đổi đối với đối tượng Place trong phản hồi

Bảng này cho thấy những thay đổi đối với Place object mới trong phản hồi cho Place Details (Mới), Nearby Search (Mới) và Tìm kiếm văn bản (Mới) so với Place object cũ.

Đối tượng phản hồi mới sử dụng kiểu viết 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ỉ định dạng vi mô của địa điểm	`adr_address`	`adrFormatAddress`
Trạng thái kinh doanh	`business_status`	`businessStatus`
Giờ mở cửa cho tuần tới	`current_opening_hours`	`currentOpeningHours`
Tóm tắt của biên tập viên	`editorial_summary`	`editorialSummary`
Địa chỉ theo định dạng	`formatted_address`	`formattedAddress`
Số điện thoại quốc gia	`formatted_phone_number`	`nationalPhoneNumber`
Thông tin vị trí	`geometry.location`	`location`
Khung nhìn	`geometry.viewport`	`viewport`
Thông tin 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 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 dạng văn bản	`name`	`displayName`	Giờ đây, bạn có thể truy cập vào 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 đối với thông tin 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ó 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ố lượt xếp hạng của người dùng	`user_ratings_total`	`userRatingCount`
Độ lệch UTC	`utc_offset`	`utcOffsetMinutes`
Dạng rút gọ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ề lối đi cho xe lăn	`wheelchair_accessible_entrance`	`accessibilityOptions`	`wheelchair_accessible_entrance` hiện có giá `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` 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 làm chuỗi văn bản		`primaryTypeDisplayName`	Mới
Giờ mở cửa phụ thông thường hằng tuần, có các trường hợp 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 này 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 điểm đế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ề bộ sạc xe điện của 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

Thay đổi về phản hồ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 (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.

Trường	Tìm kiếm văn bản (Cũ)	Tìm kiếm văn bản (Mới)	Ghi chú
Thông tin ghi công địa điểm	`html_attributions`		Đã 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 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ã 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 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á

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 Nearby Search (Cũ) và đối tượng phản hồi cho Nearby Search (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 (Phiên bản cũ)	Nearby Search (Mới)	Ghi chú
Thông tin ghi công địa điểm	`html_attributions`		Đã chuyển vào đối tượng Đị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 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ã 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 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á

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 Place Details (Cũ) và đối tượng phản hồi cho Place Details (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	Place Details (Cũ)	Chi tiết địa điểm (Mới)	Ghi chú
Thông tin ghi công địa điểm	`html_attributions`		Đã chuyển vào đối tượng Place mới dưới dạng `attributions`
Chi tiết địa điểm (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 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 chuẩn (mã phản hồi và thông báo HTTP)