Trường dữ liệu địa điểm

Chọn nền tảng: Android iOS JavaScript Dịch vụ web

Trường dữ liệu địa điểm xác định các loại dữ liệu Địa điểm cần trả về khi yêu cầu Thông tin chi tiết về địa điểm. Trang này liệt kê tất cả các trường dữ liệu địa điểm, đồng thời giải thích cách chúng được hỗ trợ cho mỗi API/SDK (khả năng hỗ trợ các trường địa điểm khác nhau tuỳ theo nền tảng và/hoặc tính năng).

Để biết thêm thông tin về cách tính phí các yêu cầu Thông tin chi tiết về địa điểm, hãy xem phần Cách sử dụng và thanh toán.

Bảng sau đây liệt kê tất cả các giá trị trường dữ liệu địa điểm được hỗ trợ theo cấp giá và nền tảng.

Lưu ý quan trọng: Vì không thể để trống kết quả dữ liệu địa điểm, nên chỉ kết quả địa điểm có dữ liệu được trả về. Ví dụ: nếu một địa điểm được yêu cầu không có ảnh, trường photos sẽ không xuất hiện trong kết quả.

Dữ liệu cơ bản

Trường	API Địa điểm	Thư viện địa điểm, API Maps JavaScript	SDK Địa điểm dành cho Android	SDK Địa điểm dành cho iOS
Thành phần địa chỉ	address_component	address_component	Place.Field.ADDRESS_COMPONENTS	GMSPlaceFieldAddressComponents
Address (Địa chỉ)	adr_address	adr_address	---	---
Trạng thái doanh nghiệp	business_status	business_status	Place.Field.BUSINESS_STATUS	GMSPlaceFieldBusinessStatus
Địa chỉ được định dạng	formatted_address	formatted_address	Place.Field.ADDRESS	GMSPlaceFieldFormattedAddress
Khung nhìn	geometry/viewport	geometry.viewport	Place.Field.VIEWPORT	GMSPlaceFieldViewport
Vị trí	geometry/location	geometry.location	Place.Field.LAT_LNG	GMSPlaceFieldCoordinate
Biểu tượng	icon	icon	---	---
Biểu tượng URI cơ sở của mặt nạ	icon_mask_base_uri	icon_mask_base_uri	Place.Field.ICON_URL	GMSPlaceFieldIconImageURL
Biểu tượng màu nền	icon_background_color	icon_background_color	Place.Field.ICON_BACKGROUND_COLOR	GMSPlaceFieldIconBackgroundColor
Tên	name	name	Place.Field.NAME	GMSPlaceFieldName
Đóng cửa vĩnh viễn (không dùng nữa)	permanently_closed	permanently_closed	---	---
Ảnh	photos	photos	Place.Field.PHOTO_METADATAS	GMSPlaceFieldPhotos
Mã địa điểm	place_id	place_id	Place.Field.ID	GMSPlaceFieldPlaceID
Plus Code	plus_code	plus_code	Place.Field.PLUS_CODE	GMSPlaceFieldPlusCode
Loại	type	type	Place.Field.TYPES	GMSPlaceFieldTypes
URL	url	url	---	---
Chênh lệch múi giờ UTC	utc_offset	utc_offset_minutes	Place.Field.UTC_OFFSET	GMSPlaceFieldUTCOffsetMinutes
Vùng lân cận	vicinity	vicinity	---	---
Lối vào cho xe lăn	wheelchair_accessible_entrance	---	---	GMSPlaceFieldWheelchairAccessibleEntrance

Trường dữ liệu liên hệ

Trường	API Địa điểm	Thư viện địa điểm, API Maps JavaScript	SDK Địa điểm dành cho Android	SDK Địa điểm dành cho iOS
Số điện thoại	formatted_phone_number	formatted_phone_number	---	---
Số điện thoại quốc tế	international_phone_number	international_phone_number	Place.Field.PHONE_NUMBER	GMSPlaceFieldPhoneNumber
Giờ mở cửa	opening_hours	opening_hours	Place.Field.OPENING_HOURS	GMSPlaceFieldOpeningHours
Giờ mở cửa hiện tại	current_opening_hours	---	---	---
Giờ mở cửa phụ	secondary_opening_hours	---	---	---
Trang web	website	website	Place.Field.WEBSITE_URI	GMSPlaceFieldWebsite

Trường dữ liệu về bầu không khí

Trường	API Địa điểm	Thư viện địa điểm, API Maps JavaScript	SDK Địa điểm dành cho Android	SDK Địa điểm dành cho iOS
Nhận món ở khu vực trước nhà hàng	curbside_pickup	---	Place.Field.CURBSIDE_PICKUP	GMSPlaceFieldCurbsidePickup
Giao hàng	delivery	---	Place.Field.DELIVERY	GMSPlaceFieldDelivery
Ăn tại chỗ	dine_in	---	Place.Field.DINE_IN	GMSPlaceFieldDineIn
Tóm tắt của người biên tập	editorial_summary	---	---	---
Mức giá	price_level	price_level	Place.Field.PRICE_LEVEL	GMSPlaceFieldPriceLevel
Xếp hạng	rating	rating	Place.Field.RATING	GMSPlaceFieldRating
Có thể phân phát	reservable	---	---	GMSPlaceFieldReservable
Bài đánh giá	reviews	reviews	---	---
Phục vụ bia	serves_beer	---	---	GMSPlaceFieldServesBeer
Phục vụ bữa sáng	serves_breakfast	---	---	GMSPlaceFieldServesBreakfast
Phục vụ bữa sáng muộn	serves_brunch	---	---	GMSPlaceFieldServesBrunch
Phục vụ bữa tối	serves_dinner	---	---	GMSPlaceFieldServesDinner
Phục vụ bữa trưa	serves_lunch	---	---	GMSPlaceFieldServesLunch
Phục vụ đồ ăn chay	serves_vegetarian_food	---	---	GMSPlaceFieldServesVegetarianFood
Phục vụ rượu vang	serves_wine	---	---	GMSPlaceFieldServesWine
Mua mang đi	takeout	---	Place.Field.TAKEOUT	GMSPlaceFieldTakeout
Tổng xếp hạng của người dùng	user_ratings_total	user_ratings_total	Place.Field.USER_RATINGS_TOTAL	GMSPlaceFieldUserRatingsTotal

Hỗ trợ các trường API Địa điểm

Các yêu cầu Tìm kiếm địa điểm, Tìm kiếm lân cận và Tìm kiếm văn bản đều trả về một tập hợp con các trường được yêu cầu Chi tiết địa điểm trả về. Các phương thức này KHÔNG trả về các trường sau:

address_component adr_address curbside_pickup current_opening_hours delivery dine_in editorial_summary formatted_phone_number international_phone_number opening_hours.periods opening_hours.special_days opening_hours.type opening_hours.weekday_text reservable secondary_opening_hours reviews

serves_beer serves_breakfast serves_brunch serves_dinner serves_lunch serves_vegetarian_food serves_wine takeout type url user_ratings_total utc_offset_minutes vicinity website wheelchair_accessible_entrance

Để trả về một hoặc nhiều trường dữ liệu này cho một địa điểm, hãy tạo yêu cầu Thông tin chi tiết về địa điểm, truyền mã địa điểm và chỉ định những trường cần trả về.