Package google.maps.places.v1

Индекс

Места

Определение сервиса для API Places. Примечание: каждый запрос (кроме запросов Autocomplete и GetPhotoMedia) требует установки маски поля вне протокола запроса ( all/* не предполагается). Маску поля можно установить через заголовок HTTP X-Goog-FieldMask . См.: https://developers.google.com/maps/documentation/places/web-service/choose-fields

АвтозаполнениеМеста

rpc AutocompletePlaces( AutocompletePlacesRequest ) returns ( AutocompletePlacesResponse )

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

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ПолучитьФотоМедиа

rpc GetPhotoMedia( GetPhotoMediaRequest ) returns ( PhotoMedia )

Получите фотоноситель со строкой ссылки на фотографию.

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace( GetPlaceRequest ) returns ( Place )

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

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ПоискРядом

rpc SearchNearby( SearchNearbyRequest ) returns ( SearchNearbyResponse )

Поиск мест поблизости.

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/cloud-platform
ПоискТекст

rpc SearchText( SearchTextRequest ) returns ( SearchTextResponse )

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

Области действия авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/cloud-platform

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

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

Поля
landmarks[]

Landmark

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

areas[]

Area

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

Область

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

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

Поля
name

string

Название ресурса области.

place_id

string

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

display_name

LocalizedText

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

containment

Containment

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

Сдерживание

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

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

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

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

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

Поля
name

string

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

place_id

string

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

display_name

LocalizedText

Отображаемое название достопримечательности.

types[]

string

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

spatial_relationship

SpatialRelationship

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

straight_line_distance_meters

float

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

travel_distance_meters

float

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

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

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

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

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

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

Поля
display_name

string

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

uri

string

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

photo_uri

string

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

АвтозаполнениеPlacesRequest

Запросить прототип для AutocompletePlaces.

Поля
input

string

Обязательно. Текстовая строка, по которой будет выполняться поиск.

location_bias

LocationBias

Необязательно. Смещение результатов в указанное место.

Максимум один из location_bias или location_restriction должен быть установлен. Если ни один из них не установлен, результаты будут смещены по IP-адресу, то есть IP-адрес будет сопоставлен с неточным местоположением и использован в качестве сигнала смещения.

location_restriction

LocationRestriction

Необязательно. Ограничить результаты указанным местоположением.

Максимум один из location_bias или location_restriction должен быть установлен. Если ни один из них не установлен, результаты будут смещены по IP-адресу, то есть IP-адрес будет сопоставлен с неточным местоположением и использован в качестве сигнала смещения.

included_primary_types[]

string

Необязательно. Включен основной тип места (например, "ресторан" или "бензоколонка") в Типы мест ( https://developers.google.com/maps/documentation/places/web-service/place-types) , или только (regions) , или только (cities) . Место возвращается только в том случае, если его основной тип включен в этот список. Можно указать до 5 значений. Если типы не указаны, возвращаются все типы мест.

included_region_codes[]

string

Необязательно. Включать только результаты в указанных регионах, указанных как до 15 двухсимвольных кодов регионов CLDR. Пустой набор не будет ограничивать результаты. Если заданы и location_restriction , и included_region_codes , результаты будут расположены в области пересечения.

language_code

string

Необязательно. Язык, на котором возвращаются результаты. По умолчанию en-US. Результаты могут быть на смешанных языках, если язык, используемый во input , отличается от language_code или если возвращаемое место не имеет перевода с локального языка на language_code .

region_code

string

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

origin

LatLng

Необязательно. Исходная точка, от которой вычисляется геодезическое расстояние до пункта назначения (возвращается как distance_meters ). Если это значение пропущено, геодезическое расстояние не будет возвращено.

input_offset

int32

Необязательно. Смещение символа Unicode на основе нуля для input , указывающее позицию курсора в input . Позиция курсора может влиять на возвращаемые прогнозы.

Если пусто, по умолчанию используется длина input .

include_query_predictions

bool

Необязательно. Если true, ответ будет включать как прогнозы Place, так и запросы. В противном случае ответ будет возвращать только прогнозы Place.

session_token

string

Необязательно. Строка, которая идентифицирует сеанс автозаполнения для выставления счетов. Должна быть безопасной строкой base64 URL и имени файла длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT.

Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место и выполняется вызов Place Details или Address Validation. Каждый сеанс может иметь несколько запросов, за которыми следует один запрос Place Details или Address Validation. Учетные данные, используемые для каждого запроса в сеансе, должны принадлежать одному проекту Google Cloud Console. После завершения сеанса токен больше недействителен; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр session_token пропущен или если вы повторно используете токен сеанса, сеанс тарифицируется так, как если бы токен сеанса не был предоставлен (каждый запрос тарифицируется отдельно).

Мы рекомендуем следующие рекомендации:

  • Используйте токены сеанса для всех вызовов Place Autocomplete.
  • Генерируйте новый токен для каждой сессии. Рекомендуется использовать UUID версии 4.
  • Убедитесь, что учетные данные, используемые для всех запросов Place Autocomplete, Place Details и Address Validation в рамках сеанса, принадлежат одному и тому же проекту Cloud Console.
  • Обязательно передайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для более чем одного сеанса приведет к тому, что каждый запрос будет выставлен по отдельности.
include_pure_service_area_businesses

bool

Необязательно. Включайте предприятия, работающие только в зоне обслуживания, если поле установлено в значение true. Предприятия, работающие только в зоне обслуживания, — это предприятия, которые посещают клиентов или доставляют им товары напрямую, но не обслуживают клиентов по адресу их бизнеса. Например, такие предприятия, как клининговые услуги или сантехника. У этих предприятий нет физического адреса или местоположения на Google Maps. Places не будут возвращать поля, включая location , plus_code и другие поля, связанные с местоположением для этих предприятий.

МестоположениеПредвзятость

Регион для поиска. Результаты могут быть смещены относительно указанного региона.

Поля

type поля «Союз».

type может быть только одним из следующих:

rectangle

Viewport

Область обзора, определяемая северо-восточным и юго-западным углами.

circle

Circle

Окружность, определяемая центральной точкой и радиусом.

МестоположениеОграничение

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

Поля

type поля «Союз».

type может быть только одним из следующих:

rectangle

Viewport

Область обзора, определяемая северо-восточным и юго-западным углами.

circle

Circle

Окружность, определяемая центральной точкой и радиусом.

АвтозаполнениеМестаОтвет

Прототип ответа для AutocompletePlaces.

Поля
suggestions[]

Suggestion

Содержит список предложений, отсортированных в порядке убывания релевантности.

Предположение

Результат предложения автозаполнения.

Поля

Союзный полевой kind .

kind может быть только одним из следующих:

place_prediction

PlacePrediction

Предсказание для Места.

query_prediction

QueryPrediction

Прогноз для запроса.

ФорматируемыйТекст

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

Поля
text

string

Текст, который можно использовать как есть или отформатировать с помощью matches .

matches[]

StringRange

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

Эти значения являются смещениями символов Unicode text . Диапазоны гарантированно упорядочены по возрастанию значений смещения.

МестоПрогноз

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

Поля
place

string

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

place_id

string

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

text

FormattableText

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

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

Этот текст может отличаться от display_name , возвращаемого GetPlace.

Может быть на смешанных языках, если input данные запроса и language_code указаны на разных языках или если у места нет перевода с местного языка на language_code .

structured_format

StructuredFormat

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

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

types[]

string

Список типов, которые применяются к этому месту из таблицы A или таблицы B в https://developers.google.com/maps/documentation/places/web-service/place-types .

Тип — это категоризация Места. Места с общими типами будут иметь схожие характеристики.

distance_meters

int32

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

ЗапросПрогнозирование

Результаты прогнозирования для прогноза автозаполнения запроса.

Поля
text

FormattableText

Предсказанный текст. Этот текст не представляет место, а скорее текстовый запрос, который может быть использован в конечной точке поиска (например, текстовый поиск).

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

Могут быть на смешанных языках, если input данные запроса и language_code указаны на разных языках или если часть запроса не имеет перевода с локального языка на language_code .

structured_format

StructuredFormat

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

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

ДиапазонСтрок

Определяет подстроку в заданном тексте.

Поля
start_offset

int32

Смещение от нуля первого символа Unicode в строке (включительно).

end_offset

int32

Смещение от нуля последнего символа Unicode (исключая его).

СтруктурированныйФормат

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

Для прогнозов Place основной текст содержит конкретное название Place. Для прогнозов query основной текст содержит запрос.

Вторичный текст содержит дополнительные неоднозначные признаки (например, город или регион) для дальнейшей идентификации места или уточнения запроса.

Поля
main_text

FormattableText

Представляет название места или запроса.

secondary_text

FormattableText

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

Круг

Окружность с центром в координатах LatLng и радиусом.

Поля
center

LatLng

Обязательно. Центральная широта и долгота.

Диапазон широты должен быть в пределах [-90.0, 90.0]. Диапазон долготы должен быть в пределах [-180.0, 180.0].

radius

double

Обязательно. Радиус измеряется в метрах. Радиус должен быть в пределах [0.0, 50000.0].

ContentBlock

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

Поля
content

LocalizedText

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

referenced_places[]

string

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

КонтекстныйКонтент

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

Контент, соответствующий контексту запроса места.

Поля
reviews[]

Review

Список отзывов об этом месте, соответствующих запросу места.

photos[]

Photo

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

justifications[]

Justification

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

Обоснования места.

Оправдание

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

Обоснования места. Обоснования отвечают на вопрос, почему место может заинтересовать конечного пользователя.

Поля

justification поля Союза.

justification может быть только одно из следующих:

review_justification

ReviewJustification

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

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

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

БизнесДоступностьАтрибутыОбоснование

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

Поля
takeout

bool

Если в заведении можно заказать еду на вынос.

delivery

bool

Если место предоставляет доставку.

dine_in

bool

Если в заведении есть возможность пообедать.

ОбзорОбоснование

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

Обоснования отзывов пользователей. Это выделяет раздел отзывов пользователей, который будет интересен конечному пользователю. Например, если поисковый запрос — «пицца на дровах», обоснование отзывов выделяет текст, релевантный поисковому запросу.

Поля
highlighted_text

HighlightedText

review

Review

Обзор, на основе которого создан выделенный текст.

Выделенный текст

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

Поля
text

string

highlighted_text_ranges[]

HighlightedTextRange

Список диапазонов выделенного текста.

ВыделенныйТекстДиапазон

Диапазон выделенного текста.

Поля
start_index

int32

end_index

int32

EVChargeOptions

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

Поля
connector_count

int32

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

connector_aggregation[]

ConnectorAggregation

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

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

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

Поля
type

EVConnectorType

Тип коннектора данной агрегации.

max_charge_rate_kw

double

Максимальная мощность статической зарядки в кВт для каждого разъема в агрегации.

count

int32

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

availability_last_update_time

Timestamp

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

available_count

int32

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

out_of_service_count

int32

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

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. Разъем Type-1 J-1772
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.

FuelOptions

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

Поля
fuel_prices[]

FuelPrice

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

Цена топлива

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

Поля
type

FuelType

Тип топлива.

price

Money

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

update_time

Timestamp

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

Тип топлива

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

Перечисления
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 Грузовой дизель.

GetPhotoMediaRequest

Запрос на получение фотографии места с использованием имени фоторесурса.

Поля
name

string

Обязательно. Имя ресурса фотоносителя в формате: places/{place_id}/photos/{photo_reference}/media .

Имя ресурса фотографии, возвращаемое в поле photos.name объекта Place, имеет формат places/{place_id}/photos/{photo_reference} . Вам необходимо добавить /media в конец ресурса фотографии, чтобы получить имя ресурса медиафайла фотографии.

max_width_px

int32

Необязательно. Указывает максимальную желаемую ширину изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше в любом из измерений, оно будет масштабировано для соответствия меньшему из двух измерений, ограниченному исходным соотношением сторон. Оба свойства max_height_px и max_width_px принимают целое число от 1 до 4800 включительно. Если значение не находится в допустимом диапазоне, будет возвращена ошибка INVALID_ARGUMENT.

Необходимо указать хотя бы один из параметров max_height_px или max_width_px. Если не указано ни max_height_px, ни max_width_px, будет возвращена ошибка INVALID_ARGUMENT.

max_height_px

int32

Необязательно. Указывает максимальную желаемую высоту изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше в любом из измерений, оно будет масштабировано для соответствия меньшему из двух измерений, ограниченному исходным соотношением сторон. Оба свойства max_height_px и max_width_px принимают целое число от 1 до 4800 включительно. Если значение не находится в допустимом диапазоне, будет возвращена ошибка INVALID_ARGUMENT.

Необходимо указать хотя бы один из параметров max_height_px или max_width_px. Если не указано ни max_height_px, ни max_width_px, будет возвращена ошибка INVALID_ARGUMENT.

skip_http_redirect

bool

Необязательно. Если установлено, пропустите поведение перенаправления HTTP по умолчанию и отобразите ответ в текстовом формате (например, в формате JSON для варианта использования HTTP). Если не установлено, будет выполнено перенаправление HTTP для перенаправления вызова на носитель изображения. Этот параметр игнорируется для не-HTTP-запросов.

GetPlaceRequest

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

Поля
name

string

Обязательно. Имя ресурса места в формате places/{place_id} .

language_code

string

Необязательно. Информация о месте будет отображаться на предпочитаемом языке, если он доступен.

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

region_code

string

Необязательно. Код страны/региона Unicode (CLDR) местоположения, откуда поступает запрос. Этот параметр используется для отображения сведений о месте, например, названия места, специфичного для региона, если оно доступно. Параметр может влиять на результаты в зависимости от применимого законодательства. Для получения дополнительной информации см. https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

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

session_token

string

Необязательно. Строка, которая идентифицирует сеанс автозаполнения для выставления счетов. Должна быть безопасной строкой base64 URL и имени файла длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT.

Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место и выполняется вызов Place Details или Address Validation. Каждый сеанс может иметь несколько запросов, за которыми следует один запрос Place Details или Address Validation. Учетные данные, используемые для каждого запроса в сеансе, должны принадлежать одному проекту Google Cloud Console. После завершения сеанса токен больше недействителен; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр session_token пропущен или если вы повторно используете токен сеанса, сеанс тарифицируется так, как если бы токен сеанса не был предоставлен (каждый запрос тарифицируется отдельно).

Мы рекомендуем следующие рекомендации:

  • Используйте токены сеанса для всех вызовов Place Autocomplete.
  • Генерируйте новый токен для каждой сессии. Рекомендуется использовать UUID версии 4.
  • Убедитесь, что учетные данные, используемые для всех запросов Place Autocomplete, Place Details и Address Validation в рамках сеанса, принадлежат одному и тому же проекту Cloud Console.
  • Обязательно передайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для более чем одного сеанса приведет к тому, что каждый запрос будет выставлен по отдельности.

Фото

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

Поля
name

string

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

width_px

int32

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

height_px

int32

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

author_attributions[]

AuthorAttribution

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

flag_content_uri

string

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

google_maps_uri

string

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

ФотоМедиа

Фотоматериалы из API Places.

Поля
name

string

Имя ресурса фотоносителя в формате: places/{place_id}/photos/{photo_reference}/media .

photo_uri

string

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

Место

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

Поля
name

string

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

id

string

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

display_name

LocalizedText

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

types[]

string

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

primary_type

string

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

primary_type_display_name

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

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

postal_address

PostalAddress

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

address_components[]

AddressComponent

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

plus_code

PlusCode

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

location

LatLng

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

viewport

Viewport

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

rating

double

Рейтинг от 1,0 до 5,0, основанный на отзывах пользователей об этом месте.

google_maps_uri

string

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

website_uri

string

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

reviews[]

Review

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

regular_opening_hours

OpeningHours

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

time_zone

TimeZone

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

photos[]

Photo

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

adr_format_address

string

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

business_status

BusinessStatus

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

price_level

PriceLevel

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

attributions[]

Attribution

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

icon_mask_base_uri

string

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

icon_background_color

string

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

current_opening_hours

OpeningHours

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

current_secondary_opening_hours[]

OpeningHours

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

regular_secondary_opening_hours[]

OpeningHours

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

editorial_summary

LocalizedText

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

payment_options

PaymentOptions

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

parking_options

ParkingOptions

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

sub_destinations[]

SubDestination

Список субсинаций, связанных с местом.

fuel_options

FuelOptions

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

ev_charge_options

EVChargeOptions

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

generative_summary

GenerativeSummary

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

containing_places[]

ContainingPlace

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

address_descriptor

AddressDescriptor

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

price_range

PriceRange

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

review_summary

ReviewSummary

АИ-сгенерированная сводка места с использованием обзоров пользователей.

ev_charge_amenity_summary

EvChargeAmenitySummary

Краткое изложение удобств возле зарядной станции EV.

neighborhood_summary

NeighborhoodSummary

Краткое изложение интересующих точек возле места.

utc_offset_minutes

int32

Количество минут часового пояса этого места в настоящее время смещено от UTC. Это выражается в считанные минуты, чтобы поддержать часовые пояса, которые компенсируются фракциями часа, например, x часов и 15 минут.

user_rating_count

int32

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

takeout

bool

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

delivery

bool

Определяет, поддерживает ли бизнес поставку.

dine_in

bool

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

curbside_pickup

bool

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

reservable

bool

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

serves_breakfast

bool

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

serves_lunch

bool

Указывает, обслуживает ли место обед.

serves_dinner

bool

Определяет, подает ли место ужин.

serves_beer

bool

Определяет, обслуживает ли место пиво.

serves_wine

bool

Указывает, обслуживает ли место вино.

serves_brunch

bool

Указывает, обслуживает ли место бранч.

serves_vegetarian_food

bool

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

outdoor_seating

bool

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

live_music

bool

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

menu_for_children

bool

У места есть детское меню.

serves_cocktails

bool

Место обслуживает коктейли.

serves_dessert

bool

Место обслуживает десерт.

serves_coffee

bool

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

good_for_children

bool

Место полезно для детей.

allows_dogs

bool

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

restroom

bool

У места есть туалет.

good_for_groups

bool

Место разместит группы.

good_for_watching_sports

bool

Место подходит для просмотра спорта.

accessibility_options

AccessibilityOptions

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

pure_service_area_business

bool

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

Доступность

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

Поля
wheelchair_accessible_parking

bool

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

wheelchair_accessible_entrance

bool

У мест есть вход в инвалидную коляску.

wheelchair_accessible_restroom

bool

У места есть уборная для инвалидной коляски.

wheelchair_accessible_seating

bool

У места есть места для инвалидной коляски.

AddressComponent

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

Поля
long_text

string

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

short_text

string

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

types[]

string

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

language_code

string

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

Атрибуция

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

Поля
provider

string

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

provider_uri

string

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

BusinessStatus

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

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

Содержащий место

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

Поля
name

string

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

id

string

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

Evargeamenitysummary

Краткое изложение удобств возле зарядной станции EV. Это относится только к местам с типом electric_vehicle_charging_station . Поле overview гарантированно будет предоставлено, в то время как другие поля являются необязательными.

Поля
overview

ContentBlock

Обзор доступных удобств. Это гарантированно будет предоставлено.

coffee

ContentBlock

Краткое изложение ближайших вариантов кофе.

restaurant

ContentBlock

Краткое изложение близлежащих ресторанов.

store

ContentBlock

Краткое изложение близлежащих заправочных станций.

flag_content_uri

string

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

disclosure_text

LocalizedText

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

Генеративы

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

Поля
overview

LocalizedText

Обзор места.

overview_flag_content_uri

string

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

disclosure_text

LocalizedText

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

Соседство

Краткое изложение интересующих точек возле места.

Поля
overview

ContentBlock

Обзор резюме района.

description

ContentBlock

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

flag_content_uri

string

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

disclosure_text

LocalizedText

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

Часы работы

Информация о деловом часе этого места.

Поля
periods[]

Period

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

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

ПРИМЕЧАНИЕ. Заказ массива periods не зависит от заказа массива weekday_descriptions . Не думайте, что они начнутся в тот же день.

weekday_descriptions[]

string

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

Примечание. Порядок дней и начало недели определяется локали (язык и регион). Заказ массива periods не зависит от упорядочения массива weekday_descriptions . Не думайте, что они начнутся в тот же день.

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

secondary_hours_type

SecondaryHoursType

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

special_days[]

SpecialDay

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

next_open_time

Timestamp

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

next_close_time

Timestamp

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

open_now

bool

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

Период

Период. Место остается в статусе open_now.

Поля
open

Point

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

close

Point

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

Точка

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

Поля
date

Date

Дата в местном часовом поясе для этого места.

truncated

bool

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

day

int32

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

hour

int32

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

minute

int32

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

Второстепенный

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

Перечисления
SECONDARY_HOURS_TYPE_UNSPECIFIED Значение по умолчанию, когда тип второго часа не указан.
DRIVE_THROUGH Проводной час для банков, ресторанов или аптек.
HAPPY_HOUR Счастливого часа.
DELIVERY Час доставки.
TAKEOUT ВЫБУЩАЮЩИЙ час.
KITCHEN Кухонный час.
BREAKFAST Завтрак час.
LUNCH Обеденный час.
DINNER Час ужина.
BRUNCH Бранч час.
PICKUP Час пикапа.
ACCESS Часы доступа для мест хранения.
SENIOR_HOURS Особые часы для пожилых людей.
ONLINE_SERVICE_HOURS Часы онлайн -сервиса.

Specialday

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

Поля
date

Date

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

Паркооп

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

Поля
free_parking_lot

bool

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

paid_parking_lot

bool

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

free_street_parking

bool

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

paid_street_parking

bool

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

valet_parking

bool

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

free_garage_parking

bool

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

paid_garage_parking

bool

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

Платежоп

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

Поля
accepts_credit_cards

bool

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

accepts_debit_cards

bool

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

accepts_cash_only

bool

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

accepts_nfc

bool

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

PlusCode

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

Поля
global_code

string

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

compound_code

string

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

ОБЗОР

АИ-сгенерированная сводка места с использованием обзоров пользователей.

Поля
text

LocalizedText

Сводка обзоров пользователей.

flag_content_uri

string

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

disclosure_text

LocalizedText

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

reviews_uri

string

Ссылка, чтобы показать обзоры этого места на Google Maps.

Субседление

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

Поля
name

string

Название ресурса суб-назначения.

id

string

Место идентификатор суб-назначения.

Полилиния

Маршрут полилиния. Только поддерживает кодируемую полилину , которая может быть передана в виде строки и включает сжатие с минимальной потерей. Это выходной выход API по умолчанию.

Поля
Полевое поле polyline_type . Инкапсулирует тип полилинии. Маршруты API вывод по умолчанию в encoded_polyline . polyline_type может быть только одним из следующих:
encoded_polyline

string

Кодируемая полилина , как по умолчанию возвращается API Routes . Смотрите инструменты Encoder и Decoder .

Прирлевель

Уровень цены.

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

Диапазон цен

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

Поля
start_price

Money

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

end_price

Money

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

Обзор

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

Поля
name

string

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

relative_publish_time_description

string

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

text

LocalizedText

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

original_text

LocalizedText

Текст обзора на своем исходном языке.

rating

double

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

author_attribution

AuthorAttribution

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

publish_time

Timestamp

Временная метка для обзора.

flag_content_uri

string

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

google_maps_uri

string

Ссылка, чтобы показать обзор на картах Google.

Рукодификаторы

Инкапсулирует набор дополнительных условий для удовлетворения при расчете маршрутов.

Поля
avoid_tolls

bool

Необязательный. Когда они устанавливаются на True, избегает платных дорог, где разумно, отдавая предпочтение маршрутам, не содержащим платные дороги. Применяется только к DRIVE и TWO_WHEELER TravelMode .

avoid_highways

bool

Необязательный. Когда установлено в True, избегает автомагистралей, где разумные, предпочитая маршруты, не содержащие автомагистрали. Применяется только к DRIVE и TWO_WHEELER TravelMode .

avoid_ferries

bool

Необязательный. При установлении к True избегает паромов, где разумные, предпочитая маршруты, не содержащие паромы. Применяется только к DRIVE и TWO_WHEELER TravelMode .

avoid_indoor

bool

Необязательный. При установлении к True избегает навигации в помещении, где разумно, отдавая предпочтение маршрутам, не содержащим внутренней навигации. Применяется только к WALK TravelMode .

RoutingParameters

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

Поля
origin

LatLng

Необязательный. Явное происхождение маршрутизации, которое переопределяет происхождение, определенное в полилинии. По умолчанию используется происхождение полилин.

travel_mode

TravelMode

Необязательный. Режим путешествий.

route_modifiers

RouteModifiers

Необязательный. Модификаторы маршрута.

routing_preference

RoutingPreference

Необязательный. Указывает, как вычислить резюме маршрутизации. Сервер пытается использовать выбранное предпочтение маршрутизации для вычисления маршрута. Предпочтение маршрутизации, осведомленного о трафике, доступно только для DRIVE или TWO_WHEELER travelMode .

RoutingPreference

Набор значений, которые указывают факторы, которые следует учитывать при расчете маршрута.

Перечисления
ROUTING_PREFERENCE_UNSPECIFIED Не указано предпочтение маршрутизации. По умолчанию в TRAFFIC_UNAWARE .
TRAFFIC_UNAWARE Вычисляет маршруты, не принимая во внимание условия движения в прямом эфире. Подходит, когда условия движения не имеют значения или не применимы. Использование этого значения дает самую низкую задержку. Примечание. Для TravelMode DRIVE и TWO_WHEELER выбранные маршруты и продолжительность основаны на дорожной сети и средних условиях дорожного движения, а не на нынешних дорожных условиях. Следовательно, маршруты могут включать дороги, которые временно закрыты. Результаты для данного запроса могут варьироваться со временем из -за изменений в дорожной сети, обновленных средних условий движения и распределенного характера услуги. Результаты также могут варьироваться между почти эквивалентными маршрутами в любое время или частоту.
TRAFFIC_AWARE Рассчитывает маршруты, принимая во внимание условия движения в прямом эфире. В отличие от TRAFFIC_AWARE_OPTIMAL , некоторые оптимизации применяются для значительного сокращения задержки.
TRAFFIC_AWARE_OPTIMAL Рассчитывает маршруты, принимая во внимание условия движения в прямом эфире, не применяя большинство оптимизаций производительности. Использование этого значения дает самую высокую задержку.

Расточительные маршруты

Продолжительность и расстояние от происхождения маршрутизации до места в ответе, и второй этап от этого места до пункта назначения, если их запрошен. ПРИМЕЧАНИЕ. Добавление routingSummaries в полевой маски без включения либо параметра routingParameters.origin , либо параметр searchAlongRouteParameters.polyline.encodedPolyline в запросе вызывает ошибку.

Поля
legs[]

Leg

Ноги поездки.

Когда вы рассчитываете продолжительность движения и расстояние от установленного происхождения, legs содержит одну ногу, содержащую продолжительность и расстояние от начала до места назначения. Когда вы выполняете поиск по маршруту, legs содержит две ножки: одна от начала места до места, а одна от места до места назначения.

directions_uri

string

Ссылка, чтобы показать указания на картах Google, используя путевые точки из данной резюме маршрутизации. Маршрут, сгенерированный этой ссылкой, не гарантированно будет таким же, как маршрут, используемый для генерации резюме маршрутизации. Ссылка использует информацию, представленную в запросе, из полей, включая routingParameters и searchAlongRouteParameters , когда это применимо, для создания ссылки направления.

Нога

Нога - это единственная часть путешествия из одного места в другое.

Поля
duration

Duration

Время, необходимое для завершения этой ноги поездки.

distance_meters

int32

Расстояние этой ноги поездки.

SearchNearByRequest

Запросить прото для поиска поблизости.

Поля
language_code

string

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

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

region_code

string

Университетский код страны/региона (CLDR) места, откуда поступает запрос. Этот параметр используется для отображения деталей места, таких как имя места, если доступно. Параметр может повлиять на результаты на основе применимого закона.

Для получения дополнительной информации см. Https://www.unicode.org/cldr/charts/latest/suplemental/territory_language_information.html .

Обратите внимание, что 3-значные регион кодов в настоящее время не поддерживаются.

included_types[]

string

Включен тип места (например, «ресторан» или «Gas_station») от https://developers.google.com/maps/documentation/places/web-service/place-types .

До 50 типов из таблицы A может быть указано.

Если есть какие -либо противоречивые типы, т.е. тип появляется в обоих inclod_types, так и excuded_types, возвращается ошибка Invalid_argument.

Если тип места указывается с ограничениями с несколькими типами, только места, которые удовлетворяют все ограничения, возвращаются. Например, если у нас есть {include_types = ["restaurant"], excuded_primary_types = ["restaurant"]}, возвращенные места предоставляют «ресторан», но не работают в основном как «рестораны».

excluded_types[]

string

Исключенный тип места (например, «ресторан» или «Gas_station») из https://developers.google.com/maps/documentation/places/web-service/place-types .

До 50 типов из таблицы A может быть указано.

Если клиент предоставляет как incluct_types (например, ресторан), так и excuded_types (например, кафе), то ответ должен включать места, которые являются рестораном, но не кафе. Ответ включает в себя места, которые соответствуют хотя бы одним из включенных_типов, и ни один из исключенных_типов.

Если есть какие -либо противоречивые типы, т.е. тип появляется в обоих inclod_types, так и excuded_types, возвращается ошибка Invalid_argument.

Если тип места указывается с ограничениями с несколькими типами, только места, которые удовлетворяют все ограничения, возвращаются. Например, если у нас есть {include_types = ["restaurant"], excuded_primary_types = ["restaurant"]}, возвращенные места предоставляют «ресторан», но не работают в основном как «рестораны».

included_primary_types[]

string

Включен тип первичного места (например, «ресторан» или «Gas_station») от https://developers.google.com/maps/documentation/places/web-service/place-types . Место может иметь только один первичный тип из таблицы поддерживаемых типов, связанных с ним.

До 50 типов из таблицы A может быть указано.

Если есть какие -либо противоречивые первичные типы, то есть тип появляется как в incocatal_primary_types, так и excuded_primary_types, возвращается ошибка valud_argument.

Если тип места указывается с ограничениями с несколькими типами, только места, которые удовлетворяют все ограничения, возвращаются. Например, если у нас есть {include_types = ["restaurant"], excuded_primary_types = ["restaurant"]}, возвращенные места предоставляют «ресторан», но не работают в основном как «рестораны».

excluded_primary_types[]

string

Исключен тип первичного места (например, «ресторан» или «Gas_station») из https://developers.google.com/maps/documentation/places/web-service/place-types .

До 50 типов из таблицы A может быть указано.

Если есть какие -либо противоречивые первичные типы, то есть тип появляется как в incocatal_primary_types, так и excuded_primary_types, возвращается ошибка valud_argument.

Если тип места указывается с ограничениями с несколькими типами, только места, которые удовлетворяют все ограничения, возвращаются. Например, если у нас есть {include_types = ["restaurant"], excuded_primary_types = ["restaurant"]}, возвращенные места предоставляют «ресторан», но не работают в основном как «рестораны».

max_result_count

int32

Максимальное количество результатов для возврата. Это должно быть от 1 до 20 (по умолчанию) включено. Если число не установлено, оно возвращается к верхнему пределу. Если число установлено на отрицательный или превышающий верхний предел, возвращается ошибка vangiad_argument.

location_restriction

LocationRestriction

Требуется Регион для поиска.

rank_preference

RankPreference

Как результаты будут ранжированы в ответ.

routing_parameters

RoutingParameters

Необязательный. Параметры, которые влияют на маршрутизацию до результатов поиска.

Местоположение

Регион для поиска.

Поля

type поля Союза.

type может быть только одним из следующих:

circle

Circle

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

RankPreference

Как результаты будут ранжированы в ответ.

Перечисления
RANK_PREFERENCE_UNSPECIFIED Значение RankPreference не установлено. Будет использовать ранг по популярности по умолчанию.
DISTANCE Результаты результатов по расстоянию.
POPULARITY Результаты по популярности.

SearchNearByResponse

Ответ Прото на поиск поблизости.

Поля
places[]

Place

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

routing_summaries[]

RoutingSummary

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

Searchtextrequest

Запросить прото для SearchText.

Поля
text_query

string

Требуется Текстовый запрос для текстового поиска.

language_code

string

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

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

region_code

string

Университетский код страны/региона (CLDR) места, откуда поступает запрос. Этот параметр используется для отображения деталей места, таких как имя места, если доступно. Параметр может повлиять на результаты на основе применимого закона.

Для получения дополнительной информации см. Https://www.unicode.org/cldr/charts/latest/suplemental/territory_language_information.html .

Обратите внимание, что 3-значные регион кодов в настоящее время не поддерживаются.

rank_preference

RankPreference

Как результаты будут ранжированы в ответ.

included_type

string

Запрашиваемый тип места. Полный список типов поддерживается: https://developers.google.com/maps/documentation/places/web-service/place-itypes . Поддержите только один включен тип.

open_now

bool

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

min_rating

double

Отфильтруйте результаты, средний рейтинг пользователей, строго меньше, чем этот предел. Допустимое значение должно быть поплавком от 0 до 5 (включено) в 0,5 CADENCE IE [0, 0,5, 1,0, ..., 5,0] включительно. Входной рейтинг будет окружить до ближайшего 0,5 (потолок). Например, рейтинг 0,6 устранит все результаты с рейтингом менее 1,0.

max_result_count
(deprecated)

int32

Установите: используйте page_size вместо этого.

Максимальное количество результатов на страницу, которые могут быть возвращены. Если количество доступных результатов больше, чем max_result_count , возвращается next_page_token , которая может быть передана в page_token , чтобы получить следующую страницу результатов в последующих запросах. Если значение 0 или отсутствие значения, используется дефолт 20. Максимальное значение составляет 20; Значения выше 20 будут принуждены к 20. Отрицательные значения вернут ошибку Invalid_argument.

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

page_size

int32

Необязательный. Максимальное количество результатов на страницу, которые могут быть возвращены. Если количество доступных результатов больше, чем page_size , возвращается next_page_token , которая может быть передана в page_token , чтобы получить следующую страницу результатов в последующих запросах. Если значение 0 или отсутствие значения, используется дефолт 20. Максимальное значение составляет 20; Значения выше 20 будут установлены на 20. Отрицательные значения вернут ошибку Invalid_argument.

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

page_token

string

Необязательный. Токен страницы, полученный от предыдущего вызова текстового исследования. Предоставьте это, чтобы получить последующую страницу.

При страничном языке все параметры, отличные от page_token , page_size и max_result_count , предоставленные TextSearch, должны соответствовать первоначальному вызову, который предоставил токен страницы. В противном случае возвращается ошибка valud_argument.

price_levels[]

PriceLevel

Используется для ограничения поиска местами, которые отмечены как определенные цены. Пользователи могут выбрать любые комбинации уровней цен. По умолчанию выбрать все уровни цен.

strict_type_filtering

bool

Используется для установки фильтрации строгого типа для incocated_type. Если установить в True, будут возвращены только результаты того же типа. По умолчанию в False.

location_bias

LocationBias

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

location_restriction

LocationRestriction

Регион для поиска. Это место служит ограничением, которое означает, что результаты вне данного местоположения не будут возвращены. Не может быть установлен вместе с location_bias.

ev_options

EVOptions

Необязательный. Установите параметры EV для поиска в запросе поиска места.

routing_parameters

RoutingParameters

Необязательный. Дополнительные параметры для маршрутизации до результатов.

search_along_route_parameters

SearchAlongRouteParameters

Необязательный. Дополнительные параметры прото для поиска по маршруту.

include_pure_service_area_businesses

bool

Необязательный. Включите чистые предприятия в области обслуживания, если поле установлено на True. Pure Service Area Business - это бизнес, который посещает или передает клиентам напрямую, но не обслуживает клиентов по своему бизнесу. Например, предприятия, такие как уборные услуги или сантехники. У этих предприятий нет физического адреса или местоположения на картах Google. Места не будут возвращать поля, включая location , plus_code и другие поля, связанные с местоположением для этих предприятий.

Эвопции

Параметры EV для поиска запроса поиска места.

Поля
minimum_charging_rate_kw

double

Необязательный. Минимальная требуемая ставка зарядки в киловатте. Место со скоростью зарядки меньше указанной ставки отфильтровано.

connector_types[]

EVConnectorType

Необязательный. Список предпочтительных типов разъемов EV. Место, которое не поддерживает ни один из перечисленных типов разъемов, отфильтровано.

Местоположение

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

Поля

type поля Союза.

type может быть только одним из следующих:

rectangle

Viewport

Прямоугольная коробка, определенная северо -восточным и юго -западным углом. rectangle.high() должен быть северо -восточной точкой прямоугольного просмотра. rectangle.low() должен быть юго -западной точкой прямоугольного просмотра. rectangle.low().latitude() не может быть больше, чем rectangle.high().latitude() . Это приведет к пустому диапазону широты. Прямого просмотра не может быть шире, чем 180 градусов.

circle

Circle

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

Местоположение

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

Поля

type поля Союза.

type может быть только одним из следующих:

rectangle

Viewport

Прямоугольная коробка, определенная северо -восточным и юго -западным углом. rectangle.high() должен быть северо -восточной точкой прямоугольного просмотра. rectangle.low() должен быть юго -западной точкой прямоугольного просмотра. rectangle.low().latitude() не может быть больше, чем rectangle.high().latitude() . Это приведет к пустому диапазону широты. Прямого просмотра не может быть шире, чем 180 градусов.

RankPreference

Как результаты будут ранжированы в ответ.

Перечисления
RANK_PREFERENCE_UNSPECIFIED Для категорического запроса, такого как «рестораны в Нью -Йорке», актуальность является дефолтом. Для некатегоричных запросов, таких как «Mountain View, CA», мы рекомендуем вам оставить RankPreference Unset.
DISTANCE Результаты результатов по расстоянию.
RELEVANCE Результаты результатов по актуальности. Порядок сортировки определяется нормальным рейтингом.

SSISCALONGROUTEPARAMETERS

Определяет предварительную полицию из API маршрутов, определяющих маршрут для поиска. Поиск по маршруту аналогична использованию опции locationBias или locationRestriction для смещения результатов поиска. Однако, хотя параметры locationBias и locationRestriction позволяют указать область для смещения результатов поиска, эта опция позволяет вам сметить результаты вдоль маршрута поездки.

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

Поля
polyline

Polyline

Требуется Маршрут полилиний.

SearchTexTresponse

Ответ Proto для SearchText.

Поля
places[]

Place

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

routing_summaries[]

RoutingSummary

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

contextual_contents[]

ContextualContent

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

Список контекстуального содержимого, где каждая запись ассоциируется с соответствующим местом в том же индексе в поле «Места». Содержание, которое имеет отношение к text_query в запросе, предпочтительнее. Если контекстный контент не доступен для одного из мест, он вернет неконтексу. Это будет пусто только тогда, когда контент недоступен для этого места. Этот список будет иметь столько же записей, сколько в списке мест, если их запрошен.

next_page_token

string

Токен, который можно отправить как page_token , чтобы получить следующую страницу. Если это поле опущено или пустое, нет последующих страниц.

search_uri

string

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

Режим путешествия

Параметры режима путешествия. Эти параметры отображают, какие маршруты предлагает API .

Перечисления
TRAVEL_MODE_UNSPECIFIED Режим путешествия не указан. По умолчанию DRIVE .
DRIVE Путешествие на пассажирском автомобиле.
BICYCLE Путешествие по велосипеде. Не поддерживается с помощью search_along_route_parameters .
WALK Путешествовать, ходя. Не поддерживается с помощью search_along_route_parameters .
TWO_WHEELER Моторизованные двухколесные транспортные средства всех видов, такие как скутеры и мотоциклы. Обратите внимание, что это отличается от режима путешествия BICYCLE , который охватывает транспорт с человеческим путем. Не поддерживается с помощью search_along_route_parameters . Поддерживается только в тех странах, перечисленных в странах и регионах, поддерживаемых для двухколесных транспортных средств .