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

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

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

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

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

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

Поле 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.ADDRESS GMSPlaceFieldFormattedAddress
Viewport geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
Location geometry/location geometry.location Place.Field.LAT_LNG GMSPlaceFieldCoordinate
Icon icon icon --- ---
URI значка icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_URL GMSPlaceFieldIconImageURL
Icon Background Color icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
Name name name Place.Field.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.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 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_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

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