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)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "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)
  },
  "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,
  "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)
  },
  "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 отзывов.

regularOpeningHours

object ( OpeningHours )

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

timeZone

object ( TimeZone )

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

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 )

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

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

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

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 )

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

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-представление 
{
  "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-представление 
{
  "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 Заведение закрыто навсегда.

Уровень цен

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

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

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

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 )

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

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

Основная информация о достопримечательностях и их взаимосвязи с целевым местоположением.

Достопримечательности — это заметные места, которые можно использовать для описания местности.

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

string

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

placeId

string

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

displayName

object ( LocalizedText )

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

types[]

string

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

spatialRelationship

enum ( SpatialRelationship )

Определяет пространственное соотношение между целевым местоположением и ориентиром.

straightLineDistanceMeters

number

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

travelDistanceMeters

number

Расстояние в метрах по дорожной сети от целевого объекта до ориентира, если оно известно. Это значение не учитывает вид транспорта, например, ходьбу, вождение автомобиля или велосипеда.

Пространственные отношения

Определяет пространственное соотношение между целевым местоположением и ориентиром.

Перечисления
NEAR Это соотношение по умолчанию, если ничего более конкретного, описанного ниже, не применяется.
WITHIN Ориентир имеет пространственную геометрию, и цель находится в его пределах.
BESIDE Цель находится непосредственно рядом с ориентиром.
ACROSS_THE_ROAD Цель находится прямо напротив ориентира на другой стороне дороги.
DOWN_THE_ROAD На том же маршруте, что и достопримечательность, но не рядом и не по другую сторону.
AROUND_THE_CORNER Находится не на том же маршруте, что и достопримечательность, а всего в одном повороте от нее.
BEHIND Расположен недалеко от достопримечательности, но дальше от ее уличных входов.

Область

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

Термин «территория» включает в себя точные сублокальности, районы и крупные комплексы, которые полезны для описания местности.

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

string

Название ресурса в этом районе.

placeId

string

Идентификатор населенного пункта в этом районе.

displayName

object ( LocalizedText )

Название отображаемой области.

containment

enum ( Containment )

Определяет пространственное соотношение между целевым местоположением и территорией.

Сдерживание

Определяет пространственное соотношение между целевым местоположением и территорией.

Перечисления
CONTAINMENT_UNSPECIFIED Условия хранения не указаны.
WITHIN Целевое местоположение находится в пределах указанного региона, недалеко от центра.
OUTSKIRTS Целевое местоположение находится в пределах указанной области, недалеко от границы.
NEAR Целевое местоположение находится за пределами указанного региона, но в непосредственной близости.

Ценовой диапазон

endPrice цен, связанный с местом, может быть не задан, что указывает на диапазон без верхней границы (например, «Больше 100 долларов»).

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

object ( Money )

Нижняя граница ценового диапазона (включительно). Цена должна быть равна или превышать эту сумму.

endPrice

object ( Money )

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

Обзор

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.

Краткое описание района

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.

Предупреждение для потребителей

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.

Методы

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.