REST Resource: places

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

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

JSON-представление 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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

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

display Name

object ( LocalizedText )

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

types[]

string

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

primary Type

string

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

primary Type Display Name

object ( LocalizedText )

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

national Phone Number

string

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

international Phone Number

string

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

formatted Address

string

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

short Formatted Address

string

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

address Components[]

object ( AddressComponent )

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

plus Code

object ( PlusCode )

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

location

object ( LatLng )

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

viewport

object ( Viewport )

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

rating

number

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

google Maps Uri

string

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

website Uri

string

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

reviews[]

object ( Review )

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

regular Opening Hours

object ( OpeningHours )

Обычные часы работы. Обратите внимание: если место открыто всегда (24 часа), поле close не будет установлено. Клиенты могут рассчитывать на то, что всегда открыто (24 часа), представленное в виде периода [open][google.foo.OpeningHours.Period.open] , содержащего [day][google.foo.Point.day] со значением 0 , [hour][ google.foo.Point.hour] со значением 0 и [минута][google.foo.Point.hour] со значением 0 .

photos[]

object ( Photo )

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

adr Format Address

string

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

business Status

enum ( BusinessStatus )

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

price Level

enum ( PriceLevel )

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

attributions[]

object ( Attribution )

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

icon Mask Base Uri

string

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

icon Background Color

string

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

current Opening Hours

object ( OpeningHours )

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

current Secondary Opening Hours[]

object ( OpeningHours )

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

regular Secondary Opening Hours[]

object ( OpeningHours )

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

editorial Summary

object ( LocalizedText )

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

payment Options

object ( PaymentOptions )

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

parking Options

object ( ParkingOptions )

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

sub Destinations[]

object ( SubDestination )

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

fuel Options

object ( FuelOptions )

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

ev Charge Options

object ( EVChargeOptions )

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

generative Summary

object ( GenerativeSummary )

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

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

area Summary

object ( AreaSummary )

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

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

containing Places[]

object ( ContainingPlace )

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

address Descriptor

object ( AddressDescriptor )

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

price Range

object ( PriceRange )

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

utc Offset Minutes

integer

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

user Rating Count

integer

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

takeout

boolean

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

delivery

boolean

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

dine In

boolean

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

curbside Pickup

boolean

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

reservable

boolean

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

serves Breakfast

boolean

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

serves Lunch

boolean

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

serves Dinner

boolean

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

serves Beer

boolean

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

serves Wine

boolean

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

serves Brunch

boolean

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

serves Vegetarian Food

boolean

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

outdoor Seating

boolean

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

live Music

boolean

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

menu For Children

boolean

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

serves Cocktails

boolean

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

serves Dessert

boolean

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

serves Coffee

boolean

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

good For Children

boolean

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

allows Dogs

boolean

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

restroom

boolean

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

good For Groups

boolean

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

good For Watching Sports

boolean

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

accessibility Options

object ( AccessibilityOptions )

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

pure Service Area Business

boolean

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

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

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

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

string

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

language Code

string

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

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

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

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

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

string

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

short Text

string

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

types[]

string

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

language Code

string

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

ПлюсКод

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

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

string

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

compound Code

string

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

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

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

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

number

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

longitude

number

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

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

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

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

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

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

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

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

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

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

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

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

object ( LatLng )

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

high

object ( LatLng )

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

Обзор

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

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

string

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

relative Publish Time Description

string

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

text

object ( LocalizedText )

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

original Text

object ( LocalizedText )

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

rating

number

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

author Attribution

object ( AuthorAttribution )

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

publish Time

string ( Timestamp format)

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

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

flag Content Uri

string

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

google Maps Uri

string

Ссылка для показа обзора на Google Maps.

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

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

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

string

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

uri

string

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

photo Uri

string

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

Часы работы

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

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

object ( Period )

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

weekday Descriptions[]

string

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

secondary Hours Type

enum ( SecondaryHoursType )

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

special Days[]

object ( SpecialDay )

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

next Open Time

string ( Timestamp format)

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

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

next Close Time

string ( Timestamp format)

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

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

open Now

boolean

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

Период

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

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

object ( Point )

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

close

object ( Point )

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

Точка

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

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

object ( Date )

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

truncated

boolean

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

day

integer

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

hour

integer

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

minute

integer

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

Дата

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

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

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

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

integer

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

month

integer

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

day

integer

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

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

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

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

Специальный день

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

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

object ( Date )

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

Фото

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

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

string

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

width Px

integer

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

height Px

integer

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

author Attributions[]

object ( AuthorAttribution )

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

flag Content Uri

string

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

google Maps Uri

string

Ссылка для показа фотографии на Google Maps.

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

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

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

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

provider Uri

string

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

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

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

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

boolean

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

accepts Debit Cards

boolean

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

accepts Cash Only

boolean

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

accepts Nfc

boolean

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

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

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

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

boolean

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

paid Parking Lot

boolean

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

free Street Parking

boolean

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

paid Street Parking

boolean

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

valet Parking

boolean

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

free Garage Parking

boolean

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

paid Garage Parking

boolean

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

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

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

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

string

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

id

string

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

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

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

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

boolean

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

wheelchair Accessible Entrance

boolean

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

wheelchair Accessible Restroom

boolean

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

wheelchair Accessible Seating

boolean

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

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

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

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

object ( FuelPrice )

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

ТопливоЦена

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

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

enum ( FuelType )

Тип топлива.

price

object ( Money )

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

update Time

string ( Timestamp format)

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

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

Тип топлива

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

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

Деньги

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

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

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)
    }
  ]
}
Поля
connector Count

integer

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

connector Aggregation[]

object ( ConnectorAggregation )

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

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

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

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

enum ( EVConnectorType )

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

max Charge Rate Kw

number

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

count

integer

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

availability Last Update Time

string ( Timestamp format)

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

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

available Count

integer

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

out Of Service Count

integer

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

Тип EVConnectorType

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

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

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

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

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

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

object ( LocalizedText )

Обзор места.

overview Flag Content Uri

string

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

description

object ( LocalizedText )

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

description Flag Content Uri

string

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

references

object ( References )

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

Ссылки

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

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

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

object ( Review )

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

places[]

string

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

РайонСводка

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

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

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

object ( ContentBlock )

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

flag Content Uri

string

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

КонтентБлок

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

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

string

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

content

object ( LocalizedText )

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

references

object ( References )

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

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

СодержащееМесто

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

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

string

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

id

string

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

Адресдескриптор

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

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

Имя ресурса ориентира.

place Id

string

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

display Name

object ( LocalizedText )

Отображаемое название ориентира.

types[]

string

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

spatial Relationship

enum ( SpatialRelationship )

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

straight Line Distance Meters

number

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

travel Distance Meters

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

Имя ресурса области.

place Id

string

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

display Name

object ( LocalizedText )

Отображаемое имя области.

containment

enum ( Containment )

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

Сдерживание

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

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

Диапазон цен

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

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

object ( Money )

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

end Price

object ( Money )

Высший ценовой диапазон (эксклюзив). Цена должна быть ниже этой суммы.

Методы

autocomplete

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

get

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

search Nearby

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

search Text

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