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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Выберите платформу: Android iOS JavaScript Веб-сервисы

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

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

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

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

Поле Places API Библиотека Places, Maps JavaScript API Places SDK для Android Places SDK для iOS
Компонент адреса address_component address_component 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 --- ---

Поля с контактными данными

Поле 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
Сайт website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

Поля с данными об отзывах

Поле Places API Библиотека Places, Maps JavaScript API Places SDK для Android Places SDK для iOS
Уровень цен price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
Оценка rating rating Place.Field.RATING GMSPlaceFieldRating
Отзывы reviews reviews --- ---
Всего оценок user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

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

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

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours
  • reviews
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

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