Класс PlaceAutocompleteElement
google.maps.places.PlaceAutocompleteElement
класс
PlaceAutocompleteElement – это подкласс HTMLElement, который предоставляет компонент пользовательского интерфейса для API автозаполнения мест.
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Основной тип места (например, "ресторан" или "АЗС").
Место возвращается, только если его основной тип включен в этот список. Можно указать до пяти значений. Если типы не указаны, возвращаются все типы мест. HTML-атрибут:
|
includedRegionCodes |
Тип:
Array<string> optionalВключать в результаты только указанные регионы (не более 15 двухсимвольных кодов регионов CLDR). Если оставить поле пустым, результаты не будут ограничены. Если заданы оба параметра (
locationRestriction и includedRegionCodes), результаты будут находиться в области пересечения.HTML-атрибут:
|
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-атрибут:
|
origin |
Тип:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalТочка отправления, от которой рассчитывается расстояние. Если не указать, расстояние не будет рассчитано. Высота, если она указана, не используется в расчетах.
HTML-атрибут:
|
placeholder |
Тип:
stringТекст-плейсхолдер, который будет показываться в элементе ввода. |
requestedLanguage |
Тип:
string optionalИдентификатор языка, на котором должны быть возвращены результаты (если возможно). Результаты на выбранном языке могут иметь более высокий рейтинг, но рекомендации не ограничиваются этим языком. Вы можете ознакомиться со списком поддерживаемых языков.
HTML-атрибут:
|
requestedRegion |
Тип:
string optionalКод региона, который используется для форматирования и фильтрации результатов. Оно не ограничивает подсказки этой страной. Код региона указывается в виде двух буквенных символов ccTLD (домен верхнего уровня). Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – uk (
.co.uk), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии).HTML-атрибут:
|
unitSystem |
Тип:
UnitSystem optionalСистема единиц измерения, используемая для отображения расстояний. Если не указано, система единиц определяется по requestedRegion.
HTML-атрибут:
|
value |
Тип:
stringЗначение элемента ввода. |
игровые автоматы; | |
|---|---|
prediction-item-icon |
Этот слот принимает ровно один элемент <template>, который будет отображаться как значок рядом с подсказкой. |
Запчасти | |
|---|---|
input |
Элемент ввода для элемента автозаполнения. |
prediction-item |
Элемент в раскрывающемся списке подсказок, представляющий одну подсказку. |
prediction-item-icon |
Значок, отображаемый слева от каждого элемента в списке подсказок. |
prediction-item-main-text |
Часть элемента prediction-item, которая является основным текстом подсказки. В случае географических местоположений она включает название города (например, "Омск") или название улицы и номер дома (например, "Сиреневая, 10"), По умолчанию prediction-item-main-text имеет черный цвет. Если в prediction-item содержит другие слова, они выносятся за пределы элемента prediction-item-main-text и наследуют стиль prediction-item. По умолчанию он имеет серый цвет. Такие дополнительные слова, как правило, являются адресом. |
prediction-item-match |
Часть возвращаемой подсказки, совпадающая с тем, что ввел пользователь. По умолчанию этот совпадающий текст выделяется полужирным шрифтом. Такой элемент может располагаться где угодно внутри prediction-item. и не всегда является частью prediction-item-main-text. |
prediction-item-selected |
Отображение элемента при переходе к нему с помощью клавиатуры. Примечание. На выбранные элементы будут влиять стили как этой части, так и части prediction-item. |
prediction-list |
Графический элемент со списком подсказок, возвращаемых службой Place Autocomplete. Этот раскрывающийся список отображается под элементом PlaceAutocompleteElement. |
Свойства CSS | |
|---|---|
background-color |
Переопределяет цвет фона элемента. |
border |
Переопределяет границу элемента. |
border-radius |
Переопределяет радиус рамки элемента. |
color |
Переопределяет шрифт элемента. |
color-scheme |
Указывает, в какой цветовой схеме может быть показан этот элемент. Подробная информация приведена в документации по color-scheme. Значение по умолчанию – color-scheme: light dark. |
font |
Переопределяет шрифт элемента. |
font-family |
Переопределяет шрифт элемента. |
font-size |
Переопределяет шрифт элемента. |
font-style |
Переопределяет шрифт элемента. |
font-weight |
Переопределяет шрифт элемента. |
line-height |
Переопределяет шрифт элемента. |
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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 |
Тип:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
requestedLanguage optional |
Тип:
string optional |
requestedRegion optional |
Тип:
string optional |
unitSystem optional |
Тип:
UnitSystem optional |
value 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 |
Тип:
PlacePredictionПреобразуйте это в Place, вызвав PlacePrediction.toPlace. |
Класс 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Основной тип места (например, "ресторан" или "АЗС").
Место возвращается, только если его основной тип включен в этот список. Можно указать до пяти значений. Если типы не указаны, возвращаются все типы мест. HTML-атрибут:
|
includedRegionCodes |
Тип:
Array<string> optionalВключать в результаты только указанные регионы (не более 15 двухсимвольных кодов регионов CLDR). Если оставить поле пустым, результаты не будут ограничены. Если заданы оба параметра (
locationRestriction и includedRegionCodes), результаты будут находиться в области пересечения.HTML-атрибут:
|
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-атрибут:
|
origin |
Тип:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalТочка отправления, от которой рассчитывается расстояние. Если не указать, расстояние не будет рассчитано. Высота, если она указана, не используется в расчетах.
HTML-атрибут:
|
requestedLanguage |
Тип:
string optionalИдентификатор языка, на котором должны быть возвращены результаты (если возможно). Результаты на выбранном языке могут иметь более высокий рейтинг, но рекомендации не ограничиваются этим языком. Вы можете ознакомиться со списком поддерживаемых языков.
HTML-атрибут:
|
requestedRegion |
Тип:
string optionalКод региона, который используется для форматирования и фильтрации результатов. Оно не ограничивает подсказки этой страной. Код региона указывается в виде двух буквенных символов ccTLD (домен верхнего уровня). Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – uk (
.co.uk), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии).HTML-атрибут:
|
unitSystem |
Тип:
UnitSystem optionalСистема единиц измерения, используемая для отображения расстояний. Если не указано, система единиц определяется по requestedRegion.
HTML-атрибут:
|
игровые автоматы; | |
|---|---|
prediction-item-icon |
Этот слот принимает ровно один элемент <template>, который будет отображаться как значок рядом с подсказкой. |
Запчасти | |
|---|---|
input |
Элемент ввода для элемента автозаполнения. |
prediction-item |
Элемент в раскрывающемся списке подсказок, представляющий одну подсказку. |
prediction-item-icon |
Значок, отображаемый слева от каждого элемента в списке подсказок. |
prediction-item-main-text |
Часть элемента prediction-item, которая является основным текстом подсказки. В случае географических местоположений она включает название города (например, "Омск") или название улицы и номер дома (например, "Сиреневая, 10"), По умолчанию prediction-item-main-text имеет черный цвет. Если в prediction-item содержит другие слова, они выносятся за пределы элемента prediction-item-main-text и наследуют стиль prediction-item. По умолчанию он имеет серый цвет. Такие дополнительные слова, как правило, являются адресом. |
prediction-item-match |
Часть возвращаемой подсказки, совпадающая с тем, что ввел пользователь. По умолчанию этот совпадающий текст выделяется полужирным шрифтом. Такой элемент может располагаться где угодно внутри prediction-item. и не всегда является частью prediction-item-main-text. |
prediction-item-selected |
Отображение элемента при переходе к нему с помощью клавиатуры. Примечание. На выбранные элементы будут влиять стили как этой части, так и части prediction-item. |
prediction-list |
Графический элемент со списком подсказок, возвращаемых службой Place Autocomplete. Этот раскрывающийся список отображается под элементом PlaceAutocompleteElement. |
Свойства CSS | |
|---|---|
background-color |
Переопределяет цвет фона элемента. |
border |
Переопределяет границу элемента. |
border-radius |
Переопределяет радиус рамки элемента. |
color |
Переопределяет шрифт элемента. |
color-scheme |
Указывает, в какой цветовой схеме может быть показан этот элемент. Подробная информация приведена в документации по color-scheme. Значение по умолчанию – color-scheme: light dark. |
font |
Переопределяет шрифт элемента. |
font-family |
Переопределяет шрифт элемента. |
font-size |
Переопределяет шрифт элемента. |
font-style |
Переопределяет шрифт элемента. |
font-weight |
Переопределяет шрифт элемента. |
line-height |
Переопределяет шрифт элемента. |
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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 |
Тип:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
requestedLanguage optional |
Тип:
string optional |
requestedRegion optional |
Тип:
string optional |
unitSystem optional |
Тип:
UnitSystem optional |
Класс 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> Чтобы использовать этот элемент, включите Places UI Kit API для своего проекта в консоли 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Только для чтения. Объект Place, содержащий идентификатор, местоположение и область просмотра для отображаемого в данный момент места. |
Свойства CSS | |
|---|---|
--gmp-button-border-color |
Цвет границы кнопки "Открыть в Картах". |
--gmp-button-border-radius |
Радиус границы кнопки "Открыть в Картах". |
--gmp-button-border-width |
Толщина границы кнопки "Открыть в Картах". |
--gmp-collage-border-radius-outer |
Радиус границы внешних углов коллажа. |
--gmp-dialog-border-radius |
Радиус границы диалогового окна Google Карт. |
--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 |
Используется для адреса, оценки, типа, цены, статуса "Открыто", часов работы, отзыва, номера телефона, сайта, плюскода, основных особенностей и основного текста в диалоговом окне раскрытия информации в Google Картах. |
--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 |
Масштабирует весь текст и значки в элементе, которые определены внутри в ems. Значение по умолчанию – 16px. |
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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> Чтобы использовать этот элемент, включите Places UI Kit API для своего проекта в консоли 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-атрибут:
|
place |
Тип:
Place optionalТолько для чтения. Объект Place, содержащий идентификатор, местоположение и область просмотра для отображаемого в данный момент места. |
truncationPreferred |
Тип:
booleanПо умолчанию:
false.Если задано значение true, название и адрес места усекаются, чтобы поместиться в одну строку.
HTML-атрибут:
|
Свойства CSS | |
|---|---|
--gmp-button-border-color |
Цвет границы кнопки "Открыть в Картах". |
--gmp-button-border-radius |
Радиус границы кнопки "Открыть в Картах". |
--gmp-button-border-width |
Толщина границы кнопки "Открыть в Картах". |
--gmp-dialog-border-radius |
Радиус границы диалогового окна Google Карт. |
--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 Картах. |
--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 |
Масштабирует весь текст и значки в элементе, которые определены внутри в ems. Значение по умолчанию – 16px. |
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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. |
Константы PlaceDetailsOrientation
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.Объект, идентификатор или название ресурса места, сведения о котором нужно показать в компактном элементе с информацией о месте. Это свойство отражается в атрибуте как название ресурса.
HTML-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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 |
Тип:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalПо умолчанию:
null.Местоположение, для которого нужно показать информацию в элементе Place Details. Нормализуется до
LatLngAltitude.HTML-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidУдаляет из целевого объекта прослушиватель событий, ранее зарегистрированный с помощью addEventListener. Подробнее removeEventListener… |
Интерфейс PlaceDetailsLocationRequestElementOptions
google.maps.places.PlaceDetailsLocationRequestElementOptions
интерфейс
Параметры для игры "PlaceDetailsLocationRequestElement".
Свойства | |
|---|---|
location optional |
Тип:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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> Чтобы использовать элемент поиска мест, включите Places UI Kit API для своего проекта в консоли 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 optionalПо умолчанию:
PlaceSearchAttributionPosition.TOP.Положение логотипа атрибуции и кнопки юридически обязательного раскрытия информации.
HTML-атрибут:
|
orientation |
Тип:
PlaceSearchOrientation optionalПо умолчанию:
PlaceSearchOrientation.VERTICAL.Вариант ориентации элемента (вертикальная или горизонтальная).
HTML-атрибут:
|
places |
Только для чтения. Массив объектов Place, содержащих идентификаторы, местоположения и области просмотра мест, которые отображаются в данный момент. |
selectable |
Тип:
boolean optionalПо умолчанию:
false.Можно ли выбирать элементы списка. Если задано значение true, элементы списка будут кнопками, при нажатии на которые отправляется событие
gmp-select. Также поддерживается навигация и выбор с помощью клавиатуры.HTML-атрибут:
|
truncationPreferred |
Тип:
boolean optionalПо умолчанию:
false.Если задано значение true, некоторые строки контента усекаются, чтобы поместиться в одну строку без переноса.
HTML-атрибут:
|
Свойства CSS | |
|---|---|
--gmp-button-border-color |
Цвет границы кнопки "Открыть в Картах". |
--gmp-button-border-radius |
Радиус границы для кнопки "Открыть в Картах". |
--gmp-button-border-width |
Толщина границы кнопки "Открыть в Картах". |
--gmp-card-border-radius |
Радиус границы для карточек мест. |
--gmp-dialog-border-radius |
Радиус границы для диалогового окна с информацией о Google Картах. |
--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])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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 |
Тип:
PlaceSearchAttributionPosition 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 constants
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-атрибут:
|
excludedTypes |
Тип:
Array<string> optionalПо умолчанию:
null.Исключенные типы мест.
HTML-атрибут:
|
includedPrimaryTypes |
Тип:
Array<string> optionalПо умолчанию:
null.Включенный основной тип места.
HTML-атрибут:
|
includedTypes |
Тип:
Array<string> optionalПо умолчанию:
null.Включенный тип места.
HTML-атрибут:
|
locationRestriction |
Тип:
Circle|CircleLiteral optionalПо умолчанию:
null.Регион, в котором выполняется поиск. Нормализуется до
Circle.HTML-атрибут:
|
maxResultCount |
Тип:
number optionalПо умолчанию:
null.Максимальное число результатов на странице.
HTML-атрибут:
|
rankPreference |
Тип:
SearchNearbyRankPreference optionalПо умолчанию:
null.Как результаты будут ранжироваться в ответе.
HTML-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, 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-атрибут:
|
evMinimumChargingRateKw |
Тип:
number optionalПо умолчанию:
null.Минимальная требуемая скорость зарядки в киловаттах.
HTML-атрибут:
|
includedType |
Тип:
string optionalПо умолчанию:
null.Тип места, указанный в запросе.
HTML-атрибут:
|
isOpenNow |
Тип:
boolean optionalПо умолчанию:
null.Используется для ограничения поиска местами, которые открыты в текущий момент.
HTML-атрибут:
|
locationBias |
Тип:
LocationBias optionalПо умолчанию:
null.Предпочтительное местоположение для поиска. Нормализуется до
LatLngAltitude | LatLngBounds | Circle | string.HTML-атрибут:
|
locationRestriction |
Тип:
LatLngBounds|LatLngBoundsLiteral optionalПо умолчанию:
null.Ограничение местоположения для поиска. Нормализуется до
LatLngBounds.HTML-атрибут:
|
maxResultCount |
Тип:
number optionalПо умолчанию:
null.Максимальное число результатов на странице.
HTML-атрибут:
|
minRating |
Тип:
number optionalПо умолчанию:
null.Фильтровать результаты, средняя оценка которых строго меньше этого ограничения.
HTML-атрибут:
|
priceLevels |
Тип:
Array<PriceLevel> optionalПо умолчанию:
null.Используется для ограничения поиска местами, которые отмечены как имеющие определенный уровень цен.
HTML-атрибут:
|
rankPreference |
Тип:
SearchByTextRankPreference optionalПо умолчанию:
null.Как результаты будут ранжироваться в ответе.
HTML-атрибут:
|
textQuery |
Тип:
string optionalПо умолчанию:
null.Текстовый запрос для текстового поиска.
HTML-атрибут:
|
useStrictTypeFiltering |
Тип:
boolean optionalПо умолчанию:
null.Используется для настройки строгой фильтрации по типу для includedType.
HTML-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidУдаляет из целевого объекта прослушиватель событий, ранее зарегистрированный с помощью addEventListener. Подробнее removeEventListener… |
Интерфейс PlaceTextSearchRequestElementOptions
google.maps.places.PlaceTextSearchRequestElementOptions
интерфейс
Параметры для игры "PlaceTextSearchRequestElement".
Свойства | |
|---|---|
evConnectorTypes optional |
Тип:
Array<EVConnectorType> optionalСписок предпочитаемых типов коннекторов для электромобилей. Подробную информацию можно найти в статьях 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 |
Тип:
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. |
Класс Autocomplete
google.maps.places.Autocomplete
класс
Виджет, который предлагает подсказки мест на основе текста, введенного пользователем. Он прикрепляется к элементу ввода типа text и отслеживает вводимый в это поле текст. Список подсказок представлен в виде раскрывающегося списка и обновляется по мере ввода текста.
Этот класс расширяет MVCObject.
Чтобы получить доступ, позвоните по номеру const {Autocomplete} = await google.maps.importLibrary("places").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
Autocomplete |
Autocomplete(inputField[, opts])Параметры:
Создает новый экземпляр 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)Параметры:
Возвращаемое значение: нет.
Задает поля, которые будут включены в ответ со сведениями о месте, если они будут успешно получены. Список полей приведен в статье о PlaceResult. |
setOptions |
setOptions(options)Параметры:
Возвращаемое значение: нет.
|
setTypes |
setTypes(types)Параметры:
Возвращаемое значение: нет.
Задает типы возвращаемых подсказок. Поддерживаемые типы перечислены в руководстве для разработчиков. Если типы не указаны, будут возвращены все типы. |
Унаследованные:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll.
| |
События | |
|---|---|
place_changed |
function()Аргументы: нет
Это событие срабатывает, когда для выбранного пользователем места становится доступен объект PlaceResult. Если пользователь вводит название места, которое не было предложено элементом управления, и нажимает клавишу Ввод или если запрос информации о местах завершается ошибкой, PlaceResult содержит введенные пользователем данные в свойстве name, а другие свойства не определены. |
Интерфейс AutocompleteOptions
google.maps.places.AutocompleteOptions
интерфейс
Параметры, которые можно задать для объекта Autocomplete.
Свойства | |
|---|---|
bounds optional |
Тип:
LatLngBounds|LatLngBoundsLiteral optionalОбласть, в которой нужно искать места. |
componentRestrictions optional |
Тип:
ComponentRestrictions optionalОграничения для компонента. Ограничения компонентов используются, чтобы подсказки показывались только в родительском компоненте. например страну. |
fields optional |
Тип:
Array<string> optionalПоля, которые должны быть включены в ответ со сведениями о месте, если они успешно получены. За эти поля взимается плата. Если передается ['ALL'], будут возвращены все доступные поля, и за них будет взиматься оплата (не рекомендуется для рабочих развертываний). Список полей приведен в статье о PlaceResult. Вложенные поля можно указать с помощью путей с точками (например, "geometry.location"). По умолчанию используется ['ALL']. |
|
Тип:
boolean optionalУказывает, нужно ли получать только идентификаторы мест. Объект PlaceResult, который становится доступным при запуске события place_changed, будет содержать только поля place_id, types и name, а также значения place_id, types и description, возвращенные сервисом автозаполнения. По умолчанию выключена. |
strictBounds optional |
Тип:
boolean optionalЛогическое значение, указывающее, что виджет Autocomplete должен возвращать только те места, которые находятся в его границах на момент отправки запроса. Если для параметра strictBounds задано значение false (по умолчанию), результаты будут подбираться с учетом указанной области, но не ограничиваться ей. |
types optional |
Тип:
Array<string> optionalТипы возвращаемых подсказок. Поддерживаемые типы перечислены в руководстве для разработчиков. Если типы не указаны, будут возвращены все типы. |
Класс SearchBox
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Область, для которой нужно показывать подсказки. Подсказки подбираются с учетом этой области, но не ограничиваются ей. |
Класс PlaceContextualElement
google.maps.places.PlaceContextualElement
класс
Виджет, который использует токен контекста, чтобы показывать контекстный виджет ответа обоснования с Google Картами.
Специальный элемент:
<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-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidУдаляет из целевого объекта прослушиватель событий, ранее зарегистрированный с помощью addEventListener. Подробнее removeEventListener… |
Интерфейс PlaceContextualElementOptions
google.maps.places.PlaceContextualElementOptions
интерфейс
Параметры для игры "PlaceContextualElement".
Свойства | |
|---|---|
contextToken optional |
Тип:
string optionalТокен контекста, предоставленный в ответе функции обоснования с Google Картами. |
Класс 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…
Конструктор | |
|---|---|
PlaceContextualListConfigElement |
PlaceContextualListConfigElement([options])Параметры:
|
Свойства | |
|---|---|
layout |
Тип:
PlaceContextualListLayout optionalМакет.
HTML-атрибут:
|
mapHidden |
Тип:
boolean optionalСкрыта ли карта.
HTML-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidУдаляет из целевого объекта прослушиватель событий, ранее зарегистрированный с помощью addEventListener. Подробнее removeEventListener… |
Интерфейс PlaceContextualListConfigElementOptions
google.maps.places.PlaceContextualListConfigElementOptions
интерфейс
Параметры для PlaceContextualListConfigElement.
Свойства | |
|---|---|
layout optional |
Тип:
PlaceContextualListLayout optionalПо умолчанию:
PlaceContextualListLayout.VERTICAL.Макет. |
mapHidden optional |
Тип:
boolean optionalПо умолчанию:
false.True, если карта должна быть скрыта. |
PlaceContextualListLayout
google.maps.places.PlaceContextualListLayout
константы
Список макетов, которые поддерживает контекстный элемент места для просмотра списка.
Чтобы получить доступ, позвоните по номеру const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
Подробнее о библиотеках Maps JavaScript API…
Константы | |
|---|---|
COMPACT |
Компактный список. Элементы списка отображаются в виде ссылок в одной строке, а остальные – в раскрывающемся списке. |
VERTICAL |
Вертикальный список. Элементы списка отображаются в виде карточек в вертикальном списке. |