REST Resource: places

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

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

JSON-представление 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "googleMapsTypeLabel": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "openingDate": {
    object (Date)
  },
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "transitStation": {
    object (TransitStation)
  },
  "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,
  "utcOffsetMinutes": integer,
  "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)
  },
  "pureServiceAreaBusiness": boolean
}
Поля
name

string

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

id

string

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

displayName

object ( LocalizedText )

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

types[]

string

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

primaryType

string

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

primaryTypeDisplayName

object ( LocalizedText )

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

googleMapsTypeLabel

object ( LocalizedText )

Тип местоположения на Google Maps, локализованный, если применимо, под язык запроса, например, «Ресторан», «Кафе», «Аэропорт» и т. д. Тип местоположения может отличаться от основного отображаемого имени типа и может не являться поддерживаемым типом в таблице типов мест Places API .

nationalPhoneNumber

string

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

internationalPhoneNumber

string

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

formattedAddress

string

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

shortFormattedAddress

string

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

postalAddress

object ( PostalAddress )

Адрес в формате почтового адреса.

addressComponents[]

object ( AddressComponent )

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

photos[]

object ( Photo )

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

adrFormatAddress

string

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

businessStatus

enum ( BusinessStatus )

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

openingDate

object ( Date )

Дата открытия этого заведения в будущем. Это поле заполняется только в том случае, если статус заведения — FUTURE_OPENING (открытие в будущем).

priceLevel

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

iconMaskBaseUri

string

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

iconBackgroundColor

string

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

currentOpeningHours

object ( OpeningHours )

Время работы на следующие семь дней (включая сегодняшний день) с учетом любых особых часов работы. Период начинается в полночь в день запроса и заканчивается в 23:59 через шесть дней. Если фактическое время работы выходит за пределы этого диапазона, часы работы будут сокращены. Например, если заведение открыто с 22:00 вчера до 6:00 сегодня, часы работы будут сокращены до 00:00 сегодня до 6:00 сегодня. Это поле включает в себя подполе specialDays, содержащее все часы работы, установленные для дат с исключительными часами работы.

regularOpeningHours

object ( OpeningHours )

Обычные часы работы — это часы работы заведения по типичному расписанию. Обратите внимание, что если заведение открыто круглосуточно (24 часа), поле close не будет заполнено. Клиенты могут рассчитывать на то, что круглосуточное открытие будет представлено как период open , содержащий day со значением 0 , hour со значением 0 и minute со значением 0 .

currentSecondaryOpeningHours[]

object ( OpeningHours )

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

regularSecondaryOpeningHours[]

object ( OpeningHours )

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

timeZone

object ( TimeZone )

Часовой пояс в базе данных часовых поясов IANA. Например, "America/New_York".

editorialSummary

object ( LocalizedText )

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

paymentOptions

object ( PaymentOptions )

Способы оплаты, принимаемые в данном месте. Если данные о способе оплаты недоступны, поле «Способ оплаты» будет пустым.

parkingOptions

object ( ParkingOptions )

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

subDestinations[]

object ( SubDestination )

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

fuelOptions

object ( FuelOptions )

Самая актуальная информация о вариантах заправки на автозаправочной станции. Эта информация регулярно обновляется.

evChargeOptions

object ( EVChargeOptions )

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

generativeSummary

object ( GenerativeSummary )

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

containingPlaces[]

object ( ContainingPlace )

Список мест, в которых находится данное место.

addressDescriptor

object ( AddressDescriptor )

Описание адреса места. Описание адреса включает дополнительную информацию, помогающую описать местоположение с помощью ориентиров и районов. См. региональное покрытие описания адреса в https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage .

priceRange

object ( PriceRange )

Ценовой диапазон, связанный с данным местом.

reviewSummary

object ( ReviewSummary )

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

evChargeAmenitySummary

object ( EvChargeAmenitySummary )

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

neighborhoodSummary

object ( NeighborhoodSummary )

Краткое описание достопримечательностей в окрестностях данного места.

consumerAlert

object ( ConsumerAlert )

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

movedPlace

string

Если это место закрыто навсегда и переехало в новое место, это поле содержит название ресурса нового места в формате places/{placeId} . Если это место переезжало несколько раз, это поле будет представлять первое переехавшее место. Это поле не будет заполнено, если это место не переезжало.

movedPlaceId

string

Если это заведение окончательно закрыто и переехало в новое место, в этом поле будет указан идентификатор нового заведения. Если заведение переезжало несколько раз, в этом поле будет указано первое переехавшее заведение. Это поле не будет заполнено, если заведение не переезжало.

transitStation

object ( TransitStation )

Информация о транспортной станции в этом месте.

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

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

utcOffsetMinutes

integer

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

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 )

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

pureServiceAreaBusiness

boolean

Указывает, является ли данное место предприятием, предоставляющим исключительно услуги в определенной зоне обслуживания. К таким предприятиям относятся те, которые посещают клиентов или доставляют им товары напрямую, но не обслуживают их по своему адресу. Например, клининговые компании или сантехнические фирмы. У таких предприятий может не быть физического адреса или местоположения на Google Maps.

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

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

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 .

Почтовый адрес

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

В типичном случае адрес создается либо путем ввода данных пользователем, либо путем импорта существующих данных, в зависимости от типа процесса.

Советы по вводу или редактированию адреса:

  • Используйте готовый к интернационализации виджет адресов, например, https://github.com/google/libaddressinput .
  • Пользователям не следует предоставлять элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где эти поля используются.

Дополнительные инструкции по использованию этой схемы см. по ссылке: https://support.google.com/business/answer/6397478 .

JSON-представление 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Поля
revision

integer

Номер версии схемы объекта PostalAddress . Необходимо установить значение 0, что соответствует последней версии.

Все новые версии должны быть обратно совместимы со старыми версиями.

regionCode

string

Обязательно. Региональный код CLDR страны/региона, указанного в адресе. Этот код никогда не определяется автоматически, и пользователь должен убедиться в правильности значения. Подробнее см. https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: "CH" для Швейцарии.

languageCode

string

Необязательно. Языковой код BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе, где находится адрес, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не является критически важным для корректности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (вместо того чтобы указывать потенциально некорректное значение по умолчанию).

Примеры: «ж-Хант», «джа», «джа-Латн», «эн».

postalCode

string

Необязательно. Почтовый индекс адреса. Не во всех странах используется или требуется указание почтового индекса, но там, где он используется, это может привести к дополнительной проверке других частей адреса (например, проверка по штату или почтовому индексу в США).

sortingCode

string

Необязательный параметр. Дополнительный, специфичный для страны, код сортировки. В большинстве регионов он не используется. Там, где он используется, значение представляет собой либо строку, например, "CEDEX", за которой, при желании, следует число (например, "CEDEX 7"), либо только число, обозначающее "код сектора" (Ямайка), "индикатор зоны доставки" (Малави) или "индикатор почтового отделения" (Кот-д'Ивуар).

administrativeArea

string

Необязательно. Высшая административная единица, используемая для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Во многих странах административный район не используется в почтовых адресах. Например, в Швейцарии его следует оставлять незаполненным.

locality

string

Необязательно. Обычно относится к части адреса, обозначающей город или населенный пункт. Примеры: город в США, коммуна в ИТ, почтовый город в Великобритании. В регионах мира, где населенные пункты плохо определены или не вписываются в эту структуру, оставьте locality пустым и используйте addressLines .

sublocality

string

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

addressLines[]

string

Неструктурированные адресные строки, описывающие нижние уровни адреса.

Поскольку значения в addressLines не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, "Austin, TX"), важно, чтобы порядок строк был понятен. Порядок строк адреса должен соответствовать "порядку конверта" для страны или региона адреса. В местах, где это может варьироваться (например, в Японии), используется address_language для уточнения порядка (например, "ja" для порядка от большого к маленькому и "ja-Latn" или "en" для порядка от маленького к большому). Таким образом, можно выбрать наиболее подходящую строку адреса в зависимости от языка.

Минимально допустимое структурное представление адреса состоит из regionCode , а вся остальная информация размещается в addressLines . Такой адрес можно было бы отформатировать очень приблизительно без геокодирования, но никакие семантические рассуждения о компонентах адреса невозможны до тех пор, пока они не будут хотя бы частично определены.

Для обработки совершенно неструктурированных адресов рекомендуется создавать адрес, содержащий только regionCode и addressLines , а затем выполнять геокодирование (в отличие от попыток угадать, какие части адреса должны соответствовать населенным пунктам или административным районам).

recipients[]

string

Необязательно. Получатель по указанному адресу. В некоторых случаях это поле может содержать многострочную информацию. Например, оно может содержать информацию о получателе.

organization

string

Необязательно. Название организации по указанному адресу.

AddressComponent

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

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

string

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

shortText

string

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

types[]

string

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

languageCode

string

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

ПлюсКод

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

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

string

Полный глобальный код района, например, "9FWM33GV+HQ", обозначает область размером 1/8000 на 1/8000 градуса (примерно 14 на 14 метров).

compoundCode

string

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

LatLng

Объект, представляющий пару координат широты и долготы. Он выражается в виде пары чисел с плавающей запятой (double), обозначающих градусы широты и долготы. Если не указано иное, этот объект должен соответствовать стандарту 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,
  "flagContentUri": string,
  "googleMapsUri": string,
  "visitDate": {
    object (Date)
  }
}
Поля
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)

Отметка времени для обзора.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

flagContentUri

string

Ссылка, по которой пользователи могут сообщить о проблеме в отзыве.

googleMapsUri

string

Ссылка для отображения отзыва на Google Maps.

visitDate

object ( Date )

Дата посещения автором данного места. Указаны год и месяц посещения.

Авторское указание

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

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

string

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

uri

string

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

photoUri

string

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

Дата

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

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

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

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

integer

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

month

integer

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

day

integer

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

Фото

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

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

string

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

widthPx

integer

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

heightPx

integer

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

authorAttributions[]

object ( AuthorAttribution )

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

flagContentUri

string

Ссылка, по которой пользователи могут сообщить о проблеме с фотографией.

googleMapsUri

string

Ссылка для отображения фотографии на Google Maps.

BusinessStatus

Коммерческий статус этого места.

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

Уровень цен

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

Перечисления
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-представление 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Поля
periods[]

object ( Period )

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

Начальный день periods НЕ фиксирован и не должен считаться воскресеньем. API определяет начальный день на основе множества факторов. Например, для круглосуточного предприятия первый период может начинаться в день запроса. Для других предприятий это может быть первый день недели, когда они открыты.

ПРИМЕЧАНИЕ: Порядок элементов в массиве periods не зависит от порядка элементов в массиве weekdayDescriptions . Не следует предполагать, что они начнутся в один и тот же день.

weekdayDescriptions[]

string

Локализованные строки, описывающие часы работы этого места, по одной строке на каждый день недели.

ПРИМЕЧАНИЕ: Порядок дней и начало недели определяются локалью (языком и регионом). Порядок массива periods не зависит от порядка массива weekdayDescriptions . Не следует предполагать, что они будут начинаться в один и тот же день.

Поле будет пустым, если часы неизвестны или не могут быть преобразованы в локализованный текст. Пример: "Вс: 18:00–06:00"

secondaryHoursType

enum ( SecondaryHoursType )

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

specialDays[]

object ( SpecialDay )

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

nextOpenTime

string ( Timestamp format)

Следующий раз, когда начнётся текущий период работы, — не позднее чем через 7 дней. Это поле заполняется только в том случае, если текущий период работы неактивен на момент обработки запроса.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

nextCloseTime

string ( Timestamp format)

Следующий раз, когда закончится текущий период работы, — не позднее чем через 7 дней. Это поле заполняется только в том случае, если период работы активен на момент обработки запроса.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

openNow

boolean

Указывает, действует ли в данный момент указанный период времени. Для обычного и текущего времени работы это поле означает, открыто ли заведение. Для дополнительного времени работы и текущего дополнительного времени работы это поле означает, действует ли дополнительный график работы данного заведения.

Период

В течение некоторого времени это место остается в статусе «открыто сейчас».

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 часов с полуночи дня запроса.

day

integer

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

hour

integer

Час в 24-часовом формате. Диапазон от 0 до 23.

minute

integer

Минута. Диапазон от 0 до 59.

SecondaryHoursType

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

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

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

Часовой пояс

Представляет собой часовой пояс из базы данных часовых поясов IANA .

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

string

Часовой пояс в базе данных часовых поясов IANA. Например, "America/New_York".

version

string

Необязательно. Номер версии базы данных часовых поясов IANA. Например, "2019a".

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

В этом заведении принимаются различные способы оплаты.

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

В этом месте есть бесплатные парковки.

paidParkingLot

boolean

В этом месте есть платные парковки.

freeStreetParking

boolean

В этом месте есть бесплатная парковка на улице.

paidStreetParking

boolean

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

valetParking

boolean

В этом месте есть услуга парковщика.

freeGarageParking

boolean

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

paidGarageParking

boolean

В этом месте есть платная парковка в гараже.

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

Вспомогательные пункты назначения — это конкретные места, связанные с основным местом. Они предоставляют более конкретные пункты назначения для пользователей, которые ищут информацию в пределах большого или сложного объекта, такого как аэропорт, национальный парк, университет или стадион. Например, вспомогательные пункты назначения в аэропорту могут включать связанные терминалы и парковки. Вспомогательные пункты назначения возвращают идентификатор места и имя ресурса места, которые можно использовать в последующих запросах Place Details (New) для получения более подробной информации, включая отображаемое имя и местоположение вспомогательного пункта назначения.

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

string

Название ресурса подпункта назначения.

id

string

Идентификатор места назначения.

ДоступностьВарианты

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

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

boolean

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

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)

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

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Тип топлива

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

Перечисления
FUEL_TYPE_UNSPECIFIED Тип топлива не указан.
DIESEL Дизельное топливо.
DIESEL_PLUS Дизельное топливо плюс топливо.
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.
E100 Е 100.
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 )

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

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

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

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)

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

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

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. Часто обозначается как MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Разъем типа CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Комбинированная система зарядки (переменный и постоянный ток). Основана на стандарте SAE. Разъем J-1772 типа 1.
EV_CONNECTOR_TYPE_CCS_COMBO_2 Комбинированная система зарядки (переменный и постоянный ток). На основе разъема Mennekes Type-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 Неуказанная настенная розетка.
EV_CONNECTOR_TYPE_NACS Североамериканская система зарядки (NACS), стандартизированная как SAE J3400.

GenerativeSummary

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

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

object ( LocalizedText )

Общий обзор местности.

overviewFlagContentUri

string

Ссылка, по которой пользователи могут сообщить о проблеме, используя краткий обзор.

disclosureText

object ( LocalizedText )

Сообщение об использовании ИИ "Краткое изложение с помощью Gemini" (и его локализованные варианты). Если оно доступно, оно будет на языке, указанном в запросе.

ContainingPlace

Информация о месте, где это место находится.

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

string

Название ресурса, в котором находится данное место.

id

string

Идентификатор места, в котором находится данное место.

AddressDescriptor

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

JSON-представление 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Поля
landmarks[]

object ( Landmark )

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

areas[]

object ( Area )

A ranked list of containing or adjacent areas. The most recognizable and precise areas are ranked first.

Достопримечательность

Basic landmark information and the landmark's relationship with the target location.

Landmarks are prominent places that can be used to describe a location.

JSON-представление 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Поля
name

string

The landmark's resource name.

placeId

string

The landmark's place id.

displayName

object ( LocalizedText )

The landmark's display name.

types[]

string

A set of type tags for this landmark. For a complete list of possible values, see https://developers.google.com/maps/documentation/places/web-service/place-types .

spatialRelationship

enum ( SpatialRelationship )

Defines the spatial relationship between the target location and the landmark.

straightLineDistanceMeters

number

The straight line distance, in meters, between the center point of the target and the center point of the landmark. In some situations, this value can be longer than travelDistanceMeters .

travelDistanceMeters

number

The travel distance, in meters, along the road network from the target to the landmark, if known. This value does not take into account the mode of transportation, such as walking, driving, or biking.

SpatialRelationship

Defines the spatial relationship between the target location and the landmark.

Перечисления
NEAR This is the default relationship when nothing more specific below applies.
WITHIN The landmark has a spatial geometry and the target is within its bounds.
BESIDE The target is directly adjacent to the landmark.
ACROSS_THE_ROAD The target is directly opposite the landmark on the other side of the road.
DOWN_THE_ROAD On the same route as the landmark but not besides or across.
AROUND_THE_CORNER Not on the same route as the landmark but a single turn away.
BEHIND Close to the landmark's structure but further away from its street entrances.

Область

Area information and the area's relationship with the target location.

Areas includes precise sublocality, neighborhoods, and large compounds that are useful for describing a location.

JSON-представление 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Поля
name

string

The area's resource name.

placeId

string

The area's place id.

displayName

object ( LocalizedText )

The area's display name.

containment

enum ( Containment )

Defines the spatial relationship between the target location and the area.

Сдерживание

Defines the spatial relationship between the target location and the area.

Перечисления
CONTAINMENT_UNSPECIFIED The containment is unspecified.
WITHIN The target location is within the area region, close to the center.
OUTSKIRTS The target location is within the area region, close to the edge.
NEAR The target location is outside the area region, but close by.

PriceRange

The price range associated with a Place. endPrice could be unset, which indicates a range without upper bound (eg "More than $100").

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

object ( Money )

The low end of the price range (inclusive). Price should be at or above this amount.

endPrice

object ( Money )

The high end of the price range (exclusive). Price should be lower than this amount.

ReviewSummary

AI-generated summary of the place using user reviews.

JSON-представление 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
Поля
text

object ( LocalizedText )

The summary of user reviews.

flagContentUri

string

A link where users can flag a problem with the summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

reviewsUri

string

A link to show reviews of this place on Google Maps.

EvChargeAmenitySummary

The summary of amenities near the EV charging station. This only applies to places with type electric_vehicle_charging_station . The overview field is guaranteed to be provided while the other fields are optional.

JSON-представление 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Поля
overview

object ( ContentBlock )

An overview of the available amenities. This is guaranteed to be provided.

coffee

object ( ContentBlock )

A summary of the nearby coffee options.

restaurant

object ( ContentBlock )

A summary of the nearby restaurants.

store

object ( ContentBlock )

A summary of the nearby stores.

flagContentUri

string

A link where users can flag a problem with the summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

ContentBlock

A block of content that can be served individually.

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

object ( LocalizedText )

Content related to the topic.

referencedPlaces[]

string

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

NeighborhoodSummary

A summary of points of interest near the place.

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

object ( ContentBlock )

An overview summary of the neighborhood.

description

object ( ContentBlock )

A detailed description of the neighborhood.

flagContentUri

string

A link where users can flag a problem with the summary.

disclosureText

object ( LocalizedText )

The AI disclosure message "Summarized with Gemini" (and its localized variants). This will be in the language specified in the request if available.

ConsumerAlert

The consumer alert message for the place when we detect suspicious review activity on a business or a business violates our policies.

JSON-представление 
{
  "overview": string,
  "details": {
    object (Details)
  },
  "languageCode": string
}
Поля
overview

string

The overview of the consumer alert message.

details

object ( Details )

The details of the consumer alert message.

languageCode

string

The language code of the consumer alert message. This is a BCP 47 language code.

Подробности

The details of the consumer alert message.

JSON-представление 
{
  "title": string,
  "description": string,
  "aboutLink": {
    object (Link)
  }
}
Поля
title

string

The title to show together with the description.

description

string

The description of the consumer alert message.

TransitStation

Represents transit-specific information for a place.

JSON-представление 
{
  "displayName": {
    object (LocalizedText)
  },
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "stops": [
    {
      object (TransitStop)
    }
  ]
}
Поля
displayName

object ( LocalizedText )

The name of the station in the local language.

agencies[]

object ( TransitAgency )

The transit agencies that serve this station.

stops[]

object ( TransitStop )

Transit stops at this station.

TransitAgency

Represents a transit agency.

JSON-представление 
{
  "displayName": {
    object (LocalizedText)
  },
  "url": string,
  "fareUrl": string,
  "icon": {
    object (TransitIcon)
  },
  "lines": [
    {
      object (TransitLine)
    }
  ]
}
Поля
displayName

object ( LocalizedText )

Agency name (eg "VTA") in the requested language.

url

string

The URL of the agency's homepage.

fareUrl

string

The URL of the agency's fare details page.

icon

object ( TransitIcon )

Icon identifier for localized branded icon of a transit system (eg London Underground) which should be used instead of TransitLine.vehicle_icon in the UI.

lines[]

object ( TransitLine )

The transit lines that are served by this agency.

TransitIcon

Icon for a transit line, vehicle, or agency.

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

string

The URL of the icon.

nameIncluded

boolean

Whether the name is contained in the icon and there is no need to display it next to the icon.

TransitLine

Represents a single transit line.

JSON-представление 
{
  "id": string,
  "vehicleType": enum (VehicleType),
  "displayName": {
    object (LocalizedText)
  },
  "shortDisplayName": {
    object (LocalizedText)
  },
  "textColor": string,
  "backgroundColor": string,
  "url": string,
  "icon": {
    object (TransitIcon)
  },
  "vehicleIcon": {
    object (TransitIcon)
  }
}
Поля
id

string

The id of the transit line that can be used to uniquely identify the line among other transit lines in the same transit station. This identifier is not guaranteed to be stable across different responses.

vehicleType

enum ( VehicleType )

The type of vehicle using this line.

displayName

object ( LocalizedText )

The long name for this transit line (eg "Sunnydale local").

shortDisplayName

object ( LocalizedText )

The short name for this transit line (eg "S2").

textColor

string

The text color of labels for this transit line in #RRGGBB hex format, eg #909CE1.

backgroundColor

string

The background color of the labels for this transit line in #RRGGBB hex format, eg #909CE1. This color can also be used for drawing shapes for this transit line.

url

string

The URL of a webpage with details about this line.

icon

object ( TransitIcon )

Icon identifier for this particular line (eg subway lines in New York).

vehicleIcon

object ( TransitIcon )

Icon identifier for this particular vehicle type.

VehicleType

The type of vehicle for a transit line.

Перечисления
VEHICLE_TYPE_UNSPECIFIED Default value when vehicle type is not specified.
RAIL Rail.
METRO_RAIL Metro rail.
SUBWAY Метро.
TRAM Tram.
MONORAIL Monorail.
HEAVY_RAIL Heavy rail.
COMMUTER_TRAIN Commuter train.
HIGH_SPEED_TRAIN High speed train.
LONG_DISTANCE_TRAIN Long distance train.
BUS Bus.
INTERCITY_BUS Intercity bus.
TROLLEYBUS Trolleybus.
SHARE_TAXI Share taxi.
COACH Тренер.
FERRY Перевозить.
CABLE_CAR Cable car.
GONDOLA_LIFT Gondola lift.
FUNICULAR Funicular.
SPECIAL Особенный.
HORSE_CARRIAGE Horse carriage.
AIRPLANE Airplane.

TransitStop

Represents a transit stop within a station. This is a specific location where passengers board and alight transit vehicles, such as a platform or bus bay. This is distinct from a Departure , which is an event of a vehicle leaving a stop at a specific time.

JSON-представление 
{
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "platformCode": {
    object (LocalizedText)
  },
  "signageText": {
    object (LocalizedText)
  },
  "stopCode": {
    object (LocalizedText)
  },
  "location": {
    object (LatLng)
  },
  "wheelchairAccessibleEntrance": boolean
}
Поля
id

string

The id of the transit stop that can be used to uniquely identify the stop among other transit stops in the same transit station. This identifier is not guaranteed to be stable across different responses.

displayName

object ( LocalizedText )

The name of the stop.

platformCode

object ( LocalizedText )

The platform code represented by this stop. It can be formatted in any way. (eg: "2", "Platform 2", "2-4", or "1x").

signageText

object ( LocalizedText )

The verbatim text written on the signboard for this platform, eg "Towards Central" or "East side & Brooklyn". When platformCode is absent, this field is potentially the only identifier for the platform; however, both platformCode and signageText may be set simultaneously.

stopCode

object ( LocalizedText )

Human readable identifier of the stop, used by transit agencies to distinguish stops with the same name.

location

object ( LatLng )

The stop's location.

wheelchairAccessibleEntrance

boolean

Wheelchair accessibility of this stop. This field indicates whether there is an accessible path from outside the station to the stop. It does not indicate whether it is possible to board a vehicle from the stop.

Методы

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.