Поля сведений о месте

Выберите платформу: Android iOS JavaScript Веб-сервисы

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

Подробнее о том, как взимается плата за запросы сведений о местах, читайте в статье Статистика использования и оплата.

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

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

Поле Places API Библиотека Places, Maps JavaScript API Places SDK для Android Places SDK для iOS
Компоненты адреса address_components address_components Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
Адрес adr_address adr_address --- ---
Статус компании business_status business_status Place.Field.BUSINESS_STATUS GMSPlaceFieldBusinessStatus
Форматированный адрес formatted_address formatted_address Place.Field.ADDRESS GMSPlaceFieldFormattedAddress
Область просмотра geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
Местоположение geometry/location geometry.location Place.Field.LAT_LNG GMSPlaceFieldCoordinate
Значок icon icon --- ---
URI значка icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_URL GMSPlaceFieldIconImageURL
Цвет фона значка icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
Название name name Place.Field.NAME GMSPlaceFieldName
Закрыто навсегда (поддержка прекращена) permanently_closed permanently_closed --- ---
Фото photos photos Place.Field.PHOTO_METADATAS GMSPlaceFieldPhotos
Идентификатор места place_id place_id Place.Field.ID GMSPlaceFieldPlaceID
Plus Code plus_code plus_code Place.Field.PLUS_CODE GMSPlaceFieldPlusCode
Тип type type Place.Field.TYPES GMSPlaceFieldTypes
URL url url --- ---
Разница с UTC utc_offset utc_offset_minutes Place.Field.UTC_OFFSET GMSPlaceFieldUTCOffsetMinutes
Места поблизости vicinity vicinity --- ---
Вход, оборудованный для инвалидов-колясочников wheelchair_accessible_entrance --- --- 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.PHONE_NUMBER GMSPlaceFieldPhoneNumber
Часы работы opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
Текущие часы работы current_opening_hours --- --- ---
Дополнительные часы работы secondary_opening_hours --- --- ---
Сайт 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 --- Place.Field.DELIVERY GMSPlaceFieldDelivery
Еда в заведении dine_in --- Place.Field.DINE_IN GMSPlaceFieldDineIn
Сводные данные editorial_summary --- --- ---
Уровень цен price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Оценка rating rating Place.Field.RATING GMSPlaceFieldRating
Бронирование reservable --- --- GMSPlaceFieldReservable
Отзывы reviews reviews --- ---
Подается пиво serves_beer --- --- GMSPlaceFieldServesBeer
Подаются завтраки serves_breakfast --- --- GMSPlaceFieldServesBreakfast
Поздние завтраки serves_brunch --- --- GMSPlaceFieldServesBrunch
Подаются ужины serves_dinner --- --- GMSPlaceFieldServesDinner
Подаются обеды serves_lunch --- --- GMSPlaceFieldServesLunch
Вегетарианские блюда serves_vegetarian_food --- --- GMSPlaceFieldServesVegetarianFood
Подается вино serves_wine --- --- GMSPlaceFieldServesWine
Еда навынос takeout --- Place.Field.TAKEOUT GMSPlaceFieldTakeout
Всего оценок user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

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

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

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

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