Places Widgets

Класс PlaceAutocompleteElement

google.maps.places . PlaceAutocompleteElement

PlaceAutocompleteElement — это подкласс HTMLElement , который предоставляет компонент пользовательского интерфейса для API автозаполнения Places.

PlaceAutocompleteElement автоматически использует AutocompleteSessionToken для внутренней группировки фаз запроса и выбора при автодополнении поиска пользователя.

Первый вызов Place.fetchFields для Place , возвращаемого PlacePrediction.toPlace , автоматически включит токен сеанса, используемый для извлечения PlacePrediction .

Более подробную информацию о работе сеансов см. по адресу https://developers.google.com/maps/documentation/places/web-service/place-session-tokens .

Пользовательский элемент:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceAutocompleteElementOptions .

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

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

Место возвращается только в том случае, если его основной тип указан в этом списке. Можно указать до 5 значений. Если типы не указаны, возвращаются все типы мест.
HTML-атрибут:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
Тип: Array <string> optional
Включать результаты только в указанных регионах, заданных как до 15 двухсимвольных кодов регионов CLDR. Пустой набор не ограничивает результаты. Если заданы оба locationRestriction и includedRegionCodes , результаты будут расположены в области пересечения.
HTML-атрибут:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Тип: LocationBias optional
Мягкая граница или подсказка, которую можно использовать при поиске мест.
locationRestriction
Тип: LocationRestriction optional
Границы для ограничения результатов поиска.
name
Тип: string optional
Имя, которое будет использоваться для элемента ввода. Подробнее см. https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name . Действует так же, как атрибут name для элементов ввода. Обратите внимание, что это имя будет использоваться при отправке формы. Подробнее см. https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form .
HTML-атрибут:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
Начальная точка, от которой рассчитывается расстояние. Если не указано, расстояние не рассчитывается. Высота, если указана, не используется в расчёте.
HTML-атрибут:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
Тип: string optional
Идентификатор языка, на котором должны быть возвращены результаты, если это возможно. Результаты на выбранном языке могут иметь более высокий рейтинг, но предложения не ограничиваются этим языком. См. список поддерживаемых языков .
HTML-атрибут:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Тип: string optional
Код региона, используемый для форматирования и фильтрации результатов. Он не ограничивает предложения данной страной. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Великобритании — «uk» ( .co.uk ), а код ISO 3166-1 — «gb» (технически обозначает «Соединённое Королевство Великобритании и Северной Ирландии»).
HTML-атрибут:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
Тип: UnitSystem optional
Система единиц измерения, используемая для отображения расстояний. Если не указано иное, система единиц определяется объектом requestedRegion.
HTML-атрибут:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
prediction-item
Элемент в раскрывающемся списке прогнозов, представляющий один прогноз.
prediction-item-icon
Значок, отображаемый слева от каждого элемента в списке прогнозов.
prediction-item-main-text
Часть элемента predict-item, представляющая собой основной текст прогноза. Для географических объектов содержит название места, например, «Сидней», или название улицы и номер дома, например, «10 King Street». По умолчанию элемент predict-item-main-text имеет черный цвет. Если в элементе predict-item есть какой-либо дополнительный текст, он находится за пределами элемента predict-item-main-text и наследует его стиль. По умолчанию он имеет серый цвет. Дополнительный текст обычно представляет собой адрес.
prediction-item-match
Часть возвращаемого прогноза, которая соответствует введенному пользователем тексту. По умолчанию этот совпавший текст выделяется жирным шрифтом. Обратите внимание, что совпавший текст может находиться в любом месте элемента predict-item. Он не обязательно является частью predict-item-main-text.
prediction-item-selected
Элемент, к которому пользователь переходит с помощью клавиатуры. Примечание: выбранные элементы будут подвержены влиянию как стилей этой части, так и стилей части элементов прогнозирования.
prediction-list
Визуальный элемент, содержащий список подсказок, возвращаемых службой Place Autocomplete. Этот список отображается в виде раскрывающегося списка под элементом PlaceAutocompleteElement.
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .
gmp-error
function(errorEvent)
Аргументы:
Это событие срабатывает, когда запрос к бэкенду был отклонён (например, из-за неверного ключа API). Это событие не всплывает.
gmp-select
function(placePredictionSelectEvent)
Аргументы:
Это событие вызывается, когда пользователь выбирает прогнозируемое место. Содержит объект PlacePrediction, который можно преобразовать в объект Place.

Интерфейс PlaceAutocompleteElementOptions

google.maps.places . PlaceAutocompleteElementOptions

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

locationBias optional
Тип: LocationBias optional
locationRestriction optional
Тип: LocationRestriction optional
name optional
Тип: string optional
requestedLanguage optional
Тип: string optional

Класс PlacePredictionSelectEvent

google.maps.places . PlacePredictionSelectEvent

Это событие создаётся после того, как пользователь выбирает элемент прогнозирования с помощью PlaceAutocompleteElement. Доступ к выбранному элементу осуществляется с помощью event.placePrediction .

Преобразуйте placePrediction в Place , вызвав PlacePrediction.toPlace .

Этот класс расширяет Event .

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

placePrediction
Преобразуйте его в Place , вызвав PlacePrediction.toPlace .

Класс PlaceAutocompleteRequestErrorEvent

google.maps.places . PlaceAutocompleteRequestErrorEvent

Это событие генерируется PlaceAutocompleteElement, когда возникает проблема с сетевым запросом.

Этот класс расширяет Event .

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

Класс PlaceContextualElement

google.maps.places . PlaceContextualElement

Виджет, который использует токен контекста для отображения контекстного представления ответа Grounding with Google Maps.

Пользовательский элемент:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceContextualElementOptions .

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

contextToken
Тип: string optional
Контекстный токен.
HTML-атрибут:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceContextualElementOptions

google.maps.places . PlaceContextualElementOptions

Параметры PlaceContextualElement .

contextToken optional
Тип: string optional
Контекстный токен, предоставленный ответом Grounding with Google Maps.

Класс PlaceContextualListConfigElement

google.maps.places . PlaceContextualListConfigElement

HTML-элемент, который настраивает параметры представления списка контекстного элемента «Место».

Пользовательский элемент:
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceContextualListConfigElementOptions .

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

layout
Тип: PlaceContextualListLayout optional
Макет.
HTML-атрибут:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Тип: boolean optional
Скрыта ли карта.
HTML-атрибут:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceContextualListConfigElementOptions

google.maps.places . PlaceContextualListConfigElementOptions

Параметры для PlaceContextualListConfigElement.

layout optional
Тип: PlaceContextualListLayout optional
Макет. По умолчанию — PlaceContextualListLayout.VERTICAL .
mapHidden optional
Тип: boolean optional
Скрыта ли карта. По умолчанию карта отображается (значение false).

Константы PlaceContextualListLayout

google.maps.places . PlaceContextualListLayout

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

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

COMPACT Компактная компоновка списка: элементы списка отображаются как ссылки на одной строке, а выпадающие списки отображаются в раскрывающемся списке.
VERTICAL Вертикальный список: элементы списка отображаются в виде карточек в вертикальном списке.

Класс PlaceDetailsElement

google.maps.places . PlaceDetailsElement

HTML-элемент, отображающий информацию о месте. Используйте методы configureFromPlace() или configureFromLocation() чтобы указать отображаемый контент. Чтобы использовать элемент Place Details, включите API Places UI Kit для своего проекта в консоли Google Cloud.

Пользовательский элемент:
<gmp-place-details size="small"></gmp-place-details>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceDetailsElementOptions .

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

PlaceDetailsElement
PlaceDetailsElement([options])
Параметры:
place
Тип: Place optional
Только для чтения. Объект Place , содержащий идентификатор, местоположение и область просмотра текущего отображаемого места.
size
Тип: PlaceDetailsSize optional
Вариант размера элемента PlaceDetailsElement. По умолчанию элемент будет иметь значение PlaceDetailsSize.X_LARGE .
HTML-атрибут:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
configureFromLocation
configureFromLocation(location)
Параметры:
  • location : LatLng | LatLngLiteral Местоположение, для которого требуется отобразить сведения о месте.
Возвращаемое значение: Promise <void> Обещание, которое разрешается после загрузки и отображения данных о месте.
Настраивает виджет из LatLng с использованием обратного геокодирования.
configureFromPlace
configureFromPlace(place)
Параметры:
  • place : Place |{id:string} Место, для которого требуется отобразить сведения.
Возвращаемое значение: Promise <void> Обещание, которое разрешается после загрузки и отображения данных о месте.
Настраивает виджет на основе объекта Place или идентификатора Place.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .
gmp-load
function(event)
Аргументы:
Это событие срабатывает при загрузке элемента и отображении его содержимого. Это событие не всплывает.
gmp-requesterror
function(event)
Аргументы:
Это событие срабатывает, когда запрос к бэкенду был отклонён (например, из-за неверного ключа API). Это событие не всплывает.

Интерфейс PlaceDetailsElementOptions

google.maps.places . PlaceDetailsElementOptions

Параметры PlaceDetailsElement .

size optional
Тип: PlaceDetailsSize optional
См. PlaceDetailsElement.size

Константы PlaceDetailsSize

google.maps.places . PlaceDetailsSize

Варианты размеров для PlaceDetailsElement .

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

LARGE Большой вариант, включающий крупное изображение, основную информацию и контактную информацию.
MEDIUM Средний вариант, включающий крупное изображение и основную информацию.
SMALL Маленький вариант, включающий небольшое изображение и основную информацию.
X_LARGE Очень большой вариант, включающий фотоколлаж, обзоры и подробную информацию о месте.

Класс PlaceDetailsCompactElement

google.maps.places . PlaceDetailsCompactElement

Отображает сведения о месте в компактном формате. Добавьте элемент PlaceDetailsPlaceRequestElement , чтобы указать место для отображения. Добавьте элемент PlaceContentConfigElement , PlaceStandardContentElement или PlaceAllContentElement , чтобы указать, какой контент отображать.

Чтобы использовать этот элемент, включите API Places UI Kit для вашего проекта в консоли Google Cloud.

Пользовательский элемент:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceDetailsCompactElementOptions .

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

PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Параметры:
orientation
Тип: PlaceDetailsOrientation optional
По умолчанию: PlaceDetailsOrientation.VERTICAL
Вариант ориентации элемента (вертикальный или горизонтальный).
HTML-атрибут:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Тип: Place optional
Только для чтения. Объект места, содержащий идентификатор, местоположение и область просмотра текущего отображаемого места.
truncationPreferred
Тип: boolean
По умолчанию: false
Если значение равно true, название места и адрес обрезаются, чтобы уместиться на одной строке вместо переноса.
HTML-атрибут:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-mat-color-info
Цвет элементов пользовательского интерфейса с информационным подтекстом. Используется для значка инвалидной коляски.
--gmp-mat-color-negative
Цвет элементов интерфейса с негативной тональностью. Используется для текста «Закрыто» в статусе «Открыто сейчас».
--gmp-mat-color-neutral-container
Цвет контейнера для элементов пользовательского интерфейса с нейтральной заливкой. Используется для заглушек изображений.
--gmp-mat-color-on-secondary-container
Цвет текста и значков в зависимости от цвета вторичного контейнера. Используется для текста и значков на кнопке «Открыть на Картах».
--gmp-mat-color-on-surface
Цвет текста и значков на поверхности любого цвета. Используется для обычного текста.
--gmp-mat-color-on-surface-variant
Цвет с низким акцентом для текста и значков на фоне любого цвета поверхности. Используется для менее выраженного текста.
--gmp-mat-color-outline-decorative
Цвет контура неинтерактивных элементов. Используется для границы элемента.
--gmp-mat-color-positive
Цвет элементов интерфейса с позитивной тональностью. Используется для текста «Открыто» в статусе «Открыто сейчас».
--gmp-mat-color-primary
Цвет интерактивного текста и значков по сравнению с цветом поверхности. Используется для подсчёта отзывов и ссылок в диалоговом окне атрибуции.
--gmp-mat-color-secondary-container
Менее заметный цвет заливки на поверхности, для рецессивных компонентов, таких как тональные кнопки. Используется для фона кнопки «Открыть в Картах».
--gmp-mat-color-surface
Цвет фона. Используется для фона элемента и диалогового окна атрибуции.
--gmp-mat-font-body-medium
Используется для основного текста в диалоговом окне атрибуции.
--gmp-mat-font-body-small
Используется для адреса места, рейтинга, типа, цены и статуса «Открыто сейчас».
--gmp-mat-font-family
Базовое семейство шрифтов, используемое для всего текста.
--gmp-mat-font-headline-medium
Используется для заголовка текста в диалоговом окне атрибуции.
--gmp-mat-font-label-large
Используется для кнопки «Открыть в Картах» и ссылок в диалоговом окне атрибуции.
--gmp-mat-font-title-small
Используется для названия места.
background-color
Переопределяет цвет фона элемента.
border
Переопределяет границу элемента.
border-radius
Переопределяет радиус границы элемента.
color-scheme
Указывает, в какой цветовой схеме может быть отображен этот элемент. Подробнее см. документацию по color-scheme . По умолчанию используется color-scheme: light dark .
font-size
Масштабирует весь текст и значки в элементе, которые определены в единицах em. Значение по умолчанию — 16px .
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .
gmp-error
function(event)
Аргументы:
Это событие срабатывает, когда запрос к бэкенду был отклонён (например, из-за неверного ключа API). Это событие не всплывает.
gmp-load
function(event)
Аргументы:
Это событие срабатывает при загрузке элемента и отображении его содержимого. Это событие не всплывает.

Интерфейс PlaceDetailsCompactElementOptions

google.maps.places . PlaceDetailsCompactElementOptions

Параметры PlaceDetailsCompactElement .

orientation optional
Тип: PlaceDetailsOrientation optional
См. PlaceDetailsCompactElement.orientation .
truncationPreferred optional
Тип: boolean optional
См. PlaceDetailsCompactElement.truncationPreferred .

Константы ориентации PlaceDetails

google.maps.places . PlaceDetailsOrientation

Варианты ориентации для PlaceDetailsCompactElement .

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

HORIZONTAL Горизонтальная ориентация.
VERTICAL Вертикальная ориентация.

Класс PlaceDetailsPlaceRequestElement

google.maps.places . PlaceDetailsPlaceRequestElement

Настраивает элемент Place Details Compact для загрузки данных на основе объекта места, идентификатора или имени ресурса. Добавьте этот элемент как дочерний к элементу PlaceDetailsCompactElement , чтобы загрузить данные для указанного места.

Пользовательский элемент:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceDetailsPlaceRequestElementOptions .

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

PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Параметры:
place
Тип: Place optional
Объект, идентификатор или имя ресурса места, сведения о котором отображаются в компактном элементе Place Details. Это свойство отображается в атрибуте как имя ресурса.
HTML-атрибут:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceDetailsPlaceRequestElementOptions

google.maps.places . PlaceDetailsPlaceRequestElementOptions

Параметры для PlaceDetailsPlaceRequestElement .

place optional
Тип: Place |string optional
См. PlaceDetailsPlaceRequestElement.place

Класс PlaceContentConfigElement

google.maps.places . PlaceContentConfigElement

Настраивает содержимое, отображаемое элементом Place Details Compact. Чтобы использовать этот элемент, добавьте его как дочерний к элементу PlaceDetailsCompactElement . Чтобы отобразить соответствующее содержимое, добавьте к элементу PlaceContentConfigElement любой из следующих элементов:
PlaceMediaElement , PlaceAddressElement , PlaceRatingElement , PlaceTypeElement , PlacePriceElement , PlaceAccessibleEntranceIconElement , PlaceOpenNowStatusElement , PlaceAttributionElement
Порядок дочерних элементов не имеет значения; элемент отображает содержимое в стандартном порядке, который нельзя настроить.

Пользовательский элемент:
<gmp-place-content-config></gmp-place-content-config>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceContentConfigElementOptions .

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

PlaceContentConfigElement
PlaceContentConfigElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceContentConfigElementOptions

google.maps.places . PlaceContentConfigElementOptions

Параметры для PlaceContentConfigElement .

Класс PlaceMediaElement

google.maps.places . PlaceMediaElement

Настраивает элемент Place Details Compact для отображения медиаданных места, таких как фотографии. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-media lightbox-preferred></gmp-place-media>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceMediaElementOptions .

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

PlaceMediaElement
PlaceMediaElement([options])
Параметры:
lightboxPreferred
Тип: boolean optional
По умолчанию: false
Включать или отключать медиа-лайтбокс, если поддерживаются обе опции.
HTML-атрибут:
  • <gmp-place-media lightbox-preferred></gmp-place-media>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceMediaElementOptions

google.maps.places . PlaceMediaElementOptions

Параметры PlaceMediaElement .

lightboxPreferred optional
Тип: boolean optional
См. PlaceMediaElement.lightboxPreferred .

Класс PlaceAddressElement

google.maps.places . PlaceAddressElement

Настраивает элемент Place Details Compact для отображения адреса места. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-address></gmp-place-address>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceAddressElementOptions .

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

PlaceAddressElement
PlaceAddressElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceAddressElementOptions

google.maps.places . PlaceAddressElementOptions

Параметры для PlaceAddressElement .

Класс PlaceRatingElement

google.maps.places . PlaceRatingElement

Настраивает элемент Place Details Compact для отображения рейтинга места. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-rating></gmp-place-rating>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceRatingElementOptions .

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

PlaceRatingElement
PlaceRatingElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceRatingElementOptions

google.maps.places . PlaceRatingElementOptions

Параметры PlaceRatingElement .

Класс PlaceTypeElement

google.maps.places . PlaceTypeElement

Настраивает элемент Place Details Compact для отображения типа места. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-type></gmp-place-type>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceTypeElementOptions .

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

PlaceTypeElement
PlaceTypeElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceTypeElementOptions

google.maps.places . PlaceTypeElementOptions

Параметры для PlaceTypeElement .

Класс PlacePriceElement

google.maps.places . PlacePriceElement

Настраивает элемент Place Details Compact для отображения уровня или диапазона цен. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-price></gmp-place-price>

Этот класс расширяет HTMLElement .

Этот класс реализует PlacePriceElementOptions .

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

PlacePriceElement
PlacePriceElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlacePriceElementOptions

google.maps.places . PlacePriceElementOptions

Параметры для PlacePriceElement .

Класс PlaceAccessibleEntranceIconElement

google.maps.places . PlaceAccessibleEntranceIconElement

Настраивает элемент Place Details Compact для отображения значка инвалидной коляски, если у места есть доступный вход. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceAccessibleEntranceIconElementOptions .

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

PlaceAccessibleEntranceIconElement
PlaceAccessibleEntranceIconElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceAccessibleEntranceIconElementOptions

google.maps.places . PlaceAccessibleEntranceIconElementOptions

Параметры для PlaceAccessibleEntranceIconElement .

Класс PlaceOpenNowStatusElement

google.maps.places . PlaceOpenNowStatusElement

Настраивает элемент Place Details Compact для отображения текущего статуса открытости или закрытости места. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement .

Пользовательский элемент:
<gmp-place-open-now-status></gmp-place-open-now-status>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceOpenNowStatusElementOptions .

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

PlaceOpenNowStatusElement
PlaceOpenNowStatusElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceOpenNowStatusElementOptions

google.maps.places . PlaceOpenNowStatusElementOptions

Параметры для PlaceOpenNowStatusElement .

Класс PlaceAttributionElement

google.maps.places . PlaceAttributionElement

Позволяет настраивать текст атрибуции Google Карт в компактном элементе Place Details. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceContentConfigElement . Если этот элемент пропущен, атрибуция всё равно будет отображаться цветами по умолчанию.

Пользовательский элемент:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceAttributionElementOptions .

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

PlaceAttributionElement
PlaceAttributionElement([options])
Параметры:
darkSchemeColor
Тип: AttributionColor optional
По умолчанию: AttributionColor.WHITE
Цвет атрибуции Google Maps в темном режиме.
HTML-атрибут:
  • <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor
Тип: AttributionColor optional
По умолчанию: AttributionColor.GRAY
Цвет атрибуции Google Maps в светлом режиме.
HTML-атрибут:
  • <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceAttributionElementOptions

google.maps.places . PlaceAttributionElementOptions

Параметры для PlaceAttributionElement .

darkSchemeColor optional
Тип: AttributionColor optional
См. PlaceAttributionElement.darkSchemeColor .
lightSchemeColor optional
Тип: AttributionColor optional
См. PlaceAttributionElement.lightSchemeColor .

Константы AttributionColor

google.maps.places . AttributionColor

Варианты цветов для текста атрибуции в Google Картах. Для атрибуции можно использовать любой из этих цветов.

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

BLACK Черный текст атрибуции.
GRAY Серый текст атрибуции.
WHITE Белый текст атрибуции.

Класс PlaceAllContentElement

google.maps.places . PlaceAllContentElement

Настраивает элемент Place Details Compact для отображения всего доступного контента. Чтобы использовать этот элемент, добавьте его как дочерний к PlaceDetailsCompactElement .

Пользовательский элемент:
<gmp-place-all-content></gmp-place-all-content>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceAllContentElementOptions .

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

PlaceAllContentElement
PlaceAllContentElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceAllContentElementOptions

google.maps.places . PlaceAllContentElementOptions

Параметры для PlaceAllContentElement .

Класс PlaceStandardContentElement

google.maps.places . PlaceStandardContentElement

Настраивает элемент Place Details Compact для отображения стандартного набора контента (медиа, рейтинг, тип, цена, значок доступного входа и статус «Открыто сейчас»). Чтобы использовать этот элемент, добавьте его как дочерний к элементу PlaceDetailsCompactElement .

Пользовательский элемент:
<gmp-place-standard-content></gmp-place-standard-content>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceStandardContentElementOptions .

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

PlaceStandardContentElement
PlaceStandardContentElement([options])
Параметры:
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceStandardContentElementOptions

google.maps.places . PlaceStandardContentElementOptions

Параметры для PlaceStandardContentElement .

Класс PlaceListElement

google.maps.places . PlaceListElement

HTML-элемент, отображающий результаты поиска места в виде списка. Используйте методы configureFromSearchByTextRequest() или configureFromSearchNearbyRequest() чтобы указать запрос, для которого необходимо отобразить результаты. Чтобы использовать элемент списка мест, включите API Places UI Kit для своего проекта в консоли Google Cloud.

Пользовательский элемент:
<gmp-place-list selectable></gmp-place-list>

Этот класс расширяет HTMLElement .

Этот класс реализует PlaceListElementOptions .

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

PlaceListElement
PlaceListElement([options])
Параметры:
places
Тип: Array < Place >
Только для чтения. Массив объектов Place , содержащий идентификаторы, местоположения и области просмотра отображаемых в данный момент мест.
selectable
Тип: boolean
Можно ли выбирать элементы списка? Если значение равно true, элементы списка будут кнопками, которые при нажатии вызывают событие gmp-placeselect . Также поддерживаются навигация и выбор с помощью доступной клавиатуры.
HTML-атрибут:
  • <gmp-place-list selectable></gmp-place-list>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
Параметры:
  • request : SearchByTextRequest запрос на отображение результатов. Свойство fields для SearchByTextRequest не является обязательным.
Возвращаемое значение: Promise <void> Обещание, которое разрешается после загрузки и отображения данных о месте.
Настраивает виджет для отображения результатов поиска из запроса API текстового поиска Places.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
Параметры:
  • request : SearchNearbyRequest запрос на отображение результатов. Свойство fields для SearchNearbyRequest не является обязательным.
Возвращаемое значение: Promise <void> Обещание, которое разрешается после загрузки и отображения данных о месте.
Настраивает виджет для отображения результатов поиска из запроса API Places Nearby Search.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .
gmp-load
function(event)
Аргументы:
Это событие срабатывает при загрузке элемента и отображении его содержимого. Это событие не всплывает.
gmp-placeselect
function(event)
Аргументы:
Это событие вызывается, когда пользователь выбирает место. Содержит объект Place и индекс выбранного места в списке.
gmp-requesterror
function(event)
Аргументы:
Это событие срабатывает, когда запрос к бэкенду был отклонён (например, из-за неверного ключа API). Это событие не всплывает.

Интерфейс PlaceListElementOptions

google.maps.places . PlaceListElementOptions

Параметры для PlaceListElement .

selectable optional
Тип: boolean optional
См. PlaceListElement.selectable

Класс PlaceListPlaceSelectEvent

google.maps.places . PlaceListPlaceSelectEvent

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

Этот класс расширяет Event .

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

index
Тип: number
Индекс списка выбранного места.
place
Тип: Place
Объект Place , содержащий идентификатор, местоположение и область просмотра выбранного места.

Класс автодополнения

google.maps.places . Autocomplete

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

Этот класс расширяет MVCObject .

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

Autocomplete
Autocomplete(inputField[, opts])
Параметры:
  • inputField : HTMLInputElement Текстовое поле <input> , к которому следует прикрепить Autocomplete .
  • opts : AutocompleteOptions optional параметры.
Создает новый экземпляр Autocomplete , который прикрепляется к указанному полю ввода текста с заданными параметрами.
getBounds
getBounds()
Параметры: нет
Возвращаемое значение: LatLngBounds |undefined Границы смещения.
Возвращает границы, в которых прогнозы являются смещенными.
getFields
getFields()
Параметры: нет
Возвращаемое значение: Array <string>|undefined
Возвращает поля, которые будут включены в ответ Place in the details при успешном получении информации. Список полей см. PlaceResult .
getPlace
getPlace()
Параметры: нет
Возвращаемое значение: PlaceResult Место, выбранное пользователем.
Возвращает информацию о выбранном пользователем месте, если она была успешно получена. В противном случае возвращает объект-заглушку Place, свойство name которого равно текущему значению поля ввода.
setBounds
setBounds(bounds)
Параметры:
Возвращаемое значение: нет
Задаёт предпочтительную область, в пределах которой будут возвращаться результаты поиска по запросу «Место». Результаты смещены в сторону этой области, но не ограничиваются ею.
setComponentRestrictions
setComponentRestrictions(restrictions)
Параметры:
Возвращаемое значение: нет
Устанавливает ограничения компонента. Ограничения компонента используются для ограничения прогнозов только теми, которые находятся внутри родительского компонента. Например, для страны.
setFields
setFields(fields)
Параметры:
  • fields : Array <string> optional
Возвращаемое значение: нет
Задаёт поля, которые будут включены в ответ Place in the details при успешном получении информации. Список полей см. в PlaceResult .
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: нет
setTypes
setTypes(types)
Параметры:
  • types : Array <string> optional Типы прогнозов, которые следует включить.
Возвращаемое значение: нет
Задаёт типы возвращаемых прогнозов. Информацию о поддерживаемых типах см. в руководстве разработчика . Если типы не указаны, будут возвращены все типы.
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
place_changed
function()
Аргументы: нет
Это событие срабатывает, когда PlaceResult становится доступным для места, выбранного пользователем.
Если пользователь вводит название места, которое не было предложено элементом управления, и нажимает клавишу Enter, или если запрос сведений о месте не выполняется, PlaceResult содержит введенные пользователем данные в свойстве name , при этом другие свойства не определяются.

Интерфейс AutocompleteOptions

google.maps.places . AutocompleteOptions

Параметры, которые можно задать для объекта Autocomplete .

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Область, в которой следует искать места.
componentRestrictions optional
Тип: ComponentRestrictions optional
Ограничения компонентов. Они используются для ограничения прогнозов только теми, что находятся внутри родительского компонента. Например, для страны.
fields optional
Тип: Array <string> optional
Поля, которые необходимо включить в ответ Place in the details при успешном получении данных, за которые будет выставлен счёт . Если передано ['ALL'] , будут возвращены все доступные поля, за которые будет выставлен счёт (это не рекомендуется для производственных развёртываний). Список полей см. в PlaceResult . Вложенные поля можно указывать с помощью точечных путей (например, "geometry.location" ). Значение по умолчанию — ['ALL'] .
placeIdOnly optional
Тип: boolean optional
Извлекать ли только идентификаторы мест. PlaceResult, доступный при срабатывании события place_changed, будет содержать только поля place_id, types и name, а place_id, types и description будут возвращены службой автозаполнения. Отключено по умолчанию.
strictBounds optional
Тип: boolean optional
Логическое значение, указывающее, что виджет автозаполнения должен возвращать только те места, которые находятся внутри границ виджета автозаполнения на момент отправки запроса. Установка strictBounds в false (значение по умолчанию) сделает результаты смещенными в сторону мест, находящихся внутри границ, но не ограниченными ими.
types optional
Тип: Array <string> optional
Типы возвращаемых прогнозов. Поддерживаемые типы см. в руководстве разработчика . Если типы не указаны, будут возвращены все типы.

google.maps.places . SearchBox

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

Этот класс расширяет MVCObject .

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

SearchBox
SearchBox(inputField[, opts])
Параметры:
Создает новый экземпляр SearchBox , который прикрепляется к указанному полю ввода текста с заданными параметрами.
getBounds
getBounds()
Параметры: нет
Возвращаемое значение: LatLngBounds |undefined
Возвращает границы, в пределах которых смещены прогнозы запроса.
getPlaces
getPlaces()
Параметры: нет
Возвращаемое значение: Array < PlaceResult >|undefined
Возвращает запрос, выбранный пользователем для использования с событием places_changed .
setBounds
setBounds(bounds)
Параметры:
Возвращаемое значение: нет
Устанавливает регион, который будет использоваться для смещения прогнозов запросов. Результаты будут только смещены в сторону этой области и не будут полностью ею ограничены.
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
places_changed
function()
Аргументы: нет
Это событие вызывается, когда пользователь выбирает запрос. Для получения новых мест следует использовать getPlaces .

Интерфейс SearchBoxOptions

google.maps.places . SearchBoxOptions

Параметры, которые можно задать для объекта SearchBox .

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Область, к которой следует смещать прогнозы запроса. Прогнозы ориентированы на запросы, нацеленные на эти границы, но не ограничиваются ими.