Places Widgets

Класс BasicPlaceAutocompleteElement

google.maps.places . BasicPlaceAutocompleteElement

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

Пользовательский элемент:
<gmp-basic-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-basic-place-autocomplete>

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

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

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

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

Место возвращается только в том случае, если его основной тип указан в этом списке. Можно указать до 5 значений. Если типы не указаны, возвращаются все типы мест.
HTML-атрибут:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
Тип: Array <string> optional
Включать результаты только в указанных регионах, заданных как до 15 двухсимвольных кодов регионов CLDR. Пустой набор не ограничивает результаты. Если заданы оба locationRestriction и includedRegionCodes , результаты будут расположены в области пересечения.
HTML-атрибут:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-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-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
Начальная точка, от которой рассчитывается расстояние. Если не указано, расстояние не рассчитывается. Высота, если указана, не используется в расчёте.
HTML-атрибут:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
Тип: string optional
Идентификатор языка, на котором должны быть возвращены результаты, если это возможно. Результаты на выбранном языке могут иметь более высокий рейтинг, но предложения не ограничиваются этим языком. См. список поддерживаемых языков .
HTML-атрибут:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
Тип: string optional
Код региона, используемый для форматирования и фильтрации результатов. Он не ограничивает предложения данной страной. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Великобритании — «uk» ( .co.uk ), а код ISO 3166-1 — «gb» (технически обозначает «Соединённое Королевство Великобритании и Северной Ирландии»).
HTML-атрибут:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
Тип: UnitSystem optional
Система единиц измерения, используемая для отображения расстояний. Если не указано иное, система единиц определяется объектом requestedRegion.
HTML-атрибут:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
Этот слот принимает ровно один элемент <template> для отображения в виде значка, отображаемого рядом с элементом прогнозирования.
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.
background-color
Переопределяет цвет фона элемента.
border
Переопределяет границу элемента.
border-radius
Переопределяет радиус границы элемента.
color-scheme
Указывает, в какой цветовой схеме может быть отображен этот элемент. Подробнее см. документацию по color-scheme . По умолчанию используется color-scheme: light dark .
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
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(placeSelectEvent)
Аргументы:
Это событие вызывается, когда пользователь выбирает прогнозируемое место. Содержит объект Place.

Интерфейс BasicPlaceAutocompleteElementOptions

google.maps.places . BasicPlaceAutocompleteElementOptions

Варианты построения BasicPlaceAutocompleteElement.

includedPrimaryTypes optional
Тип: Array <string> optional
includedRegionCodes optional
Тип: Array <string> optional
locationBias optional
Тип: LocationBias optional
locationRestriction optional
Тип: LocationRestriction optional
name optional
Тип: string optional
origin optional
requestedLanguage optional
Тип: string optional
requestedRegion optional
Тип: string optional
unitSystem optional
Тип: UnitSystem optional

Класс 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-icon
Этот слот принимает ровно один элемент <template> для отображения в виде значка, отображаемого рядом с элементом прогнозирования.
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.
background-color
Переопределяет цвет фона элемента.
border
Переопределяет границу элемента.
border-radius
Переопределяет радиус границы элемента.
color-scheme
Указывает, в какой цветовой схеме может быть отображен этот элемент. Подробнее см. документацию по color-scheme . По умолчанию используется color-scheme: light dark .
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
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.

includedPrimaryTypes optional
Тип: Array <string> optional
includedRegionCodes optional
Тип: Array <string> optional
locationBias optional
Тип: LocationBias optional
locationRestriction optional
Тип: LocationRestriction optional
name optional
Тип: string optional
origin optional
requestedLanguage optional
Тип: string optional
requestedRegion optional
Тип: string optional
unitSystem optional
Тип: UnitSystem 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 .

Класс 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 .

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

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

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

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

PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
Параметры:
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>
mapMode
Тип: PlaceContextualListMapMode optional
Режим карты, используемый в контекстном элементе «Место» для списка мест.
HTML-атрибут:
  • <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="hybrid"></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
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
True, если карта должна быть скрыта.
mapMode optional
Тип: PlaceContextualListMapMode optional
По умолчанию: PlaceContextualListMapMode.ROADMAP
Режим карты, используемый в контекстном элементе «Место» для списка мест.

Константы PlaceContextualListLayout

google.maps.places . PlaceContextualListLayout

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

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

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

Константы PlaceContextualListMapMode

google.maps.places . PlaceContextualListMapMode

Режим карты, используемый в контекстном элементе «Место» для списка мест.

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

HYBRID Прозрачный слой главных улиц на спутнике или фотореалистичное изображение в 3D.
NONE Карты нет.
ROADMAP Обычная 2D-карта улиц.

Класс PlaceDetailsElement

google.maps.places . PlaceDetailsElement

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

Пример:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details>

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

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

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

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

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

PlaceDetailsElement
PlaceDetailsElement([options])
Параметры:
place
Тип: Place optional
Только для чтения. Объект места, содержащий идентификатор, местоположение и область просмотра текущего отображаемого места.
--gmp-button-border-color
Цвет границы кнопки «Открыть в Картах».
--gmp-button-border-radius
Радиус границы кнопки «Открыть в Картах».
--gmp-button-border-width
Ширина границы кнопки «Открыть в Картах».
--gmp-collage-border-radius-outer
Радиус скругления внешних углов медиа-коллажа.
--gmp-dialog-border-radius
Радиус границы диалогового окна раскрытия данных Google Maps.
--gmp-mat-color-disabled-surface
Цвет поверхности предназначен для обозначения отключенного состояния или отсутствия. Используется для пустых звёзд обзора.
--gmp-mat-color-info
Цвет элементов пользовательского интерфейса с информационным подтекстом. Используется для значка инвалидной коляски.
--gmp-mat-color-negative
Цвет элементов интерфейса с негативной тональностью. Используется для текста «Закрыто» в статусе «Открыто сейчас».
--gmp-mat-color-neutral-container
Цвет контейнера для элементов интерфейса с нейтральной заливкой. Используется для заглушек изображений и значка даты публикации отзыва.
--gmp-mat-color-on-neutral-container
Цвет текста и значков по сравнению с нейтральным цветом контейнера. Используется для значка даты публикации обзора и значка доступности зарядного устройства для электромобиля, если оно недоступно.
--gmp-mat-color-on-positive-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-positive-container
Цвет контейнера для элементов интерфейса, передающих позитивное настроение. Используется для значка доступности зарядного устройства для электромобиля (при наличии).
--gmp-mat-color-primary
Цвет интерактивного текста и значков по отношению к цвету поверхности. Используется для количества отзывов, ссылок в диалоговом окне раскрытия информации в Google Картах, ссылок на веб-сайты, значков на вкладке «Обзор» и (цвет наведения / фокуса / текста) в заголовках панели вкладок.
--gmp-mat-color-secondary-container
Менее заметный цвет заливки на поверхности, для рецессивных компонентов, таких как тональные кнопки. Используется для фона кнопки «Открыть в Картах».
--gmp-mat-color-surface
Цвет фона. Используется для фона элемента и диалогового окна раскрытия информации в Google Картах.
--gmp-mat-font-body-medium
Используется для адреса места, рейтинга, типа, цены, статуса «Открыто сейчас», часов работы, отзыва, номера телефона, веб-сайта, кода Plus, основных характеристик и основного текста в диалоговом окне раскрытия информации Google Maps.
--gmp-mat-font-body-small
Используется для основного текста в списке функций на вкладке «О программе».
--gmp-mat-font-display-small
Используется для названия места и текста каждого заголовка на вкладке «О нас».
--gmp-mat-font-family
Базовое семейство шрифтов, используемое для всего текста.
--gmp-mat-font-headline-medium
Используется для заголовка текста в диалоговом окне раскрытия информации в Картах Google.
--gmp-mat-font-label-large
Используется для заголовков вкладок, кнопки «Открыть в Картах», текста указания авторства рецензента в фотогалерее, текста указания авторства рецензента в разделе обзоров и ссылок в диалоговом окне раскрытия информации в Картах Google.
--gmp-mat-font-label-medium
Используется для значка количества фотографий и значка даты публикации обзора.
--gmp-mat-font-title-small
Используется для заголовка каждого раздела на вкладке «О нас».
--gmp-mat-spacing-extra-large
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-extra-small
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-large
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-medium
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-small
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-two-extra-large
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-star-rating-color
Цвет заполненных звезд в рейтинге.
background-color
Переопределяет цвет фона элемента.
border
Переопределяет границу элемента.
border-radius
Переопределяет радиус границы элемента.
color-scheme
Указывает, в какой цветовой схеме может быть отображен этот элемент. Подробнее см. документацию по color-scheme . По умолчанию используется color-scheme: light dark .
font-size
Масштабирует весь текст и значки в элементе, которые определены в единицах em. Значение по умолчанию — 16px .
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
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)
Аргументы:
Это событие срабатывает при загрузке элемента и отображении его содержимого. Это событие не всплывает.

Интерфейс PlaceDetailsElementOptions

google.maps.places . PlaceDetailsElementOptions

Параметры PlaceDetailsElement .

Класс PlaceDetailsCompactElement

google.maps.places . PlaceDetailsCompactElement

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

Пример:

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact>

Чтобы использовать этот элемент, включите 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-button-border-color
Цвет границы кнопки «Открыть в Картах».
--gmp-button-border-radius
Радиус границы кнопки «Открыть в Картах».
--gmp-button-border-width
Ширина границы кнопки «Открыть в Картах».
--gmp-dialog-border-radius
Радиус границы диалогового окна раскрытия данных Google Maps.
--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
Цвет интерактивного текста и значков по сравнению с цветом поверхности. Используется для подсчёта отзывов, а также для ссылок в диалоговом окне раскрытия информации в Google Картах.
--gmp-mat-color-secondary-container
Менее заметный цвет заливки на поверхности, для рецессивных компонентов, таких как тональные кнопки. Используется для фона кнопки «Открыть в Картах».
--gmp-mat-color-surface
Цвет фона. Используется для фона элемента и диалогового окна раскрытия информации в Google Картах.
--gmp-mat-font-body-medium
Используется для основного текста в диалоговом окне раскрытия информации Google Maps.
--gmp-mat-font-body-small
Используется для адреса места, рейтинга, типа, цены и статуса «Открыто сейчас».
--gmp-mat-font-family
Базовое семейство шрифтов, используемое для всего текста.
--gmp-mat-font-headline-medium
Используется для заголовка текста в диалоговом окне раскрытия информации в Картах Google.
--gmp-mat-font-label-large
Используется для кнопки «Открыть в Картах», а также для ссылок в диалоговом окне раскрытия информации в Картах Google и текста указания авторства рецензента в фотогалерее.
--gmp-mat-font-label-medium
Используется для значка подсчета фотографий.
--gmp-mat-font-title-small
Используется для названия места.
--gmp-mat-spacing-extra-small
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-large
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-medium
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-small
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-star-rating-color
Цвет заполненных звезд в рейтинге.
--gmp-thumbnail-border-radius
Радиус границы миниатюрного изображения места.
background-color
Переопределяет цвет фона элемента.
border
Переопределяет границу элемента.
border-radius
Переопределяет радиус границы элемента.
color-scheme
Указывает, в какой цветовой схеме может быть отображен этот элемент. Подробнее см. документацию по color-scheme . По умолчанию используется color-scheme: light dark .
font-size
Масштабирует весь текст и значки в элементе, которые определены в единицах em. Значение по умолчанию — 16px .
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
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

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

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details>

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

Класс PlaceDetailsLocationRequestElement

google.maps.places . PlaceDetailsLocationRequestElement

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

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details>

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

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

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

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

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

Интерфейс PlaceDetailsLocationRequestElementOptions

google.maps.places . PlaceDetailsLocationRequestElementOptions

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

location optional
Место, для которого необходимо визуализировать место.

Класс PlaceSearchElement

google.maps.places . PlaceSearchElement

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

Пример:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

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

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

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

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

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

PlaceSearchElement
PlaceSearchElement([options])
Параметры:
attributionPosition
По умолчанию: PlaceSearchAttributionPosition.TOP
Расположение логотипа с указанием авторства и кнопки раскрытия юридической информации.
HTML-атрибут:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
Тип: PlaceSearchOrientation optional
По умолчанию: PlaceSearchOrientation.VERTICAL
Вариант ориентации элемента (вертикальный или горизонтальный).
HTML-атрибут:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
Тип: Array < Place >
Только для чтения. Массив объектов Place , содержащий идентификаторы, местоположения и области просмотра отображаемых в данный момент мест.
selectable
Тип: boolean optional
По умолчанию: false
Можно ли выбирать элементы списка? Если значение равно true, элементы списка будут кнопками, которые при нажатии вызывают событие gmp-select . Также поддерживаются навигация и выбор с помощью доступной клавиатуры.
HTML-атрибут:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
Тип: boolean optional
По умолчанию: false
Если установлено значение true, определенные строки содержимого обрезаются, чтобы уместиться на одной строке вместо переноса.
HTML-атрибут:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
Цвет границы кнопки «Открыть в Картах».
--gmp-button-border-radius
Радиус границы кнопки «Открыть в Картах».
--gmp-button-border-width
Ширина границы кнопки «Открыть в Картах».
--gmp-card-border-radius
Радиус границы для карточек рассадки.
--gmp-dialog-border-radius
Радиус границы для диалогового окна раскрытия данных Google Maps.
--gmp-mat-color-info
Цвет элементов пользовательского интерфейса с информационным подтекстом. Используется для значка входа для людей с ограниченными возможностями.
--gmp-mat-color-negative
Цвет элементов интерфейса с негативной тональностью. Используется для обозначения времени работы заведения (метки «Закрыто»).
--gmp-mat-color-neutral-container
Цвет контейнера для элементов интерфейса с нейтральной заливкой. Используется для значков даты проверки и загрузки заполнителей.
--gmp-mat-color-on-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-small
Используется для информации о месте.
--gmp-mat-font-family
Базовое семейство шрифтов для всего текста.
--gmp-mat-font-headline-medium
Используется для заголовков диалогов.
--gmp-mat-font-label-large
Используется для содержимого кнопки.
--gmp-mat-font-title-medium
Используется для названия места.
--gmp-mat-spacing-extra-small
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-large
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-medium
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-mat-spacing-small
Используется для задания интервалов внутри элемента, например полей и отступов вокруг текста.
--gmp-star-rating-color
Цвет заполненных звезд в звездном рейтинге.
--gmp-thumbnail-border-radius
Радиус границы для миниатюрного изображения места.
background-color
Переопределяет цвет фона элемента.
border
Переопределяет границу элемента.
border-radius
Переопределяет радиус границы элемента.
color-scheme
Указывает, в какой цветовой схеме может быть отображен этот элемент. Подробнее см. документацию по color-scheme . По умолчанию используется color-scheme: light dark .
font-size
Масштабирует весь текст и значки в элементе. Значение по умолчанию — 16px .
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
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)
Аргументы:
Это событие срабатывает при загрузке элемента и отображении его содержимого. Это событие не всплывает.
gmp-select
function(event)
Аргументы:
Это событие вызывается при выборе места из списка. Содержит объект Place , содержащий идентификатор, местоположение и область просмотра выбранного места.

Интерфейс PlaceSearchElementOptions

google.maps.places . PlaceSearchElementOptions

Параметры PlaceSearchElement .

attributionPosition optional
См. PlaceSearchElement.attributionPosition .
orientation optional
Тип: PlaceSearchOrientation optional
См. PlaceSearchElement.orientation .
selectable optional
Тип: boolean optional
См. PlaceSearchElement.selectable
truncationPreferred optional
Тип: boolean optional
См. PlaceSearchElement.truncationPreferred .

Константы PlaceSearchAttributionPosition

google.maps.places . PlaceSearchAttributionPosition

Позиции атрибуции для PlaceSearchElement .

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

BOTTOM Атрибуция внизу PlaceSearchElement
TOP Атрибуция в верхней части PlaceSearchElement

Константы PlaceSearchOrientation

google.maps.places . PlaceSearchOrientation

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

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

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

Класс PlaceSelectEvent

google.maps.places . PlaceSelectEvent

Это событие срабатывает при выборе места из списка. Доступ к выбранному месту осуществляется с помощью event.place .

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

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

place
Тип: Place
Выбранное место.

Класс PlaceNearbySearchRequestElement

google.maps.places . PlaceNearbySearchRequestElement

Настраивает элемент PlaceSearchElement для загрузки результатов на основе поискового запроса поблизости. Для загрузки элемента поиска требуется свойство locationRestriction . Любые другие настроенные свойства будут игнорироваться, если locationRestriction не задано. Добавьте этот элемент как дочерний к элементу PlaceSearchElement для загрузки результатов. Например:

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Пользовательский элемент:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

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

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

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

PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
Параметры:
excludedPrimaryTypes
Тип: Array <string> optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
Тип: Array <string> optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
Тип: Array <string> optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
Тип: Array <string> optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
Тип: Circle | CircleLiteral optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
Тип: number optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
Тип: SearchNearbyRankPreference optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceNearbySearchRequestElementOptions

google.maps.places . PlaceNearbySearchRequestElementOptions

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

excludedPrimaryTypes optional
Тип: Array <string> optional
Исключены основные типы мест. Подробнее см. в разделах PlaceNearbySearchRequestElement.excludedPrimaryTypes и SearchNearbyRequest.excludedPrimaryTypes .
excludedTypes optional
Тип: Array <string> optional
Исключённые типы мест. Подробнее см. в разделах PlaceNearbySearchRequestElement.excludedTypes и SearchNearbyRequest.excludedTypes .
includedPrimaryTypes optional
Тип: Array <string> optional
Включены основные типы мест. Подробнее см. PlaceNearbySearchRequestElement.includedPrimaryTypes и SearchNearbyRequest.includedPrimaryTypes .
includedTypes optional
Тип: Array <string> optional
Включенные типы мест. Дополнительные сведения см. в разделах PlaceNearbySearchRequestElement.includedTypes и SearchNearbyRequest.includedTypes .
locationRestriction optional
Тип: Circle | CircleLiteral optional
Регион для поиска. Дополнительные сведения см. в разделах PlaceNearbySearchRequestElement.locationRestriction и SearchNearbyRequest.locationRestriction .
maxResultCount optional
Тип: number optional
Максимальное количество возвращаемых результатов. Дополнительные сведения см. в разделах PlaceNearbySearchRequestElement.maxResultCount и SearchNearbyRequest.maxResultCount .
rankPreference optional
Тип: SearchNearbyRankPreference optional
Как результаты будут ранжироваться в ответе. Дополнительные сведения см. в разделах PlaceNearbySearchRequestElement.rankPreference и SearchNearbyRankPreference .

Класс PlaceTextSearchRequestElement

google.maps.places . PlaceTextSearchRequestElement

Настраивает PlaceSearchElement для загрузки результатов на основе запроса текстового поиска. Свойство textQuery необходимо для загрузки элемента поиска. Любые другие настроенные свойства будут игнорироваться, если textQuery не установлен. Добавьте этот элемент как дочерний элемент PlaceSearchElement для загрузки результатов. Например:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Пользовательский элемент:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

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

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

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

PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
Параметры:
evConnectorTypes
Тип: Array < EVConnectorType > optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
Тип: number optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
Тип: string optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
Тип: boolean optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
Тип: LatLngBounds | LatLngBoundsLiteral optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
Тип: number optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
Тип: number optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
Тип: Array < PriceLevel > optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
Тип: SearchByTextRankPreference optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
Тип: string optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
Тип: boolean optional
По умолчанию: null
HTML-атрибут:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PlaceTextSearchRequestElementOptions

google.maps.places . PlaceTextSearchRequestElementOptions

Параметры PlaceTextSearchRequestElement .

evConnectorTypes optional
Тип: Array < EVConnectorType > optional
Список предпочтительных типов разъемов EV. Дополнительные сведения см. в разделах SearchByTextRequest.evSearchOptions и PlaceTextSearchRequestElement.evConnectorTypes .
evMinimumChargingRateKw optional
Тип: number optional
Минимальная необходимая мощность зарядки в киловаттах. Дополнительные сведения см. в разделах SearchByTextRequest.evSearchOptions и PlaceTextSearchRequestElement.evMinimumChargingRateKw .
includedType optional
Тип: string optional
Запрошенный тип места. Дополнительные сведения см. в разделах SearchByTextRequest.includedType и PlaceTextSearchRequestElement.includedType .
isOpenNow optional
Тип: boolean optional
Используется для ограничения поиска местами, которые в данный момент открыты. Дополнительные сведения см. в разделах SearchByTextRequest.isOpenNow и PlaceTextSearchRequestElement.isOpenNow .
locationBias optional
Смещение местоположения для поиска. Дополнительные сведения см. в разделах SearchByTextRequest.locationBias и PlaceTextSearchRequestElement.locationBias .
locationRestriction optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Ограничение местоположения для поиска. Дополнительные сведения см. в разделах SearchByTextRequest.locationRestriction и PlaceTextSearchRequestElement.locationRestriction .
maxResultCount optional
Тип: number optional
Максимальное количество возвращаемых результатов. Дополнительные сведения см. в разделах SearchByTextRequest.maxResultCount и PlaceTextSearchRequestElement.maxResultCount .
minRating optional
Тип: number optional
Отфильтровывайте результаты, средний рейтинг пользователей которых строго меньше этого предела. Дополнительные сведения см. в разделах SearchByTextRequest.minRating и PlaceTextSearchRequestElement.minRating .
priceLevels optional
Тип: Array < PriceLevel > optional
Используется для ограничения поиска местами, отмеченными определенными уровнями цен. Дополнительные сведения см. в разделах SearchByTextRequest.priceLevels и PlaceTextSearchRequestElement.priceLevels .
rankPreference optional
Тип: SearchByTextRankPreference optional
Как результаты будут ранжироваться в ответе. Дополнительные сведения см. в разделах SearchByTextRequest.rankPreference и PlaceTextSearchRequestElement.rankPreference .
textQuery optional
Тип: string optional
Текстовый запрос для текстового поиска. Дополнительные сведения см. в разделах SearchByTextRequest.textQuery и PlaceTextSearchRequestElement.textQuery .
useStrictTypeFiltering optional
Тип: boolean optional
Используется для установки строгой фильтрации типов для SearchByTextRequest.includedType . Дополнительные сведения см. в разделах SearchByTextRequest.useStrictTypeFiltering и PlaceTextSearchRequestElement.useStrictTypeFiltering .

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

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
Возвращает поля, которые будут включены в ответ «Поместить в сведения» после успешного получения сведений. Список полей см. PlaceResult .
getPlace
getPlace()
Параметры: нет
Возвращаемое значение: PlaceResult Место, выбранное пользователем.
Возвращает сведения о месте, выбранном пользователем, если данные были успешно получены. В противном случае возвращается объект-заглушка Place со свойством name , равным текущему значению поля ввода.
setBounds
setBounds(bounds)
Параметры:
Возвращаемое значение: нет
Устанавливает предпочтительную область для возврата результатов размещения. Результаты смещены в сторону этой области, но не ограничиваются ею.
setComponentRestrictions
setComponentRestrictions(restrictions)
Параметры:
Возвращаемое значение: нет
Устанавливает ограничения компонента. Ограничения компонентов используются для ограничения прогнозов только теми, которые находятся в родительском компоненте. Например, страна.
setFields
setFields(fields)
Параметры:
  • fields : Array <string> optional
Возвращаемое значение: нет
Задает поля, которые будут включены в ответ «Поместить в подробные сведения» при успешном получении сведений. Список полей см. 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 без определения других свойств.

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

google.maps.places . AutocompleteOptions

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

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Область, в которой нужно искать места.
componentRestrictions optional
Тип: ComponentRestrictions optional
Ограничения компонента. Ограничения компонентов используются для ограничения прогнозов только теми, которые находятся в родительском компоненте. Например, страна.
fields optional
Тип: Array <string> optional
Поля, которые будут включены в ответ «Поместить в сведения» после успешного получения сведений, за которые будет взиматься плата . Если передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ). По умолчанию — ['ALL'] .
placeIdOnly optional
Тип: boolean optional
Следует ли получать только идентификаторы мест. PlaceResult, доступный при запуске события Place_changed, будет содержать только поля Place_id, типы и имя, а Place_id, типы и описание возвращаются службой автозаполнения. По умолчанию отключено.
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
Область, к которой следует смещать прогнозы запроса. Прогнозы ориентированы на запросы, нацеленные на эти границы, но не ограничиваются ими.