Package google.maps.places.v1

Индекс

• Places (интерфейс)
• AuthorAttribution (сообщение)
• AutocompletePlacesRequest (сообщение)
• AutocompletePlacesRequest.LocationBias (сообщение)
• AutocompletePlacesRequest.LocationRestriction (сообщение)
• AutocompletePlacesResponse (сообщение)
• AutocompletePlacesResponse.Suggestion (сообщение)
• AutocompletePlacesResponse.Suggestion.FormattableText (сообщение)
• AutocompletePlacesResponse.Suggestion.PlacePrediction (сообщение)
• AutocompletePlacesResponse.Suggestion.QueryPrediction (сообщение)
• AutocompletePlacesResponse.Suggestion.StringRange (сообщение)
• AutocompletePlacesResponse.Suggestion.StructuredFormat (сообщение)
• Circle (сообщение)
• ContentBlock (сообщение)
• ContextualContent (сообщение)
• ContextualContent.Justification (сообщение)
• ContextualContent.Justification.BusinessAvailabilityAttributesJustification (сообщение)
• ContextualContent.Justification.ReviewJustification (сообщение)
• ContextualContent.Justification.ReviewJustification.HighlightedText (сообщение)
• ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange (сообщение)
• EVChargeOptions (сообщение)
• EVChargeOptions.ConnectorAggregation (сообщение)
• EVConnectorType (перечисление)
• FuelOptions (сообщение)
• FuelOptions.FuelPrice (сообщение)
• FuelOptions.FuelPrice.FuelType (перечисление)
• GetPhotoMediaRequest (сообщение)
• GetPlaceRequest (сообщение)
• Photo (сообщение)
• PhotoMedia (сообщение)
• Place (сообщение)
• Place.AccessibilityOptions (сообщение)
• Place.AddressComponent (сообщение)
• Place.AreaSummary (сообщение)
• Place.Attribution (сообщение)
• Place.BusinessStatus (перечисление)
• Place.GenerativeSummary (сообщение)
• Place.OpeningHours (сообщение)
• Place.OpeningHours.Period (сообщение)
• Place.OpeningHours.Period.Point (сообщение)
• Place.OpeningHours.SecondaryHoursType (перечисление)
• Place.OpeningHours.SpecialDay (сообщение)
• Place.ParkingOptions (сообщение)
• Place.PaymentOptions (сообщение)
• Place.PlusCode (сообщение)
• Place.SubDestination (сообщение)
• PriceLevel (перечисление)
• References (сообщение)
• Review (сообщение)
• SearchNearbyRequest (сообщение)
• SearchNearbyRequest.LocationRestriction (сообщение)
• SearchNearbyRequest.RankPreference (перечисление)
• SearchNearbyResponse (сообщение)
• SearchTextRequest (сообщение)
• SearchTextRequest.EVOptions (сообщение)
• SearchTextRequest.LocationBias (сообщение)
• SearchTextRequest.LocationRestriction (сообщение)
• SearchTextRequest.RankPreference (перечисление)
• SearchTextResponse (сообщение)

Места

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

Автозаполнение мест
rpc AutocompletePlaces( AutocompletePlacesRequest ) returns ( AutocompletePlacesResponse ) Возвращает прогнозы для заданных входных данных.

GetPhotoMedia
rpc GetPhotoMedia( GetPhotoMediaRequest ) returns ( PhotoMedia ) Получите носитель фотографии со строкой ссылки на фотографию.

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

ПоискРядом
rpc SearchNearby( SearchNearbyRequest ) returns ( SearchNearbyResponse ) Поиск мест рядом с локациями.

Поиск текста
rpc SearchText( SearchTextRequest ) returns ( SearchTextResponse ) Поиск места на основе текстового запроса.

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

Информация об авторе пользовательских данных. Используется в 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 Необязательный. Включен основной тип места (например, «ресторан» или «заправочная станция») из таблицы A или таблицы B в типах мест ( https://developers.google.com/maps/documentation/places/web-service/place-types). , или только (регионы), или только (города). Место возвращается только в том случае, если его основной тип включен в этот список. Можно указать до 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 Необязательный. Смещение символов Юникода для input отсчитываемое от нуля, указывающее позицию курсора во input . Положение курсора может влиять на то, какие прогнозы возвращаются. Если пусто, по умолчанию используется длина input .
include_query_predictions	bool Необязательный. Если это правда, ответ будет включать в себя как прогнозы места, так и запроса. В противном случае ответ вернет только прогнозы мест.
session_token	string Необязательный. Строка, которая идентифицирует сеанс автозаполнения для целей выставления счетов. Должна быть строкой в ​​формате Base64, безопасной для URL и имени файла, длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT. Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место и выполняет вызов функции Place Details или проверки адреса. В каждом сеансе может быть несколько запросов, за которыми следует один запрос на информацию о месте или проверку адреса. Учетные данные, используемые для каждого запроса в рамках сеанса, должны принадлежать одному и тому же проекту Google Cloud Console. После завершения сеанса токен больше не действителен; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр session_token опущен или вы повторно используете токен сеанса, сеанс взимается так, как если бы токен сеанса не был предоставлен (каждый запрос оплачивается отдельно). Мы рекомендуем следующие рекомендации: Используйте токены сеанса для всех вызовов Place Autocomplete. Генерируйте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4. Убедитесь, что учетные данные, используемые для всех запросов автозаполнения места, сведений о месте и проверки адреса в рамках сеанса, принадлежат одному и тому же проекту Cloud Console. Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для нескольких сеансов приведет к тому, что каждый запрос будет оплачиваться отдельно.

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

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

Поля
type поля объединения. type может быть только одним из следующих:
rectangle	Viewport Окно просмотра определяется северо-восточным и юго-западным углами.
circle	Circle Круг, определяемый центральной точкой и радиусом.

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

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

Поля
type поля объединения. type может быть только одним из следующих:
rectangle	Viewport Окно просмотра определяется северо-восточным и юго-западным углами.
circle	Circle Круг, определяемый центральной точкой и радиусом.

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

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

Поля
suggestions[]	Suggestion Содержит список предложений, упорядоченных по убыванию релевантности.

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

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

Поля
kind поля Союза. kind может быть только одним из следующих:
place_prediction	PlacePrediction Предсказание для места.
query_prediction	QueryPrediction Прогноз для запроса.

Форматтаблетекст

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

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

МестоПредсказание

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

Поля
place	string Имя ресурса предлагаемого места. Это имя можно использовать в других API, которые принимают названия мест.
place_id	string Уникальный идентификатор предлагаемого места. Этот идентификатор можно использовать в других API, которые принимают идентификаторы мест.
text	FormattableText Содержит удобочитаемое имя возвращаемого результата. Для результатов учреждения это обычно название компании и адрес. text рекомендуется разработчикам, которые хотят показать один элемент пользовательского интерфейса. Разработчики, которые хотят показать два отдельных, но связанных элемента пользовательского интерфейса, могут вместо этого использовать structured_format . Это два разных способа представления предсказания места. Пользователям не следует пытаться преобразовать 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 и наоборот.

StringRange

Идентифицирует подстроку в данном тексте.

Поля
start_offset	int32 Смещение первого символа Юникода строки (включительно), отсчитываемое от нуля.
end_offset	int32 Смещение последнего символа Юникода, отсчитываемое от нуля (исключающее).

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

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

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

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

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

Круг

Круг с LatLng в качестве центра и радиуса.

Поля
center	LatLng Необходимый. Центральная широта и долгота. Диапазон широты должен находиться в пределах [-90,0, 90,0]. Диапазон долготы должен находиться в пределах [-180,0, 180,0].
radius	double Необходимый. Радиус измеряется в метрах. Радиус должен находиться в пределах [0,0, 50000,0].

КонтентБлок

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

Поля
topic	string Тема контента, например «обзор» или «ресторан».
content	LocalizedText Содержимое, связанное с темой.
references	References Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative . Ссылки, относящиеся к данному блоку контента.

Контекстное содержание

Экспериментальный вариант: дополнительную информацию см. на странице 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

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

Поля
connector_count	int32 Количество разъемов на этой станции. Однако, поскольку некоторые порты могут иметь несколько разъемов, но одновременно могут заряжать только одну машину (например), количество разъемов может превышать общее количество автомобилей, которые могут заряжаться одновременно.
connector_aggregation[]	ConnectorAggregation Список совокупностей разъемов для зарядки электромобилей, которые содержат разъемы одного типа и с одинаковой скоростью зарядки.

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

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

Поля
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. Часто называют МЕННЕКЕС.
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	Неизвестная розетка.

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

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

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

ТопливоЦена

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

Поля
type	FuelType Тип топлива.
price	Money Цена топлива.
update_time	Timestamp Время последнего обновления цены на топливо.

Тип топлива

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

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

ПолучитьФотоМедиаЗапрос

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

Поля
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 или проверки адреса. В каждом сеансе может быть несколько запросов, за которыми следует один запрос на информацию о месте или проверку адреса. Учетные данные, используемые для каждого запроса в рамках сеанса, должны принадлежать одному и тому же проекту Google Cloud Console. После завершения сеанса токен больше не действителен; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр session_token опущен или если вы повторно используете токен сеанса, сеанс взимается так, как если бы токен сеанса не был предоставлен (каждый запрос оплачивается отдельно). Мы рекомендуем следующие рекомендации: Используйте токены сеанса для всех вызовов Place Autocomplete. Генерируйте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4. Убедитесь, что учетные данные, используемые для всех запросов автозаполнения места, сведений о месте и проверки адреса в рамках сеанса, принадлежат одному и тому же проекту Cloud Console. Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для нескольких сеансов приведет к тому, что каждый запрос будет оплачиваться отдельно.

Фото

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

Поля
name	string Идентификатор. Ссылка, представляющая фотографию этого места, которую можно использовать для повторного поиска этой фотографии (также называется именем «ресурса» API: places/{place_id}/photos/{photo} ).
width_px	int32 Максимально доступная ширина в пикселях.
height_px	int32 Максимально доступная высота в пикселях.
author_attributions[]	AuthorAttribution Авторы этой фотографии.

ФотоМедиа

Фотомедиа из Places API.

Поля
name	string Имя ресурса фотоносителя в формате: places/{place_id}/photos/{photo_reference}/media .
photo_uri	string Кратковременный URI, который можно использовать для рендеринга фотографии.

Место

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

Поля
name	string Имя ресурса этого места в формате places/{place_id} . Может использоваться для поиска места.
id	string Уникальный идентификатор места.
display_name	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	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[]	AddressComponent Повторяющиеся компоненты для каждого уровня местности. Обратите внимание на следующие факты о массиве адрес_компоненты[]: - Массив компонентов адреса может содержать больше компонентов, чем форматированный_адрес. - Массив не обязательно включает в себя все политические объекты, содержащие адрес, кроме тех, которые включены в formatted_address. Чтобы получить все политические объекты, содержащие определенный адрес, вам следует использовать обратное геокодирование, передавая широту/долготу адреса в качестве параметра запроса. - Формат ответа не может быть неизменным между запросами. В частности, количество адресных_компонентов варьируется в зависимости от запрошенного адреса и может меняться со временем для одного и того же адреса. Компонент может менять положение в массиве. Тип компонента может измениться. В более позднем ответе может отсутствовать определенный компонент.
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 Обычные часы работы.
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 Информация о вариантах зарядки электромобилей.
generative_summary	GenerativeSummary Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative . Краткое описание места, созданное искусственным интеллектом.
area_summary	AreaSummary Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative . Сводная информация о районе, в которой находится это место, сгенерированная искусственным интеллектом.
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 Информация о возможностях доступности, предлагаемых местом.

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

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

Поля
wheelchair_accessible_parking	bool В отеле Place имеется парковка, оборудованная для гостей на инвалидных креслах.
wheelchair_accessible_entrance	bool Места имеют вход для инвалидов-колясочников.
wheelchair_accessible_restroom	bool Здесь есть туалет, оборудованный для гостей на инвалидных креслах.
wheelchair_accessible_seating	bool Место имеет места для гостей на инвалидных креслах.

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

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

Поля
long_text	string Полное текстовое описание или имя компонента адреса. Например, компонент адреса для страны Австралия может иметь длинное_имя «Австралия».
short_text	string Сокращенное текстовое имя компонента адреса, если оно доступно. Например, компонент адреса для страны Австралия может иметь короткое_имя «AU».
types[]	string Массив, указывающий тип(ы) компонента адреса.
language_code	string Язык, используемый для форматирования этих компонентов, в нотации CLDR.

РайонСводка

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

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

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

Атрибуция

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

Поля
provider	string Имя поставщика данных места.
provider_uri	string URI поставщика данных места.

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

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

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

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

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

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

Поля
overview	LocalizedText Обзор места.
description	LocalizedText Подробное описание места.
references	References Ссылки, которые используются для формирования сводного описания.

Часы работы

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

Поля
periods[]	Period Периоды, когда это место открыто в течение недели. Периоды расположены в хронологическом порядке, начиная с воскресенья в местном часовом поясе. Пустое (но не отсутствующее) значение указывает на место, которое никогда не открыто, например, потому что оно временно закрыто на ремонт.
weekday_descriptions[]	string Локализованные строки, описывающие часы работы этого заведения, по одной строке на каждый день недели. Будет пустым, если часы неизвестны или их невозможно преобразовать в локализованный текст. Пример: «Вс: 18:00–06:00».
secondary_hours_type	SecondaryHoursType Строка типа, используемая для определения типа дополнительных часов.
special_days[]	SpecialDay Структурированная информация для особых дней, попадающих в период, охватываемый возвращенными часами работы. Особые дни — это дни, которые могут повлиять на часы работы заведения, например Рождество. Установите значения current_opening_hours и current_ Secondary_opening_hours, если есть исключительные часы.
open_now	bool Это место сейчас открыто? Всегда присутствует, если у нас нет данных о времени суток или часовом поясе для этих часов работы.

Период

Период, в течение которого место остается в статусе open_now.

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

Точка

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

Поля
date	Date Дата в местном часовом поясе места.
truncated	bool Была ли эта конечная точка усечена или нет. Усечение происходит, когда реальные часы выходят за рамки времени, между которым мы готовы вернуть часы, поэтому мы усекаем часы обратно до этих границ. Это гарантирует возврат максимум 24*7 часов с полуночи дня запроса.
day	int32 День недели в виде целого числа в диапазоне 0–6. 0 — воскресенье, 1 — понедельник и т. д.
hour	int32 Час в 2-х цифрах. Диапазон от 00 до 23.
minute	int32 Минуты в 2-х цифрах. Диапазон от 00 до 59.

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

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

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

Особенный день

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

Поля
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», содержащий суффикс глобального кода и замена префикса с форматированным именем эталонной объекта.

Субседление

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

Поля
name	string Название ресурса назначения суб.
id	string Место идентификатор места назначения.

Уровень цены

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

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

Рекомендации

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

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

Поля
reviews[]	Review Отзывы, которые служат ссылками.
places[]	string Список названий ресурсов указанных мест. Это имя можно использовать в других API, которые принимают имена ресурсов места.

Обзор

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

Поля
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 Временная метка для обзора.

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 может быть указано. Если есть какие -либо противоречивые первичные типы, то есть тип появляется как в incocal_primary_types, так и excuded_primary_types, возвращается ошибка vangiad_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 Как результаты будут ранжированы в ответ.

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

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

Поля
type поля Союза. type может быть только одним из следующих:
circle	Circle Круг, определяемый центральной точкой и радиусом.

RankPreference

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

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

SearchNearByResponse

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

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

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. Отрицательные значения вернут ошибку vangiad_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 для поиска в запросе поиска места.

Эвопции

Параметры 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	Результаты результатов по актуальности. Порядок сортировки определяется нормальным рейтингом.

SearchTexTresponse

Ответ Proto для SearchText.

Поля
places[]	Place Список мест, которые соответствуют критериям текстового поиска пользователя.
contextual_contents[]	ContextualContent Экспериментальный: см . Https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации. Список контекстуального содержимого, где каждая запись ассоциируется с соответствующим местом в том же индексе в поле «Места». Содержание, которое имеет отношение к text_query в запросе, предпочтительнее. Если контекстный контент не доступен для одного из мест, он вернет неконтексу. Это будет пусто только тогда, когда контент недоступен для этого места. Этот список должен иметь столько же записей, сколько и список мест, если их запрошен.
next_page_token	string Токен, который можно отправить как page_token , чтобы получить следующую страницу. Если это поле опущено или пустое, нет последующих страниц.