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

Các 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 Chi tiết về địa điểm (Phiên bản cũ). Trang này liệt kê tất cả các trường dữ liệu về địa điểm và giải thích cách các trường này được hỗ trợ cho từng API/SDK (mức độ hỗ trợ cho các trường địa điểm tuỳ thuộc vào nền tảng và/hoặc tính năng).

Để biết thêm thông tin về cách tính phí cho các yêu cầu Chi tiết về địa điểm (Phiên bản cũ), hãy xem phần Mức sử dụng và việc thanh toán.

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

Dữ liệu cơ bản

Trường Places API (cũ) Thư viện địa điểm, Maps JavaScript API Places SDK for Android (Legacy) (Places SDK cho Android (Phiên bản cũ)) Places SDK for iOS (Cũ)
Thành phần địa chỉ address_components address_components Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
Địa chỉ adr_address adr_address --- ---
Trạng thái kinh doanh business_status business_status Place.Field.BUSINESS_STATUS GMSPlaceFieldBusinessStatus
Địa chỉ được định dạng formatted_address formatted_address Place.Field.FORMATTED_ADDRESS GMSPlaceFieldFormattedAddress
Khung nhìn geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
Thông tin vị trí geometry/location geometry.location Place.Field.LOCATION GMSPlaceFieldCoordinate
Biểu tượng icon icon --- ---
URI cơ sở của mặt nạ biểu tượng icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_MASK_URL GMSPlaceFieldIconImageURL
Màu nền biểu tượng icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
Tên name name Place.Field.DISPLAY_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 --- ---
Độ lệch 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 --- Place.Field.ACCESSIBILITY_OPTIONS GMSPlaceFieldWheelchairAccessibleEntrance

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

Trường Places API (cũ) Thư viện địa điểm, Maps JavaScript API Places SDK for Android (Legacy) (Places SDK cho Android (Phiên bản cũ)) Places SDK for iOS (Cũ)
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.INTERNATIONAL_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 --- Place.Field.CURRENT_OPENING_HOURS GMSPlaceFieldCurrentOpeningHours
Giờ mở cửa phụ secondary_opening_hours --- Place.Field.SECONDARY_OPENING_HOURS GMSPlaceFieldSecondaryOpeningHours
Trang web website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

Trường dữ liệu về khí quyển

Trường Places API (cũ) Thư viện địa điểm, Maps JavaScript API Places SDK for Android (Legacy) (Places SDK cho Android (Phiên bản cũ)) Places SDK for iOS (Cũ)
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 nội dung biên tập editorial_summary --- Place.Field.EDITORIAL_SUMMARY GMSPlaceFieldEditorialSummary
Mức giá price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Rating rating rating Place.Field.RATING GMSPlaceFieldRating
Có thể đặt trước reservable --- Place.Field.RESERVABLE GMSPlaceFieldReservable
Bài đánh giá reviews reviews Place.Field.REVIEWS ---
Phục vụ bia serves_beer --- Place.Field.SERVES_BEER GMSPlaceFieldServesBeer
Phục vụ bữa sáng serves_breakfast --- Place.Field.SERVES_BREAKFAST GMSPlaceFieldServesBreakfast
Phục vụ bữa nửa buổi serves_brunch --- Place.Field.SERVES_BRUNCH GMSPlaceFieldServesBrunch
Phục vụ bữa tối serves_dinner --- Place.Field.SERVES_DINNER GMSPlaceFieldServesDinner
Phục vụ bữa trưa serves_lunch --- Place.Field.SERVES_LUNCH GMSPlaceFieldServesLunch
Phục vụ đồ ăn chay serves_vegetarian_food --- Place.Field.SERVES_VEGETARIAN_FOOD GMSPlaceFieldServesVegetarianFood
Phục vụ rượu vang serves_wine --- Place.Field.SERVES_WINE GMSPlaceFieldServesWine
Mua mang đi takeout --- Place.Field.TAKEOUT GMSPlaceFieldTakeout
Tổng số điểm xếp hạng của người dùng user_ratings_total user_ratings_total Place.Field.USER_RATINGS_COUNT GMSPlaceFieldUserRatingsTotal

Hỗ trợ các trường Places API (Cũ)

Find Place (Legacy), Nearby Search (Legacy) và Text Search (Legacy) đều trả về một tập hợp con của các trường do yêu cầu Place Details (Legacy) 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 thực hiện một yêu cầu Chi tiết về địa điểm (Phiên bản cũ), truyền mã địa điểm và chỉ định những trường cần trả về.