Method: places.searchText

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

HTTP-запрос

POST https://places.googleapis.com/v1/places:searchText

URL-адрес использует синтаксис транскодирования gRPC .

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "pageSize": integer,
  "pageToken": string,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Поля
textQuery

string

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

languageCode

string

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

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

regionCode

string

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

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

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

rankPreference

enum ( RankPreference )

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

includedType

string

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

openNow

boolean

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

minRating

number

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

maxResultCount
(deprecated)

integer

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

Максимальное количество результатов на странице, которое может быть возвращено. Если количество доступных результатов больше, чем maxResultCount , возвращается nextPageToken , который можно передать в pageToken , чтобы получить следующую страницу результатов в последующих запросах. Если указано 0 или значение отсутствует, используется значение по умолчанию 20. Максимальное значение — 20; значения выше 20 будут приведены к 20. Отрицательные значения вернут ошибку INVALID_ARGUMENT.

Если указаны и maxResultCount , и pageSize , maxResultCount будет игнорироваться.

pageSize

integer

Необязательный. Максимальное количество результатов на странице, которое может быть возвращено. Если количество доступных результатов больше, чем pageSize , возвращается nextPageToken , который можно передать в pageToken для получения следующей страницы результатов в последующих запросах. Если указано 0 или значение отсутствует, используется значение по умолчанию 20. Максимальное значение — 20; значения выше 20 будут установлены на 20. Отрицательные значения вернут ошибку INVALID_ARGUMENT.

Если указаны и maxResultCount , и pageSize , maxResultCount будет игнорироваться.

pageToken

string

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

При разбиении на страницы все параметры, кроме pageToken , pageSize и maxResultCount , предоставленные TextSearch, должны соответствовать начальному вызову, который предоставил токен страницы. В противном случае возвращается ошибка INVALID_ARGUMENT.

priceLevels[]

enum ( PriceLevel )

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

strictTypeFiltering

boolean

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

locationBias

object ( LocationBias )

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

locationRestriction

object ( LocationRestriction )

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

evOptions

object ( EVOptions )

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

Тело ответа

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

В случае успеха тело ответа содержит данные следующей структуры:

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

object ( Place )

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

contextualContents[]

object ( ContextualContent )

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

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

nextPageToken

string

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

РангПредпочтение

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

Перечисления
RANK_PREFERENCE_UNSPECIFIED Для категориального запроса, такого как «Рестораны в Нью-Йорке», значением по умолчанию является РЕЛЕВАНТНОСТЬ. Для некатегорийных запросов, таких как «Маунтин-Вью, Калифорния», мы рекомендуем оставить RankPreference неустановленным.
DISTANCE Ранжирует результаты по расстоянию.
RELEVANCE Ранжирует результаты по релевантности. Порядок сортировки определяется обычным стеком ранжирования.

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

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

JSON-представление
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Поля

type поля объединения.

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

rectangle

object ( Viewport )

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

circle

object ( Circle )

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

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

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

JSON-представление
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Поля

type поля объединения.

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

rectangle

object ( Viewport )

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

EVOptions

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

JSON-представление
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Поля
minimumChargingRateKw

number

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

connectorTypes[]

enum ( EVConnectorType )

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

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

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

Контент, контекстуальный запросу места.

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

object ( Review )

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

photos[]

object ( Photo )

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

justifications[]

object ( 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 .

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

JSON-представление
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
Поля

justification поля объединения.

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

reviewJustification

object ( ReviewJustification )

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

businessAvailabilityAttributesJustification

object ( 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 .

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

JSON-представление
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Поля
highlightedText

object ( HighlightedText )

review

object ( Review )

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

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

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

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

string

highlightedTextRanges[]

object ( HighlightedTextRange )

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

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

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

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

integer

endIndex

integer

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

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

JSON-представление
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
Поля
takeout

boolean

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

delivery

boolean

Если место обеспечивает доставку.

dineIn

boolean

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