REST Resource: places

Ресурс: Место

Вся информация, представляющая место.

JSON-представление
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
Поля
name

string

Имя ресурса этого места в формате places/{placeId} . Может использоваться для поиска места.

id

string

Уникальный идентификатор места.

displayName

object ( LocalizedText )

Локализованное название места, подходящее в качестве краткого удобочитаемого описания. Например, «Google Сидней», «Старбакс», «Пирмонт» и т. д.

types[]

string

Набор тегов типа для этого результата. Например, «политический» и «локальность». Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

primaryType

string

Основной тип данного результата. Этот тип должен быть одним из типов, поддерживаемых Places API. Например, «ресторан», «кафе», «аэропорт» и т. д. Место может иметь только один основной тип. Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

primaryTypeDisplayName

object ( LocalizedText )

Отображаемое имя основного типа, локализованное на язык запроса, если применимо. Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

nationalPhoneNumber

string

Удобочитаемый номер телефона места в национальном формате.

internationalPhoneNumber

string

Удобочитаемый номер телефона места в международном формате.

formattedAddress

string

Полный, удобочитаемый адрес этого места.

shortFormattedAddress

string

Короткий, понятный человеку адрес этого места.

addressComponents[]

object ( AddressComponent )

Повторяющиеся компоненты для каждого уровня местности. Обратите внимание на следующие факты о массиве AddressComponents[]: - Массив компонентов адреса может содержать больше компонентов, чем форматированный адрес. — Массив не обязательно включает в себя все политические объекты, содержащие адрес, кроме включенных в форматированный адрес. Чтобы получить все политические объекты, содержащие определенный адрес, вам следует использовать обратное геокодирование, передавая широту/долготу адреса в качестве параметра запроса. - Формат ответа не может быть неизменным между запросами. В частности, количество адресных компонентов варьируется в зависимости от запрошенного адреса и может меняться со временем для одного и того же адреса. Компонент может менять положение в массиве. Тип компонента может измениться. В более позднем ответе может отсутствовать определенный компонент.

plusCode

object ( PlusCode )

Плюс код местоположения места по широте/долготе.

location

object ( LatLng )

Положение этого места.

viewport

object ( Viewport )

Окно просмотра, подходящее для отображения места на карте среднего размера.

rating

number

Оценка от 1,0 до 5,0 на основе отзывов пользователей об этом месте.

googleMapsUri

string

URL-адрес, предоставляющий дополнительную информацию об этом месте.

websiteUri

string

Авторитетный веб-сайт этого места, например домашняя страница компании. Обратите внимание, что для мест, входящих в сеть (например, магазина IKEA), обычно это веб-сайт отдельного магазина, а не всей сети.

reviews[]

object ( Review )

Список отзывов об этом месте, отсортированный по актуальности. Можно вернуть не более 5 отзывов.

regularOpeningHours

object ( OpeningHours )

Обычные часы работы.

photos[]

object ( Photo )

Информация (включая ссылки) о фотографиях этого места. Вернуть можно максимум 10 фотографий.

adrFormatAddress

string

Адрес места в микроформате adr: http://microformats.org/wiki/adr .

businessStatus

enum ( BusinessStatus )

Деловой статус места.

priceLevel

enum ( PriceLevel )

Уровень цен места.

attributions[]

object ( Attribution )

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

iconMaskBaseUri

string

Усеченный URL-адрес маски значка. Пользователь может получить доступ к другому типу значков, добавив суффикс типа в конец (например, «.svg» или «.png»).

iconBackgroundColor

string

Цвет фона для icon_mask в шестнадцатеричном формате, например #909CE1.

currentOpeningHours

object ( OpeningHours )

Часы работы на ближайшие семь дней (включая сегодня). Период времени начинается в полночь даты запроса и заканчивается в 23:59 шесть дней спустя. Это поле включает подполе SpecialDays для всех часов, заданное для дат с исключительными часами.

currentSecondaryOpeningHours[]

object ( OpeningHours )

Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы. Второстепенные часы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы в пути или часы доставки в качестве второстепенных часов. Это поле заполняет подполе типа, которое извлекается из заранее определенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) в зависимости от типа места. Это поле включает подполе SpecialDays для всех часов, заданное для дат с исключительными часами.

regularSecondaryOpeningHours[]

object ( OpeningHours )

Содержит массив записей для информации об обычных дополнительных часах работы компании. Второстепенные часы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы в пути или часы доставки в качестве второстепенных часов. Это поле заполняет подполе типа, которое извлекается из заранее определенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) в зависимости от типа места.

editorialSummary

object ( LocalizedText )

Содержит краткую информацию о месте. Резюме состоит из текстового обзора, а также включает код языка для него, если применимо. Текст резюме должен быть представлен «как есть» и не может быть изменен или изменен.

paymentOptions

object ( PaymentOptions )

Варианты оплаты, которые принимает место. Если данные о способе оплаты недоступны, поле варианта оплаты будет не заполнено.

parkingOptions

object ( ParkingOptions )

Варианты парковки предусмотрены местом.

subDestinations[]

object ( SubDestination )

Список дополнительных пунктов назначения, связанных с этим местом.

fuelOptions

object ( FuelOptions )

Самая свежая информация о вариантах топлива на АЗС. Эта информация регулярно обновляется.

evChargeOptions

object ( EVChargeOptions )

Информация о вариантах зарядки электромобилей.

utcOffsetMinutes

integer

На количество минут часовой пояс этого места смещен от UTC. Это выражается в минутах для поддержки часовых поясов, смещенных на доли часа, например X часов и 15 минут.

userRatingCount

integer

Общее количество отзывов (с текстом или без) для этого места.

takeout

boolean

Указывает, поддерживает ли компания доставку еды на вынос.

delivery

boolean

Указывает, поддерживает ли компания доставку.

dineIn

boolean

Указывает, поддерживает ли компания варианты сидения в помещении или на открытом воздухе.

curbsidePickup

boolean

Указывает, поддерживает ли компания самовывоз.

reservable

boolean

Указывает, поддерживает ли место резервирование.

servesBreakfast

boolean

Указывает, подают ли в заведении завтрак.

servesLunch

boolean

Указывает, подают ли в заведении обед.

servesDinner

boolean

Указывает, подают ли в заведении ужин.

servesBeer

boolean

Указывает, подают ли в заведении пиво.

servesWine

boolean

Указывает, подают ли в заведении вино.

servesBrunch

boolean

Указывает, подают ли в заведении поздние завтраки.

servesVegetarianFood

boolean

Указывает, подают ли в заведении вегетарианскую еду.

outdoorSeating

boolean

Место обеспечивает размещение на открытом воздухе.

liveMusic

boolean

Место обеспечивает живую музыку.

menuForChildren

boolean

В заведении есть детское меню.

servesCocktails

boolean

Место предлагает коктейли.

servesDessert

boolean

Место предлагает десерт.

servesCoffee

boolean

Место подают кофе.

goodForChildren

boolean

Место хорошее для детей.

allowsDogs

boolean

Место позволяет собакам.

restroom

boolean

Место имеет туалет.

goodForGroups

boolean

Место подходит для групп.

goodForWatchingSports

boolean

Место подходит для просмотра спортивных состязаний.

accessibilityOptions

object ( AccessibilityOptions )

Информация о возможностях доступности, предлагаемых местом.

Локализованныйтекст

Локализованный вариант текста на определенном языке.

JSON-представление
{
  "text": string,
  "languageCode": string
}
Поля
text

string

Локализованная строка на языке, соответствующем languageCode ниже.

languageCode

string

Языковой код текста BCP-47, например «en-US» или «sr-Latn».

Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .

Адресный компонент

Структурированные компоненты, формирующие форматированный адрес, если эта информация доступна.

JSON-представление
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Поля
longText

string

Полное текстовое описание или имя компонента адреса. Например, компонент адреса для страны Австралия может иметь длинное_имя «Австралия».

shortText

string

Сокращенное текстовое имя компонента адреса, если оно доступно. Например, компонент адреса для страны Австралия может иметь короткое_имя «AU».

types[]

string

Массив, указывающий тип(ы) компонента адреса.

languageCode

string

Язык, используемый для форматирования этих компонентов, в нотации CLDR.

ПлюсКод

Плюс-код ( http://plus.codes ) — это ссылка на местоположение в двух форматах: глобальный код, определяющий прямоугольник размером 14 x 14 м (1/8000 градуса) или меньше, и составной код, заменяющий префикс на ссылку на местоположение.

JSON-представление
{
  "globalCode": string,
  "compoundCode": string
}
Поля
globalCode

string

Глобальный (полный) код места, например «9FWM33GV+HQ», представляющий площадь 1/8000 на 1/8000 градусов (~ 14 на 14 метров).

compoundCode

string

Составной код места, например «33GV+HQ, Рамберг, Норвегия», содержащий суффикс глобального кода и заменяющий префикс форматированным именем ссылочного объекта.

ШиротаДлительность

Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.

JSON-представление
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Оно должно находиться в диапазоне [-180,0, +180,0].

Область просмотра

Окно просмотра широты и долготы, представленное в виде двух диагонально противоположных low и high точек. Область просмотра считается закрытой областью, т. е. включает в себя ее границу. Границы широты должны находиться в диапазоне от -90 до 90 градусов включительно, а границы долготы должны находиться в диапазоне от -180 до 180 градусов включительно. Различные случаи включают в себя:

  • Если low = high , область просмотра состоит из этой единственной точки.

  • Если low.longitude > high.longitude , диапазон долготы инвертируется (окно просмотра пересекает линию долготы в 180 градусов).

  • Если low.longitude = -180 градусов и high.longitude = 180 градусов, область просмотра включает все значения долготы.

  • Если low.longitude = 180 градусов и high.longitude = -180 градусов, диапазон долготы пуст.

  • Если low.latitude > high.latitude , диапазон широт пуст.

И low , и high должны быть заполнены, а представленное поле не может быть пустым (как указано в определениях выше). Пустое окно просмотра приведет к ошибке.

Например, это окно просмотра полностью охватывает Нью-Йорк:

{ "низкая": { "широта": 40,477398, "долгота": -74,259087 }, "высокая": { "широта": 40,91618, "долгота": -73,70018 } }

JSON-представление
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Поля
low

object ( LatLng )

Необходимый. Нижняя точка смотрового окна.

high

object ( LatLng )

Необходимый. Самая высокая точка смотрового окна.

Обзор

Информация об отзыве о месте.

JSON-представление
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
Поля
name

string

Ссылка, представляющая этот обзор места, которую можно использовать для повторного поиска этого обзора места (также называемая именем «ресурса» API: places/{placeId}/reviews/{review} ).

relativePublishTimeDescription

string

Строка форматированного недавнего времени, выражающая время просмотра относительно текущего времени в форме, соответствующей языку и стране.

text

object ( LocalizedText )

Локализованный текст обзора.

originalText

object ( LocalizedText )

Текст обзора на языке оригинала.

rating

number

Число от 1,0 до 5,0, также называемое количеством звезд.

authorAttribution

object ( AuthorAttribution )

Автор этого обзора.

publishTime

string ( Timestamp format)

Временная метка проверки.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Автор Атрибуция

Информация об авторе данных пользовательского контента. Используется в Photo и Review .

JSON-представление
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Поля
displayName

string

Имя автора Photo или Review .

uri

string

URI автора Photo или Review .

photoUri

string

URI фотографии профиля автора Photo или Review .

Часы работы

Информация о времени работы места.

JSON-представление
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
Поля
periods[]

object ( Period )

Периоды, когда это место открыто в течение недели. Периоды расположены в хронологическом порядке, начиная с воскресенья в местном часовом поясе. Пустое (но не отсутствующее) значение указывает на место, которое никогда не открыто, например, потому что оно временно закрыто на ремонт.

weekdayDescriptions[]

string

Локализованные строки, описывающие часы работы этого заведения, по одной строке на каждый день недели. Будет пустым, если часы неизвестны или их невозможно преобразовать в локализованный текст. Пример: «Вс: 18:00–06:00».

secondaryHoursType

enum ( SecondaryHoursType )

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

specialDays[]

object ( SpecialDay )

Структурированная информация для особых дней, попадающих в период, охватываемый возвращенными часами работы. Особые дни — это дни, которые могут повлиять на часы работы заведения, например Рождество. Установите значения currentOpeningHours и currentSecondaryOpeningHours, если есть исключительные часы.

openNow

boolean

Это место сейчас открыто? Всегда присутствует, если у нас нет данных о времени суток или часовом поясе для этих часов работы.

Период

Некоторое время место остается в статусе openNow.

JSON-представление
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Поля
open

object ( Point )

Время, когда место начинает открываться.

close

object ( Point )

Время, когда место начинает закрываться.

Точка

Точки изменения статуса.

JSON-представление
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Поля
date

object ( Date )

Дата в местном часовом поясе места.

truncated

boolean

Была ли эта конечная точка усечена или нет. Усечение происходит, когда реальные часы выходят за рамки времени, между которым мы готовы вернуть часы, поэтому мы усекаем часы обратно до этих границ. Это гарантирует возврат максимум 24*7 часов с полуночи дня запроса.

day

integer

День недели в виде целого числа в диапазоне 0–6. 0 — воскресенье, 1 — понедельник и т. д.

hour

integer

Час в 2-х цифрах. Диапазон от 00 до 23.

minute

integer

Минуты в 2-х цифрах. Диапазон от 00 до 59.

Дата

Представляет полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указана по григорианскому календарю. Это может представлять собой одно из следующих действий:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Связанные типы:

JSON-представление
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должно быть от 1 до 31 и действительно для года и месяца, или 0, чтобы указать год отдельно или год и месяц, если день не имеет значения.

Тип вторичных часов

Тип, используемый для определения типа дополнительных часов.

Перечисления
SECONDARY_HOURS_TYPE_UNSPECIFIED Значение по умолчанию, если не указан дополнительный тип часа.
DRIVE_THROUGH Час проезда для банков, ресторанов или аптек.
HAPPY_HOUR Счастливый час.
DELIVERY Час доставки.
TAKEOUT Час на вынос.
KITCHEN Кухонный час.
BREAKFAST Час завтрака.
LUNCH Обеденный час.
DINNER Час ужина.
BRUNCH Час бранча.
PICKUP Час самовывоза.
ACCESS Время доступа к местам хранения.
SENIOR_HOURS Специальные часы для пожилых людей.
ONLINE_SERVICE_HOURS График работы онлайн-сервиса.

Особенный день

Структурированная информация для особых дней, попадающих в период, охватываемый возвращенными часами работы. Особые дни — это дни, которые могут повлиять на часы работы заведения, например Рождество.

JSON-представление
{
  "date": {
    object (Date)
  }
}
Поля
date

object ( Date )

Дата этого особенного дня.

Фото

Информация о фотографии места.

JSON-представление
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
Поля
name

string

Идентификатор. Ссылка, представляющая фотографию этого места, которую можно использовать для повторного поиска этой фотографии места (также называемая именем «ресурса» API: places/{placeId}/photos/{photo} ).

widthPx

integer

Максимально доступная ширина в пикселях.

heightPx

integer

Максимально доступная высота в пикселях.

authorAttributions[]

object ( AuthorAttribution )

Авторы этой фотографии.

Бизнес-статус

Деловой статус места.

Перечисления
BUSINESS_STATUS_UNSPECIFIED Значение по умолчанию. Это значение не используется.
OPERATIONAL Заведение работает, но не обязательно открыто сейчас.
CLOSED_TEMPORARILY Заведение временно закрыто.
CLOSED_PERMANENTLY Заведение закрыто навсегда.

Уровень цены

Уровень цен места.

Перечисления
PRICE_LEVEL_UNSPECIFIED Уровень цен на место не указан или неизвестен.
PRICE_LEVEL_FREE Место предоставляет бесплатные услуги.
PRICE_LEVEL_INEXPENSIVE Место предоставляет недорогие услуги.
PRICE_LEVEL_MODERATE Место предоставляет услуги по умеренным ценам.
PRICE_LEVEL_EXPENSIVE Место предоставляет дорогие услуги.
PRICE_LEVEL_VERY_EXPENSIVE Место предоставляет очень дорогие услуги.

Атрибуция

Информация о поставщиках данных этого места.

JSON-представление
{
  "provider": string,
  "providerUri": string
}
Поля
provider

string

Имя поставщика данных места.

providerUri

string

URI поставщика данных места.

Варианты оплаты

Варианты оплаты, которые принимает место.

JSON-представление
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Поля
acceptsCreditCards

boolean

Place принимает к оплате кредитные карты.

acceptsDebitCards

boolean

Place принимает к оплате дебетовые карты.

acceptsCashOnly

boolean

Место принимает к оплате только наличные. Места с этим атрибутом по-прежнему могут принимать другие способы оплаты.

acceptsNfc

boolean

Место принимает платежи NFC.

Варианты парковки

Информация о вариантах парковки на месте. Парковка может поддерживать более одного варианта одновременно.

JSON-представление
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Поля
freeParkingLot

boolean

Место предлагает бесплатные парковки.

paidParkingLot

boolean

Место предлагает платные парковки.

freeStreetParking

boolean

В отеле Place имеется бесплатная уличная парковка.

paidStreetParking

boolean

Place предлагает платную уличную парковку.

valetParking

boolean

Место предлагает услуги парковщика.

freeGarageParking

boolean

В отеле Place имеется бесплатная парковка в гараже.

paidGarageParking

boolean

Место предлагает платную парковку в гараже.

Подпункт назначения

Имя ресурса места и идентификатор дополнительных пунктов назначения, связанных с этим местом. Например, разные терминалы — это разные пункты назначения аэропорта.

JSON-представление
{
  "name": string,
  "id": string
}
Поля
name

string

Имя ресурса дополнительного пункта назначения.

id

string

Идентификатор места дополнительного пункта назначения.

Параметры доступности

Информация о возможностях доступности, предлагаемых местом.

JSON-представление
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Поля
wheelchairAccessibleParking

boolean

В отеле Place есть парковка, оборудованная для гостей на инвалидных креслах.

wheelchairAccessibleEntrance

boolean

Места имеют вход для инвалидов-колясочников.

wheelchairAccessibleRestroom

boolean

Здесь есть туалет, оборудованный для гостей на инвалидных креслах.

wheelchairAccessibleSeating

boolean

Место имеет места для гостей на инвалидных креслах.

Варианты топлива

Самая свежая информация о вариантах топлива на АЗС. Эта информация регулярно обновляется.

JSON-представление
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Поля
fuelPrices[]

object ( FuelPrice )

Последняя известная цена на топливо для каждого вида топлива, которое есть на этой заправке. Для каждого типа топлива, имеющегося на этой заправке, имеется одна запись. Порядок не важен.

ТопливоЦена

Информация о ценах на топливо для данного типа.

JSON-представление
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Поля
type

enum ( FuelType )

Тип топлива.

price

object ( Money )

Цена топлива.

updateTime

string ( Timestamp format)

Время последнего обновления цены на топливо.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Тип топлива

Виды топлива.

Перечисления
FUEL_TYPE_UNSPECIFIED Неуказанный тип топлива.
DIESEL Дизельное топливо.
REGULAR_UNLEADED Обычный неэтилированный.
MIDGRADE Средний класс.
PREMIUM Премиум.
SP91 СП 91.
SP91_E10 СП 91 Е10.
SP92 СП 92.
SP95 СП 95.
SP95_E10 СП95 Е10.
SP98 СП 98.
SP99 СП 99.
SP100 СП 100.
LPG СУГ.
E80 Е 80.
E85 Е 85.
METHANE Метан.
BIO_DIESEL Биодизель.
TRUCK_DIESEL Грузовой дизель.

Деньги

Представляет сумму денег с типом валюты.

JSON-представление
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Поля
currencyCode

string

Трехбуквенный код валюты, определенный в ISO 4217.

units

string ( int64 format)

Целые единицы суммы. Например, если currencyCode равен "USD" , то 1 единица равна одному доллару США.

nanos

integer

Количество нано (10^-9) единиц суммы. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если units положительны, nanos должен быть положительным или нулевым. Если units равны нулю, nanos может быть положительным, нулевым или отрицательным. Если units измерения отрицательные, nanos должно быть отрицательным или нулевым. Например, -1,75 доллара США представлены как units = -1 и nanos = -750 000 000.

EVChargeOptions

Информация о станции зарядки электромобилей, размещенной на месте. Терминология соответствует https://afdc.energy.gov/fuels/electricity_infrastructure.html Один порт может заряжать один автомобиль за раз. Один порт имеет один или несколько разъемов. Одна станция имеет один или несколько портов.

JSON-представление
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Поля
connectorCount

integer

Количество разъемов на этой станции. Однако, поскольку некоторые порты могут иметь несколько разъемов, но одновременно могут заряжать только одну машину (например), количество разъемов может превышать общее количество автомобилей, которые могут заряжаться одновременно.

connectorAggregation[]

object ( ConnectorAggregation )

Список совокупностей разъемов для зарядки электромобилей, которые содержат разъемы одного типа и с одинаковой скоростью зарядки.

КоннекторАгрегация

Информация о зарядке электромобилей сгруппирована по [type, maxChargeRateKw]. Показывает совокупный заряд электромобилей для разъемов одного типа и максимальной скорости зарядки в кВт.

JSON-представление
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Поля
type

enum ( EVConnectorType )

Тип соединителя этого агрегата.

maxChargeRateKw

number

Статическая максимальная скорость зарядки в кВт для каждого разъема в совокупности.

count

integer

Количество соединителей в этом агрегировании.

availabilityLastUpdateTime

string ( Timestamp format)

Отметка времени последнего обновления информации о доступности соединителя в этом агрегировании.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

availableCount

integer

Количество соединителей в этом агрегировании, доступных на данный момент.

outOfServiceCount

integer

Количество соединителей в этом агрегировании, которые в настоящее время не обслуживаются.

Тип EVConnectorType

См. http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 для получения дополнительной информации/контекста о типах разъемов для зарядки электромобилей.

Перечисления
EV_CONNECTOR_TYPE_UNSPECIFIED Неопределенный разъем.
EV_CONNECTOR_TYPE_OTHER Другие типы разъемов.
EV_CONNECTOR_TYPE_J1772 Разъем J1772 тип 1.
EV_CONNECTOR_TYPE_TYPE_2 Разъем IEC 62196 типа 2. Часто называют МЕННЕКЕС.
EV_CONNECTOR_TYPE_CHADEMO Разъем типа CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Комбинированная система зарядки (переменный и постоянный ток). На основе SAE. Разъем типа 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Комбинированная система зарядки (переменный и постоянный ток). На основе разъема Mennekes типа 2.
EV_CONNECTOR_TYPE_TESLA Стандартный разъем TESLA. В Северной Америке это NACS, но в других частях мира это может быть не NACS (например, CCS Combo 2 (CCS2) или GB/T). Это значение в меньшей степени соответствует фактическому типу разъема и в большей степени отражает возможность зарядки автомобиля марки Tesla на зарядной станции, принадлежащей Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Тип GB/T соответствует стандарту GB/T в Китае. Этот тип охватывает все типы GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Неизвестная розетка.

Методы

autocomplete

 Возвращает прогнозы для заданных входных данных.

get

 Получите подробную информацию о месте на основе имени его ресурса, которое представляет собой строку в формате places/{place_id} .

searchNearby

 Поиск мест рядом с локациями.

searchText

 Поиск места на основе текстового запроса.