Autocomplete Data (new)

Интерфейс автозаполнения запроса

google.maps.places . AutocompleteRequest Интерфейс google.maps.places . AutocompleteRequest

Интерфейс запроса для AutocompleteSuggestion.fetchAutocompleteSuggestions .

input
Тип: string
Текстовая строка, по которой осуществляется поиск.
includedPrimaryTypes optional
Тип: Array <string> optional
Включен основной тип места (например, «ресторан» или «заправка»).

Место возвращается только в том случае, если его основной тип включен в этот список. Можно указать до 5 значений. Если типы не указаны, возвращаются все типы мест.
includedRegionCodes optional
Тип: Array <string> optional
Включайте результаты только в указанных регионах, указанных в виде до 15 двухсимвольных кодов регионов CLDR. Пустой набор не будет ограничивать результаты. Если установлены оба locationRestriction и includedRegionCodes , результаты будут расположены в области пересечения.
inputOffset optional
Тип: number optional
Смещение символов Юникода для input отсчитываемое от нуля, указывающее позицию курсора во input . Положение курсора может влиять на то, какие прогнозы возвращаются. Если не указано, по умолчанию используется длина input .
language optional
Тип: string optional
Язык, на котором возвращаются результаты. По умолчанию будут выбраны языковые предпочтения браузера. Результаты могут быть на разных языках, если язык, используемый во input , отличается от language или если возвращаемое место не имеет перевода с местного языка на language .
locationBias optional
Тип: LocationBias optional
Смещение результатов в указанное место.

Должен быть установлен не более одного из locationBias или locationRestriction . Если ни один из них не установлен, результаты будут смещены в зависимости от IP-адреса, то есть IP-адрес будет сопоставлен с неточным местоположением и использован в качестве сигнала смещения.
locationRestriction optional
Тип: LocationRestriction optional
Ограничить результаты указанным местоположением.

Должен быть установлен не более одного из locationBias или locationRestriction . Если ни один из них не установлен, результаты будут смещены в зависимости от IP-адреса, то есть IP-адрес будет сопоставлен с неточным местоположением и использован в качестве сигнала смещения.
origin optional
Тип: LatLng | LatLngLiteral optional
Исходная точка, от которой рассчитывается геодезическое расстояние до пункта назначения (возвращается как PlacePrediction.distanceMeters ). Если это значение опущено, геодезическое расстояние не будет возвращено.
region optional
Тип: string optional
Код региона в виде двухсимвольного кода региона CLDR. Это влияет на форматирование адреса, ранжирование результатов и может влиять на возвращаемые результаты. Это не ограничивает результаты указанным регионом.
sessionToken optional
Тип: AutocompleteSessionToken optional
Токен, который идентифицирует сеанс автозаполнения для целей выставления счетов. Создайте новый токен сеанса с помощью AutocompleteSessionToken .

Сеанс начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место и вызывает Place.fetchFields . В каждом сеансе может быть несколько запросов, за которыми следует один вызов fetchFields . Учетные данные, используемые для каждого запроса в рамках сеанса, должны принадлежать одному и тому же проекту Google Cloud Console. После завершения сеанса токен больше не действителен; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр sessionToken опущен или вы повторно используете токен сеанса, плата за сеанс взимается так, как если бы токен сеанса не был предоставлен (каждый запрос оплачивается отдельно).

Мы рекомендуем следующие рекомендации:
  • Используйте токены сеанса для всех вызовов Place Autocomplete.
  • Генерируйте новый токен для каждого сеанса.
  • Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для нескольких сеансов приведет к тому, что каждый запрос будет оплачиваться отдельно.

Класс AutocompleteSessionToken

google.maps.places . AutocompleteSessionToken Класс google.maps.places . AutocompleteSessionToken

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

Доступ осуществляется путем вызова const {AutocompleteSessionToken} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

AutocompleteSessionToken
AutocompleteSessionToken()
Параметры: Нет
Создает новый экземпляр AutocompleteSessionToken .

Класс AutocompleteSuggestion

google.maps.places . AutocompleteSuggestion Класс google.maps.places . AutocompleteSuggestion

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

Доступ осуществляется путем вызова const {AutocompleteSuggestion} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Параметры:
Возвращаемое значение: Promise <{suggestions: Array < AutocompleteSuggestion >}>
Получает список AutocompleteSuggestions.
placePrediction
Тип: PlacePrediction optional
Содержит удобочитаемое имя возвращаемого результата. Для результатов учреждения это обычно название компании и адрес.

Класс PlacePrediction

google.maps.places . PlacePrediction Класс google.maps.places . PlacePrediction

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

Доступ осуществляется путем вызова const {PlacePrediction} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

distanceMeters
Тип: number optional
Длина геодезической в ​​метрах от origin , если origin указано.
mainText
Тип: FormattableText optional
Представляет название места.
placeId
Тип: string
Уникальный идентификатор предлагаемого места. Этот идентификатор можно использовать в других API, которые принимают идентификаторы мест.
secondaryText
Тип: FormattableText optional
Представляет дополнительные функции, устраняющие неоднозначность (например, город или регион) для дальнейшей идентификации места.
text
Содержит удобочитаемое имя возвращаемого результата. Для результатов учреждения это обычно название компании и адрес.

text рекомендуется разработчикам, которые хотят показать один элемент пользовательского интерфейса. Разработчики, которые хотят отобразить два отдельных, но связанных элемента пользовательского интерфейса, могут вместо этого использовать PlacePrediction.mainText и PlacePrediction.secondaryText .
types
Тип: Array <string>
Список типов, применимых к этому месту, из таблицы A или таблицы B в https://developers.google.com/maps/documentation/places/web-service/place-types .
toPlace
toPlace()
Параметры: Нет
Возвращаемое значение: Place
Возвращает представление Place этого PlacePrediction. Последующий вызов Place.fetchFields необходим для получения полной информации о месте.

Класс StringRange

google.maps.places . StringRange Класс google.maps.places . StringRange

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

Доступ осуществляется путем вызова const {StringRange} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

endOffset
Тип: number
Смещение с отсчетом от нуля последнего символа Юникода подстроки (исключающее).
startOffset
Тип: number
Смещение первого символа Юникода подстроки (включительно), отсчитываемое от нуля.

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

google.maps.places . FormattableText Класс google.maps.places . FormattableText

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

Доступ осуществляется путем вызова const {FormattableText} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

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