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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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 )

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

generativeSummary

object ( GenerativeSummary )

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

areaSummary

object ( AreaSummary )

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

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 Неизвестная розетка.

ГенеративныйСводка

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

JSON-представление 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
overview

object ( LocalizedText )

Обзор места.

description

object ( LocalizedText )

Подробное описание места.

references

object ( References )

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

Ссылки

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

Ссылка, к которой относится генеративный контент.

JSON-представление 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Поля
reviews[]

object ( Review )

Обзоры, которые служат ссылками.

places[]

string

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

РайонСводка

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

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

object ( ContentBlock )

Блоки контента, составляющие сводку области. В каждом блоке есть отдельная тема о местности.

КонтентБлок

Блок контента, который можно обслуживать индивидуально.

JSON-представление 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
topic

string

Тема контента, например «обзор» или «ресторан».

content

object ( LocalizedText )

Содержимое, связанное с темой.

references

object ( References )

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

Ссылки, относящиеся к данному блоку контента.

Методы

autocomplete

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

get

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

searchNearby

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

searchText

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

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

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

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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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 )

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

generativeSummary

object ( GenerativeSummary )

Экспериментальный вариант: дополнительные сведения см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

areaSummary

object ( AreaSummary )

Экспериментальный вариант: дополнительные сведения см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

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 Часы онлайн -сервиса.

Specialday

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

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 )

Авторы этого фото.

BusinessStatus

Статус бизнеса для этого места.

Перечисления
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

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

acceptsDebitCards

boolean

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

acceptsCashOnly

boolean

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

acceptsNfc

boolean

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

Паркооп

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

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

boolean

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

paidParkingLot

boolean

Поместите предложения платных парковки.

freeStreetParking

boolean

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

paidStreetParking

boolean

Поместите предложения платной уличной парковки.

valetParking

boolean

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

freeGarageParking

boolean

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

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 "Zulu" с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Тип топлива

Типы топлива.

Перечисления
FUEL_TYPE_UNSPECIFIED Неопределенный тип топлива.
DIESEL Дизельное топливо.
REGULAR_UNLEADED Обычный неэтилирован.
MIDGRADE Мидлаг.
PREMIUM Премиум.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG Сжиссер
E80 E 80.
E85 E 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.

Загрузочные течения

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

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

integer

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

connectorAggregation[]

object ( ConnectorAggregation )

Список зарядных агрегаций разъема EV, которые содержат разъемы того же типа и такую ​​же скорость заряда.

ConnectorageGgreation

EV Зарядка информация, сгруппированная по [type, maxchargeratekw]. Показывает агрегацию заряда EV, которые имеют одинаковый тип и максимальный уровень заряда в кВт.

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

enum ( EVConnectorType )

Тип разъема этой агрегации.

maxChargeRateKw

number

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

count

integer

Количество разъемов в этой агрегации.

availabilityLastUpdateTime

string ( Timestamp format)

Неэппаратная метка, когда информация о доступности разъема в этой агрегации была в последний раз обновлена.

Временная метка в формате RFC3339 UTC "Zulu" с наносекундным разрешением и до девяти дробных цифр. Примеры: "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 Комбинированная система зарядки (AC и DC). На основе SAE. Разъем J-1772 типа 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Комбинированная система зарядки (AC и DC). На основе разъема Mennekes типа 2
EV_CONNECTOR_TYPE_TESLA Общий разъем Тесла. Это NAC в Северной Америке, но могут быть не NAC в других частях света (например, 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 Неопределенная розетка стены.

Генеративы

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

АИ-сгенерированное резюме места.

JSON-представление 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
overview

object ( LocalizedText )

Обзор места.

description

object ( LocalizedText )

Подробное описание места.

references

object ( References )

Ссылки, которые используются для создания краткого описания.

Ссылки

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ссылка на то, что генеративное содержание связано.

JSON-представление 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Поля
reviews[]

object ( Review )

Отзывы, которые служат ссылками.

places[]

string

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

Области

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ай-сгенерированная резюме области, в которой находится место.

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

object ( ContentBlock )

Контент блоки, которые составляют резюме области. У каждого блока есть отдельная тема о области.

ContentBlock

Блок контента, который можно подавать индивидуально.

JSON-представление 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
topic

string

Тема контента, например, «Обзор» или «Ресторан».

content

object ( LocalizedText )

Контент, связанный с темой.

references

object ( References )

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ссылки, которые связаны с этим блоком контента.

Методы

autocomplete

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

get

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

searchNearby

 Ищите места рядом с местами.

searchText

 Поиск на основе текстовых запросов.
,

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

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

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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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 Sydney», «Starbucks», «Pyrmont» и т. Д.

types[]

string

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

primaryType

string

Основной тип данного результата. Этот тип должен один из мест, поддерживаемых 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 [] Массив: - Массив компонентов адреса может содержать больше компонентов, чем FormattedAddress. - Массив не обязательно включает в себя все политические сущности, которые содержат адрес, кроме тех, которые включены в FormattedAddress. Чтобы получить все политические объекты, которые содержат определенный адрес, вы должны использовать обратное геокодирование, передавая широту/долготу адреса в качестве параметра запроса. - Формат ответа не гарантированно останется прежним между запросами. В частности, количество адресов Address Components варьируется в зависимости от запрошенного адреса и может измениться с течением времени для того же адреса. Компонент может изменить положение в массиве. Тип компонента может измениться. Конкретный компонент может отсутствовать в более позднем ответе.

plusCode

object ( PlusCode )

Плюс код места места Late/Long.

location

object ( LatLng )

Позиция этого места.

viewport

object ( Viewport )

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 Microformat: http://microformats.org/wiki/adr .

businessStatus

enum ( BusinessStatus )

Статус бизнеса для этого места.

priceLevel

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

iconMaskBaseUri

string

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

iconBackgroundColor

string

Цвет фона для ICON_MASK в формате HEX, например, #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 )

Информация о вариантах зарядки EV.

generativeSummary

object ( GenerativeSummary )

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

АИ-сгенерированное резюме места.

areaSummary

object ( AreaSummary )

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ай-сгенерированная резюме области, в которой находится место.

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 .

AddressComponent

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

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

string

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

shortText

string

Сокращенное текстовое имя для компонента адреса, если доступно. Например, адресный компонент для страны Австралии может иметь Short_Name of "AU".

types[]

string

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

languageCode

string

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

PlusCode

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

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

string

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

compoundCode

string

Составной код Place, такой как «33GV+HQ, Ramberg, Norway», содержащий суффикс глобального кода и замена префикса с форматированным именем эталонной объекта.

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

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

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

number

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

longitude

number

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

ViewPort

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

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

  • Если low.longitude > high.longitude .

  • Если low.longitude = -180 градусов и high.longitude .

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

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

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

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

{"low": {"Latitude": 40.477398, "Londitude": -74.259087}, "High": {"Latitude": 40.91618, "Londitude": -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 "Zulu" с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Автораттриование

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

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

string

Название автора Photo или Review .

uri

string

Ури автора 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 Часы онлайн -сервиса.

Specialday

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

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 )

Авторы этого фото.

BusinessStatus

Статус бизнеса для этого места.

Перечисления
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

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

acceptsDebitCards

boolean

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

acceptsCashOnly

boolean

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

acceptsNfc

boolean

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

Паркооп

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

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

boolean

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

paidParkingLot

boolean

Поместите предложения платных парковки.

freeStreetParking

boolean

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

paidStreetParking

boolean

Поместите предложения платной уличной парковки.

valetParking

boolean

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

freeGarageParking

boolean

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

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 "Zulu" с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Тип топлива

Типы топлива.

Перечисления
FUEL_TYPE_UNSPECIFIED Неопределенный тип топлива.
DIESEL Дизельное топливо.
REGULAR_UNLEADED Обычный неэтилирован.
MIDGRADE Мидлаг.
PREMIUM Премиум.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG Сжиссер
E80 E 80.
E85 E 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.

Загрузочные течения

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

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

integer

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

connectorAggregation[]

object ( ConnectorAggregation )

Список зарядных агрегаций разъема EV, которые содержат разъемы того же типа и такую ​​же скорость заряда.

ConnectorageGgreation

EV Зарядка информация, сгруппированная по [type, maxchargeratekw]. Показывает агрегацию заряда EV, которые имеют одинаковый тип и максимальный уровень заряда в кВт.

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

enum ( EVConnectorType )

Тип разъема этой агрегации.

maxChargeRateKw

number

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

count

integer

Количество разъемов в этой агрегации.

availabilityLastUpdateTime

string ( Timestamp format)

Неэппаратная метка, когда информация о доступности разъема в этой агрегации была в последний раз обновлена.

Временная метка в формате RFC3339 UTC "Zulu" с наносекундным разрешением и до девяти дробных цифр. Примеры: "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 Комбинированная система зарядки (AC и DC). На основе SAE. Разъем J-1772 типа 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Комбинированная система зарядки (AC и DC). На основе разъема Mennekes типа 2
EV_CONNECTOR_TYPE_TESLA Общий разъем Тесла. Это NAC в Северной Америке, но могут быть не NAC в других частях света (например, 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 Неопределенная розетка стены.

Генеративы

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

АИ-сгенерированное резюме места.

JSON-представление 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
overview

object ( LocalizedText )

Обзор места.

description

object ( LocalizedText )

Подробное описание места.

references

object ( References )

Ссылки, которые используются для создания краткого описания.

Ссылки

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ссылка на то, что генеративное содержание связано.

JSON-представление 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Поля
reviews[]

object ( Review )

Отзывы, которые служат ссылками.

places[]

string

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

Области

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ай-сгенерированная резюме области, в которой находится место.

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

object ( ContentBlock )

Контент блоки, которые составляют резюме области. У каждого блока есть отдельная тема о области.

ContentBlock

Блок контента, который можно подавать индивидуально.

JSON-представление 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
topic

string

Тема контента, например, «Обзор» или «Ресторан».

content

object ( LocalizedText )

Контент, связанный с темой.

references

object ( References )

Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации.

Ссылки, которые связаны с этим блоком контента.

Методы

autocomplete

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

get

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

searchNearby

 Ищите места рядом с местами.

searchText

 Поиск на основе текстовых запросов.
,

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

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

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)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "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 Sydney», «Starbucks», «Pyrmont» и т. Д.

types[]

string

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

primaryType

string

Основной тип данного результата. Этот тип должен один из мест, поддерживаемых API. For example, "restaurant", "cafe", "airport", etc. A place can only have a single primary type. For the complete list of possible values, see Table A and Table B at https://developers.google.com/maps/documentation/places/web-service/place-types

primaryTypeDisplayName

object ( LocalizedText )

The display name of the primary type, localized to the request language if applicable. For the complete list of possible values, see Table A and Table B at https://developers.google.com/maps/documentation/places/web-service/place-types

nationalPhoneNumber

string

A human-readable phone number for the place, in national format.

internationalPhoneNumber

string

A human-readable phone number for the place, in international format.

formattedAddress

string

A full, human-readable address for this place.

shortFormattedAddress

string

A short, human-readable address for this place.

addressComponents[]

object ( AddressComponent )

Repeated components for each locality level. Note the following facts about the addressComponents[] array: - The array of address components may contain more components than the formattedAddress. - The array does not necessarily include all the political entities that contain an address, apart from those included in the formattedAddress. To retrieve all the political entities that contain a specific address, you should use reverse geocoding, passing the latitude/longitude of the address as a parameter to the request. - The format of the response is not guaranteed to remain the same between requests. In particular, the number of addressComponents varies based on the address requested and can change over time for the same address. A component can change position in the array. The type of the component can change. A particular component may be missing in a later response.

plusCode

object ( PlusCode )

Plus code of the place location lat/long.

location

object ( LatLng )

The position of this place.

viewport

object ( Viewport )

A viewport suitable for displaying the place on an average-sized map.

rating

number

A rating between 1.0 and 5.0, based on user reviews of this place.

googleMapsUri

string

A URL providing more information about this place.

websiteUri

string

The authoritative website for this place, eg a business' homepage. Note that for places that are part of a chain (eg an IKEA store), this will usually be the website for the individual store, not the overall chain.

reviews[]

object ( Review )

List of reviews about this place, sorted by relevance. A maximum of 5 reviews can be returned.

regularOpeningHours

object ( OpeningHours )

The regular hours of operation.

photos[]

object ( Photo )

Information (including references) about photos of this place. A maximum of 10 photos can be returned.

adrFormatAddress

string

The place's address in adr microformat: http://microformats.org/wiki/adr .

businessStatus

enum ( BusinessStatus )

The business status for the place.

priceLevel

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

A set of data provider that must be shown with this result.

iconMaskBaseUri

string

A truncated URL to an icon mask. User can access different icon type by appending type suffix to the end (eg, ".svg" or ".png").

iconBackgroundColor

string

Background color for icon_mask in hex format, eg #909CE1.

currentOpeningHours

object ( OpeningHours )

The hours of operation for the next seven days (including today). Период времени начинается в полночь на дату запроса и заканчивается в 23:59 через шесть дней. This field includes the specialDays subfield of all hours, set for dates that have exceptional hours.

currentSecondaryOpeningHours[]

object ( OpeningHours )

Contains an array of entries for the next seven days including information about secondary hours of a business. Вторичные часы отличаются от основных часов бизнеса. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place. This field includes the specialDays subfield of all hours, set for dates that have exceptional hours.

regularSecondaryOpeningHours[]

object ( OpeningHours )

Contains an array of entries for information about regular secondary hours of a business. Вторичные часы отличаются от основных часов бизнеса. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place.

editorialSummary

object ( LocalizedText )

Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.

paymentOptions

object ( PaymentOptions )

Payment options the place accepts. If a payment option data is not available, the payment option field will be unset.

parkingOptions

object ( ParkingOptions )

Options of parking provided by the place.

subDestinations[]

object ( SubDestination )

A list of sub destinations related to the place.

fuelOptions

object ( FuelOptions )

The most recent information about fuel options in a gas station. This information is updated regularly.

evChargeOptions

object ( EVChargeOptions )

Information of ev charging options.

generativeSummary

object ( GenerativeSummary )

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

AI-generated summary of the place.

areaSummary

object ( AreaSummary )

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

AI-generated summary of the area that the place is in.

utcOffsetMinutes

integer

Number of minutes this place's timezone is currently offset from UTC. This is expressed in minutes to support timezones that are offset by fractions of an hour, eg X hours and 15 minutes.

userRatingCount

integer

The total number of reviews (with or without text) for this place.

takeout

boolean

Specifies if the business supports takeout.

delivery

boolean

Specifies if the business supports delivery.

dineIn

boolean

Specifies if the business supports indoor or outdoor seating options.

curbsidePickup

boolean

Specifies if the business supports curbside pickup.

reservable

boolean

Specifies if the place supports reservations.

servesBreakfast

boolean

Specifies if the place serves breakfast.

servesLunch

boolean

Specifies if the place serves lunch.

servesDinner

boolean

Specifies if the place serves dinner.

servesBeer

boolean

Specifies if the place serves beer.

servesWine

boolean

Specifies if the place serves wine.

servesBrunch

boolean

Specifies if the place serves brunch.

servesVegetarianFood

boolean

Specifies if the place serves vegetarian food.

outdoorSeating

boolean

Place provides outdoor seating.

liveMusic

boolean

Place provides live music.

menuForChildren

boolean

Place has a children's menu.

servesCocktails

boolean

Place serves cocktails.

servesDessert

boolean

Place serves dessert.

servesCoffee

boolean

Place serves coffee.

goodForChildren

boolean

Place is good for children.

allowsDogs

boolean

Place allows dogs.

restroom

boolean

Place has restroom.

goodForGroups

boolean

Place accommodates groups.

goodForWatchingSports

boolean

Place is suitable for watching sports.

accessibilityOptions

object ( AccessibilityOptions )

Information about the accessibility options a place offers.

LocalizedText

Localized variant of a text in a particular language.

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

string

Localized string in the language corresponding to languageCode below.

languageCode

string

The text's BCP-47 language code, such as "en-US" or "sr-Latn".

For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .

AddressComponent

The structured components that form the formatted address, if this information is available.

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

string

The full text description or name of the address component. For example, an address component for the country Australia may have a long_name of "Australia".

shortText

string

An abbreviated textual name for the address component, if available. For example, an address component for the country of Australia may have a short_name of "AU".

types[]

string

An array indicating the type(s) of the address component.

languageCode

string

The language used to format this components, in CLDR notation.

PlusCode

Plus code ( http://plus.codes ) is a location reference with two formats: global code defining a 14mx14m (1/8000th of a degree) or smaller rectangle, and compound code, replacing the prefix with a reference location.

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

string

Place's global (full) code, such as "9FWM33GV+HQ", representing an 1/8000 by 1/8000 degree area (~14 by 14 meters).

compoundCode

string

Place's compound code, such as "33GV+HQ, Ramberg, Norway", containing the suffix of the global code and replacing the prefix with a formatted name of a reference entity.

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

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

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

number

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

longitude

number

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

Viewport

A latitude-longitude viewport, represented as two diagonally opposite low and high points. A viewport is considered a closed region, ie it includes its boundary. The latitude bounds must range between -90 to 90 degrees inclusive, and the longitude bounds must range between -180 to 180 degrees inclusive. Various cases include:

  • If low = high , the viewport consists of that single point.

  • If low.longitude > high.longitude , the longitude range is inverted (the viewport crosses the 180 degree longitude line).

  • If low.longitude = -180 degrees and high.longitude = 180 degrees, the viewport includes all longitudes.

  • If low.longitude = 180 degrees and high.longitude = -180 degrees, the longitude range is empty.

  • If low.latitude > high.latitude , the latitude range is empty.

Both low and high must be populated, and the represented box cannot be empty (as specified by the definitions above). An empty viewport will result in an error.

For example, this viewport fully encloses New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

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

object ( LatLng )

Необходимый. The low point of the viewport.

high

object ( LatLng )

Необходимый. The high point of the viewport.

Обзор

Information about a review of a place.

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

string

A reference representing this place review which may be used to look up this place review again (also called the API "resource" name: places/{placeId}/reviews/{review} ).

relativePublishTimeDescription

string

A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.

text

object ( LocalizedText )

The localized text of the review.

originalText

object ( LocalizedText )

The review text in its original language.

rating

number

A number between 1.0 and 5.0, also called the number of stars.

authorAttribution

object ( AuthorAttribution )

This review's author.

publishTime

string ( Timestamp format)

Timestamp for the review.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

AuthorAttribution

Information about the author of the UGC data. Used in Photo , and Review .

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

string

Name of the author of the Photo or Review .

uri

string

URI of the author of the Photo or Review .

photoUri

string

Profile photo URI of the author of the Photo or Review .

OpeningHours

Information about business hour of the place.

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

object ( Period )

The periods that this place is open during the week. The periods are in chronological order, starting with Sunday in the place-local timezone. An empty (but not absent) value indicates a place that is never open, eg because it is closed temporarily for renovations.

weekdayDescriptions[]

string

Localized strings describing the opening hours of this place, one string for each day of the week. Will be empty if the hours are unknown or could not be converted to localized text. Example: "Sun: 18:00–06:00"

secondaryHoursType

enum ( SecondaryHoursType )

A type string used to identify the type of secondary hours.

specialDays[]

object ( SpecialDay )

Structured information for special days that fall within the period that the returned opening hours cover. Special days are days that could impact the business hours of a place, eg Christmas day. Set for currentOpeningHours and currentSecondaryOpeningHours if there are exceptional hours.

openNow

boolean

Whether the opening hours period is currently active. For regular opening hours and current opening hours, this field means whether the place is open. For secondary opening hours and current secondary opening hours, this field means whether the secondary hours of this place is active.

Период

A period the place remains in openNow status.

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

object ( Point )

The time that the place starts to be open.

close

object ( Point )

The time that the place starts to be closed.

Точка

Status changing points.

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

object ( Date )

Date in the local timezone for the place.

truncated

boolean

Whether or not this endpoint was truncated. Truncation occurs when the real hours are outside the times we are willing to return hours between, so we truncate the hours back to these boundaries. This ensures that at most 24 * 7 hours from midnight of the day of the request are returned.

day

integer

A day of the week, as an integer in the range 0-6. 0 is Sunday, 1 is Monday, etc.

hour

integer

The hour in 2 digits. Ranges from 00 to 23.

minute

integer

The minute in 2 digits. Ranges from 00 to 59.

Дата

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:

  • A full date, with non-zero year, month, and day values.
  • A month and day, with a zero year (for example, an anniversary).
  • A year on its own, with a zero month and a zero day.
  • A year and month, with a zero day (for example, a credit card expiration date).

Related types:

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

integer

Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

month

integer

Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

day

integer

Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

SecondaryHoursType

A type used to identify the type of secondary hours.

Перечисления
SECONDARY_HOURS_TYPE_UNSPECIFIED Default value when secondary hour type is not specified.
DRIVE_THROUGH The drive-through hour for banks, restaurants, or pharmacies.
HAPPY_HOUR The happy hour.
DELIVERY The delivery hour.
TAKEOUT The takeout hour.
KITCHEN The kitchen hour.
BREAKFAST The breakfast hour.
LUNCH The lunch hour.
DINNER The dinner hour.
BRUNCH The brunch hour.
PICKUP The pickup hour.
ACCESS The access hours for storage places.
SENIOR_HOURS The special hours for seniors.
ONLINE_SERVICE_HOURS The online service hours.

SpecialDay

Structured information for special days that fall within the period that the returned opening hours cover. Special days are days that could impact the business hours of a place, eg Christmas day.

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

object ( Date )

The date of this special day.

Фото

Information about a photo of a place.

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

string

Идентификатор. A reference representing this place photo which may be used to look up this place photo again (also called the API "resource" name: places/{placeId}/photos/{photo} ).

widthPx

integer

The maximum available width, in pixels.

heightPx

integer

The maximum available height, in pixels.

authorAttributions[]

object ( AuthorAttribution )

This photo's authors.

BusinessStatus

Business status for the place.

Перечисления
BUSINESS_STATUS_UNSPECIFIED Default value. This value is unused.
OPERATIONAL The establishment is operational, not necessarily open now.
CLOSED_TEMPORARILY The establishment is temporarily closed.
CLOSED_PERMANENTLY The establishment is permanently closed.

Уровень цены

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

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

Атрибуция

Information about data providers of this place.

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

string

Name of the Place's data provider.

providerUri

string

URI to the Place's data provider.

PaymentOptions

Payment options the place accepts.

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

boolean

Place accepts credit cards as payment.

acceptsDebitCards

boolean

Place accepts debit cards as payment.

acceptsCashOnly

boolean

Place accepts cash only as payment. Places with this attribute may still accept other payment methods.

acceptsNfc

boolean

Place accepts NFC payments.

ParkingOptions

Information about parking options for the place. A parking lot could support more than one option at the same time.

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

boolean

Place offers free parking lots.

paidParkingLot

boolean

Place offers paid parking lots.

freeStreetParking

boolean

Place offers free street parking.

paidStreetParking

boolean

Place offers paid street parking.

valetParking

boolean

Place offers valet parking.

freeGarageParking

boolean

Place offers free garage parking.

paidGarageParking

boolean

Place offers paid garage parking.

SubDestination

Place resource name and id of sub destinations that relate to the place. For example, different terminals are different destinations of an airport.

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

string

The resource name of the sub destination.

id

string

The place id of the sub destination.

AccessibilityOptions

Information about the accessibility options a place offers.

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

boolean

Place offers wheelchair accessible parking.

wheelchairAccessibleEntrance

boolean

Places has wheelchair accessible entrance.

wheelchairAccessibleRestroom

boolean

Place has wheelchair accessible restroom.

wheelchairAccessibleSeating

boolean

Place has wheelchair accessible seating.

FuelOptions

The most recent information about fuel options in a gas station. This information is updated regularly.

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

object ( FuelPrice )

The last known fuel price for each type of fuel this station has. There is one entry per fuel type this station has. Order is not important.

FuelPrice

Fuel price information for a given type.

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

enum ( FuelType )

The type of fuel.

price

object ( Money )

The price of the fuel.

updateTime

string ( Timestamp format)

The time the fuel price was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

Тип топлива

Types of fuel.

Перечисления
FUEL_TYPE_UNSPECIFIED Unspecified fuel type.
DIESEL Diesel fuel.
REGULAR_UNLEADED Regular unleaded.
MIDGRADE Midgrade.
PREMIUM Премиум.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG LPG.
E80 E 80.
E85 E 85.
METHANE Methane.
BIO_DIESEL Bio-diesel.
TRUCK_DIESEL Truck diesel.

Деньги

Represents an amount of money with its currency type.

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

string

The three-letter currency code defined in ISO 4217.

units

string ( int64 format)

The whole units of the amount. For example if currencyCode is "USD" , then 1 unit is one US dollar.

nanos

integer

Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If units is positive, nanos must be positive or zero. If units is zero, nanos can be positive, zero, or negative. If units is negative, nanos must be negative or zero. For example $-1.75 is represented as units =-1 and nanos =-750,000,000.

EVChargeOptions

Information about the EV Charge Station hosted in Place. Terminology follows https://afdc.energy.gov/fuels/electricity_infrastructure.html One port could charge one car at a time. One port has one or more connectors. One station has one or more ports.

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

integer

Number of connectors at this station. However, because some ports can have multiple connectors but only be able to charge one car at a time (eg) the number of connectors may be greater than the total number of cars which can charge simultaneously.

connectorAggregation[]

object ( ConnectorAggregation )

A list of EV charging connector aggregations that contain connectors of the same type and same charge rate.

ConnectorAggregation

EV charging information grouped by [type, maxChargeRateKw]. Shows EV charge aggregation of connectors that have the same type and max charge rate in kw.

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

enum ( EVConnectorType )

The connector type of this aggregation.

maxChargeRateKw

number

The static max charging rate in kw of each connector in the aggregation.

count

integer

Number of connectors in this aggregation.

availabilityLastUpdateTime

string ( Timestamp format)

The timestamp when the connector availability information in this aggregation was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

availableCount

integer

Number of connectors in this aggregation that are currently available.

outOfServiceCount

integer

Number of connectors in this aggregation that are currently out of service.

EVConnectorType

See http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 for additional information/context on EV charging connector types.

Перечисления
EV_CONNECTOR_TYPE_UNSPECIFIED Unspecified connector.
EV_CONNECTOR_TYPE_OTHER Other connector types.
EV_CONNECTOR_TYPE_J1772 J1772 type 1 connector.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 type 2 connector. Often referred to as MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO type connector.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (AC and DC). Based on SAE. Type-1 J-1772 connector
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC and DC). Based on Type-2 Mennekes connector
EV_CONNECTOR_TYPE_TESLA The generic TESLA connector. This is NACS in the North America but can be non-NACS in other parts of the world (eg CCS Combo 2 (CCS2) or GB/T). This value is less representative of an actual connector type, and more represents the ability to charge a Tesla brand vehicle at a Tesla owned charging station.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T type corresponds to the GB/T standard in China. This type covers all GB_T types.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Unspecified wall outlet.

GenerativeSummary

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

AI-generated summary of the place.

JSON-представление 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
overview

object ( LocalizedText )

The overview of the place.

description

object ( LocalizedText )

The detailed description of the place.

references

object ( References )

References that are used to generate the summary description.

Ссылки

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

Reference that the generative content is related to.

JSON-представление 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Поля
reviews[]

object ( Review )

Reviews that serve as references.

places[]

string

The list of resource names of the referenced places. This name can be used in other APIs that accept Place resource names.

AreaSummary

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

AI-generated summary of the area that the place is in.

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

object ( ContentBlock )

Content blocks that compose the area summary. Each block has a separate topic about the area.

ContentBlock

A block of content that can be served individually.

JSON-представление 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Поля
topic

string

The topic of the content, for example "overview" or "restaurant".

content

object ( LocalizedText )

Content related to the topic.

references

object ( References )

Experimental: See https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative for more details.

References that are related to this block of content.

Методы

autocomplete

 Returns predictions for the given input.

get

 Get the details of a place based on its resource name, which is a string in the places/{place_id} format.

searchNearby

 Search for places near locations.

searchText

 Text query based place search.