Поля данных о месте (устаревшая версия)

Поля сведений о месте определяют типы данных, которые должны возвращаться при запросе информации о месте (устаревшая версия). На этой странице перечислены все поля данных мест и указано, как они поддерживаются в каждом API/SDK (поддержка полей мест зависит от платформы и/или функции).

Подробнее о том, как взимается плата за запросы информации о местах (устаревшая версия), читайте в статье, посвященной статистике использования API и выставлению счетов.

В следующей таблице перечислены все поддерживаемые значения полей данных Places в зависимости от ценового уровня и платформы.

Основные данные

Поле Places API (устаревшая версия) Библиотека Places, Maps JavaScript API Places SDK для Android (устаревшая версия) Places SDK для iOS (устаревшая версия)
Компоненты адреса address_components address_components Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
Address adr_address adr_address --- ---
Статус компании business_status business_status Place.Field.BUSINESS_STATUS GMSPlaceFieldBusinessStatus
Formatted Address formatted_address formatted_address Place.Field.FORMATTED_ADDRESS GMSPlaceFieldFormattedAddress
Viewport geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
Location geometry/location geometry.location Place.Field.LOCATION GMSPlaceFieldCoordinate
Icon icon icon --- ---
URI значка icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_MASK_URL GMSPlaceFieldIconImageURL
Icon Background Color icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
Name name name Place.Field.DISPLAY_NAME GMSPlaceFieldName
Permanently Closed (больше не поддерживается) permanently_closed permanently_closed --- ---
Фото photos photos Place.Field.PHOTO_METADATAS GMSPlaceFieldPhotos
Place ID place_id place_id Place.Field.ID GMSPlaceFieldPlaceID
Plus Code plus_code plus_code Place.Field.PLUS_CODE GMSPlaceFieldPlusCode
Type type type Place.Field.TYPES GMSPlaceFieldTypes
URL url url --- ---
Разница с UTC utc_offset utc_offset_minutes Place.Field.UTC_OFFSET GMSPlaceFieldUTCOffsetMinutes
Vicinity vicinity vicinity --- ---
Вход, оборудованный для инвалидов-колясочников wheelchair_accessible_entrance --- Place.Field.ACCESSIBILITY_OPTIONS GMSPlaceFieldWheelchairAccessibleEntrance

Поля данных для контактов

Поле Places API (устаревшая версия) Библиотека Places, Maps JavaScript API Places SDK для Android (устаревшая версия) Places SDK для iOS (устаревшая версия)
Номер телефона formatted_phone_number formatted_phone_number --- ---
Номер телефона в международном формате international_phone_number international_phone_number Place.Field.INTERNATIONAL_PHONE_NUMBER GMSPlaceFieldPhoneNumber
Opening Hours opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
Current Opening Hours current_opening_hours --- Place.Field.CURRENT_OPENING_HOURS GMSPlaceFieldCurrentOpeningHours
Secondary Opening Hours secondary_opening_hours --- Place.Field.SECONDARY_OPENING_HOURS GMSPlaceFieldSecondaryOpeningHours
Website website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

Поля данных об атмосфере

Поле Places API (устаревшая версия) Библиотека Places, Maps JavaScript API Places SDK для Android (устаревшая версия) Places SDK для iOS (устаревшая версия)
Заказ с улицы curbside_pickup --- Place.Field.CURBSIDE_PICKUP GMSPlaceFieldCurbsidePickup
Delivery delivery --- Place.Field.DELIVERY GMSPlaceFieldDelivery
Dine-in dine_in --- Place.Field.DINE_IN GMSPlaceFieldDineIn
Editorial Summary editorial_summary --- Place.Field.EDITORIAL_SUMMARY GMSPlaceFieldEditorialSummary
Price Level price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Rating rating rating Place.Field.RATING GMSPlaceFieldRating
Reservable reservable --- Place.Field.RESERVABLE GMSPlaceFieldReservable
Reviews reviews reviews Place.Field.REVIEWS ---
Подается пиво serves_beer --- Place.Field.SERVES_BEER GMSPlaceFieldServesBeer
Serves Breakfast serves_breakfast --- Place.Field.SERVES_BREAKFAST GMSPlaceFieldServesBreakfast
Serves Brunch serves_brunch --- Place.Field.SERVES_BRUNCH GMSPlaceFieldServesBrunch
Serves Dinner serves_dinner --- Place.Field.SERVES_DINNER GMSPlaceFieldServesDinner
Serves Lunch serves_lunch --- Place.Field.SERVES_LUNCH GMSPlaceFieldServesLunch
Serves Vegetarian Food serves_vegetarian_food --- Place.Field.SERVES_VEGETARIAN_FOOD GMSPlaceFieldServesVegetarianFood
Serves Wine serves_wine --- Place.Field.SERVES_WINE GMSPlaceFieldServesWine
Takeout takeout --- Place.Field.TAKEOUT GMSPlaceFieldTakeout
User Ratings Total user_ratings_total user_ratings_total Place.Field.USER_RATINGS_COUNT GMSPlaceFieldUserRatingsTotal

Библиотека Places и поддержка полей Maps JavaScript API

Методы Find Place (Legacy), Nearby Search (Legacy) и Text Search (Legacy) возвращают только часть полей, возвращаемых запросами сведений о месте (устаревшая версия). Эти методы НЕ возвращают следующие поля:

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours (не возвращается методом Find Place; для поиска поблизости (устаревшая версия) и текстового поиска (устаревшая версия) используйте параметр запроса openNow)
  • reviews
  • takeout
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

Чтобы вернуть значения таких полей, сделайте запрос сведений о месте (устаревший), передав идентификатор места и указав, какие поля нужны.