Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Places Widgets

Класс PlaceAutocompleteElement

class google.maps.places.PlaceAutocompleteElement extends HTMLElement implements PlaceAutocompleteElementOptions
library "places"

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
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-place-autocomplete>

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceAutocompleteElement`	`PlaceAutocompleteElement([options])` Параметры: `options: PlaceAutocompleteElementOptions optional`

Свойства
`description` attr: description	Тип: `string optional` Описание, которое будет использоваться для элемента ввода. Программа чтения с экрана обнаружит его, когда элемент ввода будет в фокусе. Подробнее: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby. HTML-атрибут: `description="string"`
`disabled` attr: disabled	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Указывает, отключен ли элемент ввода. Подробнее: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled. HTML-атрибут: `disabled`
`futureOpeningBusinessesIncluded` attr: future-opening-businesses-included	Тип: `boolean optional` Указывает, нужно ли включать места, которые ещё не открыты, но должны открыться в будущем. HTML-атрибут: `future-opening-businesses-included`
`includedPrimaryTypes` attr: included-primary-types	Тип: `Array<string> optional` Основной тип места (например, "ресторан" или "АЗС"). Место возвращается, только если его основной тип включен в этот список. Можно указать до пяти значений. Если типы не указаны, возвращаются все типы мест. HTML-атрибут: `included-primary-types="type1 type2 type3..."`
`includedRegionCodes` attr: included-region-codes	Тип: `Array<string> optional` Включать в результаты только указанные регионы (не более 15 двухсимвольных кодов регионов CLDR). Если оставить поле пустым, результаты не будут ограничены. Если заданы оба параметра (`locationRestriction` и `includedRegionCodes`), результаты будут находиться в области пересечения. HTML-атрибут: `included-region-codes="c1 c2 c3..."`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`locationBias`	Тип: `LocationBias optional` Мягкая граница или подсказка, которую следует использовать при поиске мест.
`locationRestriction`	Тип: `LocationRestriction optional` Границы для ограничения результатов поиска.
`maxlength` attr: maxlength	Тип: `number optional` Максимальное количество символов, которое может ввести пользователь. Подробнее: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength. HTML-атрибут: `maxlength="number"`
`name` attr: 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-атрибут: `name="string"`
`noClearButton` attr: no-clear-button	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Скрывать ли кнопку очистки. HTML-атрибут: `no-clear-button`
`noInputIcon` attr: no-input-icon	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Скрывать ли значок ввода. HTML-атрибут: `no-input-icon`
`origin` attr: origin	Тип входных данных: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Тип выходных данных: `LatLngAltitude optional` Точка отправления, от которой рассчитывается расстояние. Если не указать, расстояние не будет рассчитано. Высота, если она указана, не используется в расчетах. HTML-атрибут: `origin="lat,lng"` `origin="lat,lng,altitude"`
`placeholder` attr: placeholder	Тип: `string optional` Текст-плейсхолдер, который будет использоваться для элемента ввода. Подробную информацию можно найти на странице https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder. HTML-атрибут: `placeholder="string"`
`pureServiceAreaBusinessesIncluded` attr: pure-service-area-businesses-included	Тип: `boolean optional` Указывает, нужно ли включать места, которые являются исключительно компаниями, обслуживающими определенную территорию. HTML-атрибут: `pure-service-area-businesses-included`
`readonly` attr: readonly	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Доступен ли элемент ввода только для чтения. Подробнее: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly. HTML-атрибут: `readonly`
`requestedLanguage` attr: requested-language	Тип: `string optional` Идентификатор языка, на котором должны быть возвращены результаты (если возможно). Результаты на выбранном языке могут иметь более высокий рейтинг, но рекомендации не ограничиваются этим языком. Вы можете ознакомиться со списком поддерживаемых языков. HTML-атрибут: `requested-language="string"`
`requestedRegion` attr: requested-region	Тип: `string optional` Код региона, который используется для форматирования и фильтрации результатов. Оно не ограничивает подсказки этой страной. Код региона указывается в виде двух буквенных символов ccTLD (домен верхнего уровня). Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – uk (`.co.uk`), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии). HTML-атрибут: `requested-region="string"`
`unitSystem` attr: unit-system	Тип входных данных: `UnitSystem optional` Тип выходных данных: `UnitSystem optional` Система единиц измерения, используемая для отображения расстояний. Если не указано, система единиц определяется по requestedRegion. HTML-атрибут: `unit-system="value-name"`
`value`	Тип входных данных: `string optional` Тип выходных данных: `string` Значение элемента ввода.

игровые автоматы;
`clear-icon`	Размещает элемент с атрибутом slot в позиции значка очистки. Кнопка очистки показывается в конце поля ввода, если в нем есть текст.
`input-icon`	Помещает элемент с атрибутом slot в позицию значка ввода. Значок ввода отображается в начале поля ввода во встроенном режиме.
`prediction-item-icon`	Этот слот принимает ровно один элемент `<template>`, который будет отображаться как значок рядом с подсказкой.

Запчасти
`focus-ring`	Элемент, который используется для показа кольца фокуса вокруг выбранного элемента (ввода или подсказки).
`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-main-text.
`prediction-item-nonmatch`	Часть основного текста подсказки, которая не соответствует введенным данным.
`prediction-item-secondary-text`	Часть элемента prediction-item – дополнительный текст подсказки. Обычно дополнительный текст представляет собой адрес.
`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`, `removeEventListener`

События
`gmp-error`	`function(errorEvent)` Аргументы: `errorEvent: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-select`	`function(placePredictionSelectEvent)` Аргументы: `placePredictionSelectEvent: PlacePredictionSelectEvent optional` Это событие срабатывает, когда пользователь выбирает подсказку места. Содержит объект PlacePrediction, который можно преобразовать в объект Place.

Интерфейс PlaceAutocompleteElementOptions

интерфейс google.maps.places.PlaceAutocompleteElementOptions
реализован PlaceAutocompleteElement

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

Свойства
`description` необязательно	Тип: `string optional` Описание, которое будет использоваться для элемента ввода. Программа чтения с экрана обнаружит его, когда элемент ввода будет в фокусе.
`disabled` необязательно	Тип: `boolean optional`
`futureOpeningBusinessesIncluded` необязательно	Тип: `boolean optional`
`includedPrimaryTypes` необязательно	Тип: `Array<string> optional`
`includedRegionCodes` необязательно	Тип: `Array<string> optional`
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional`
`locationBias` необязательно	Тип: `LocationBias optional`
`locationRestriction` необязательно	Тип: `LocationRestriction optional`
`maxlength` необязательно	Тип: `number optional`
`name` необязательно	Тип: `string optional`
`noClearButton` необязательно	Тип: `boolean optional`
`noInputIcon` необязательно	Тип: `boolean optional`
`origin` необязательно	Тип: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`placeholder` необязательно	Тип: `string optional`
`pureServiceAreaBusinessesIncluded` необязательно	Тип: `boolean optional`
`readonly` необязательно	Тип: `boolean optional`
`requestedLanguage` необязательно	Тип: `string optional`
`requestedRegion` необязательно	Тип: `string optional`
`unitSystem` необязательно	Тип: `UnitSystem optional`
`value` необязательно	Тип: `string optional` Значение элемента ввода.

Класс PlacePredictionSelectEvent

class google.maps.places.PlacePredictionSelectEvent extends Event
library "places"

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

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

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places");

Свойства
`placePrediction` readonly	Тип: `PlacePrediction` Преобразуйте это в `Place`, вызвав `PlacePrediction.toPlace`.

Класс BasicPlaceAutocompleteElement

class google.maps.places.BasicPlaceAutocompleteElement extends HTMLElement implements BasicPlaceAutocompleteElementOptions
library "places"

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

<gmp-basic-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-basic-place-autocomplete>

const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places");

Конструктор
`BasicPlaceAutocompleteElement`	`BasicPlaceAutocompleteElement([options])` Параметры: `options: BasicPlaceAutocompleteElementOptions optional`

Свойства
`description` attr: description	Тип: `string optional` Описание, которое будет использоваться для элемента ввода. Программа чтения с экрана обнаружит его, когда элемент ввода будет в фокусе. Подробнее: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby. HTML-атрибут: `description="string"`
`disabled` attr: disabled	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Указывает, отключен ли элемент ввода. Подробнее: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled. HTML-атрибут: `disabled`
`futureOpeningBusinessesIncluded` attr: future-opening-businesses-included	Тип: `boolean optional` Указывает, нужно ли включать места, которые ещё не открыты, но должны открыться в будущем. HTML-атрибут: `future-opening-businesses-included`
`includedPrimaryTypes` attr: included-primary-types	Тип: `Array<string> optional` Основной тип места (например, "ресторан" или "АЗС"). Место возвращается, только если его основной тип включен в этот список. Можно указать до пяти значений. Если типы не указаны, возвращаются все типы мест. HTML-атрибут: `included-primary-types="type1 type2 type3..."`
`includedRegionCodes` attr: included-region-codes	Тип: `Array<string> optional` Включать в результаты только указанные регионы (не более 15 двухсимвольных кодов регионов CLDR). Если оставить поле пустым, результаты не будут ограничены. Если заданы оба параметра (`locationRestriction` и `includedRegionCodes`), результаты будут находиться в области пересечения. HTML-атрибут: `included-region-codes="c1 c2 c3..."`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`locationBias`	Тип: `LocationBias optional` Мягкая граница или подсказка, которую следует использовать при поиске мест.
`locationRestriction`	Тип: `LocationRestriction optional` Границы для ограничения результатов поиска.
`maxlength` attr: maxlength	Тип: `number optional` Максимальное количество символов, которое может ввести пользователь. Подробнее: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength. HTML-атрибут: `maxlength="number"`
`name` attr: 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-атрибут: `name="string"`
`noClearButton` attr: no-clear-button	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Скрывать ли кнопку очистки. HTML-атрибут: `no-clear-button`
`noInputIcon` attr: no-input-icon	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Скрывать ли значок ввода. HTML-атрибут: `no-input-icon`
`origin` attr: origin	Тип входных данных: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Тип выходных данных: `LatLngAltitude optional` Точка отправления, от которой рассчитывается расстояние. Если не указать, расстояние не будет рассчитано. Высота, если она указана, не используется в расчетах. HTML-атрибут: `origin="lat,lng"` `origin="lat,lng,altitude"`
`placeholder` attr: placeholder	Тип: `string optional` Текст-плейсхолдер, который будет использоваться для элемента ввода. Подробную информацию можно найти на странице https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder. HTML-атрибут: `placeholder="string"`
`pureServiceAreaBusinessesIncluded` attr: pure-service-area-businesses-included	Тип: `boolean optional` Указывает, нужно ли включать места, которые являются исключительно компаниями, обслуживающими определенную территорию. HTML-атрибут: `pure-service-area-businesses-included`
`readonly` attr: readonly	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Доступен ли элемент ввода только для чтения. Подробнее: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly. HTML-атрибут: `readonly`
`requestedLanguage` attr: requested-language	Тип: `string optional` Идентификатор языка, на котором должны быть возвращены результаты (если возможно). Результаты на выбранном языке могут иметь более высокий рейтинг, но рекомендации не ограничиваются этим языком. Вы можете ознакомиться со списком поддерживаемых языков. HTML-атрибут: `requested-language="string"`
`requestedRegion` attr: requested-region	Тип: `string optional` Код региона, который используется для форматирования и фильтрации результатов. Оно не ограничивает подсказки этой страной. Код региона указывается в виде двух буквенных символов ccTLD (домен верхнего уровня). Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – uk (`.co.uk`), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии). HTML-атрибут: `requested-region="string"`
`unitSystem` attr: unit-system	Тип входных данных: `UnitSystem optional` Тип выходных данных: `UnitSystem optional` Система единиц измерения, используемая для отображения расстояний. Если не указано, система единиц определяется по requestedRegion. HTML-атрибут: `unit-system="value-name"`

игровые автоматы;
`clear-icon`	Размещает элемент с атрибутом slot в позиции значка очистки. Кнопка очистки показывается в конце поля ввода, если в нем есть текст.
`input-icon`	Помещает элемент с атрибутом slot в позицию значка ввода. Значок ввода отображается в начале поля ввода во встроенном режиме.
`prediction-item-icon`	Этот слот принимает ровно один элемент `<template>`, который будет отображаться как значок рядом с подсказкой.

Запчасти
`focus-ring`	Элемент, который используется для показа кольца фокуса вокруг выбранного элемента (ввода или подсказки).
`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-main-text.
`prediction-item-nonmatch`	Часть основного текста подсказки, которая не соответствует введенным данным.
`prediction-item-secondary-text`	Часть элемента prediction-item – дополнительный текст подсказки. Обычно дополнительный текст представляет собой адрес.
`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`, `removeEventListener`

События
`gmp-error`	`function(errorEvent)` Аргументы: `errorEvent: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-select`	`function(placeSelectEvent)` Аргументы: `placeSelectEvent: PlaceSelectEvent optional` Это событие срабатывает, когда пользователь выбирает подсказку места. Содержит объект Place.

Интерфейс BasicPlaceAutocompleteElementOptions

интерфейс google.maps.places.BasicPlaceAutocompleteElementOptions
реализован BasicPlaceAutocompleteElement

Параметры для создания BasicPlaceAutocompleteElement.

Свойства
`description` необязательно	Тип: `string optional` Описание, которое будет использоваться для элемента ввода. Программа чтения с экрана обнаружит его, когда элемент ввода будет в фокусе.
`disabled` необязательно	Тип: `boolean optional`
`futureOpeningBusinessesIncluded` необязательно	Тип: `boolean optional`
`includedPrimaryTypes` необязательно	Тип: `Array<string> optional`
`includedRegionCodes` необязательно	Тип: `Array<string> optional`
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional`
`locationBias` необязательно	Тип: `LocationBias optional`
`locationRestriction` необязательно	Тип: `LocationRestriction optional`
`maxlength` необязательно	Тип: `number optional`
`name` необязательно	Тип: `string optional`
`noClearButton` необязательно	Тип: `boolean optional`
`noInputIcon` необязательно	Тип: `boolean optional`
`origin` необязательно	Тип: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`placeholder` необязательно	Тип: `string optional`
`pureServiceAreaBusinessesIncluded` необязательно	Тип: `boolean optional`
`readonly` необязательно	Тип: `boolean optional`
`requestedLanguage` необязательно	Тип: `string optional`
`requestedRegion` необязательно	Тип: `string optional`
`unitSystem` необязательно	Тип: `UnitSystem optional`

Класс PlaceDetailsElement

class google.maps.places.PlaceDetailsElement extends HTMLElement implements PlaceDetailsElementOptions
extended by AdvancedPlaceDetailsElement
library "places"

Показывает подробные сведения о месте в полном макете. Добавьте 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
  internal-usage-attribution-ids="space separated strings">
</gmp-place-details>

const {PlaceDetailsElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceDetailsElement`	`PlaceDetailsElement([options])` Параметры: `options: PlaceDetailsElementOptions optional`

Свойства

internalUsageAttributionIds
attr: internal-usage-attribution-ids

Тип входных данных: Iterable<string> optional
Тип выходных данных: Array<string> optional

Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.

HTML-атрибут: internal-usage-attribution-ids="space separated strings"

place
readonly

Тип: 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`, `removeEventListener`

События
`gmp-error`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-load`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда элемент загружает и отображает свой контент. Это событие не всплывает.

Интерфейс PlaceDetailsElementOptions

интерфейс google.maps.places.PlaceDetailsElementOptions
расширен AdvancedPlaceDetailsElementOptions
реализован AdvancedPlaceDetailsElement, PlaceDetailsElement

Параметры для игры "PlaceDetailsElement".

Свойства
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.

Класс PlaceDetailsCompactElement

class google.maps.places.PlaceDetailsCompactElement extends HTMLElement implements PlaceDetailsCompactElementOptions
extended by AdvancedPlaceDetailsCompactElement
library "places"

Показывает сведения о месте в компактном формате. Добавьте 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
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  truncation-preferred>
</gmp-place-details-compact>

const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceDetailsCompactElement`	`PlaceDetailsCompactElement([options])` Параметры: `options: PlaceDetailsCompactElementOptions optional`

Свойства
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Тип: `PlaceDetailsOrientation optional` По умолчанию: `PlaceDetailsOrientation.VERTICAL`. Вариант ориентации элемента (вертикальная или горизонтальная). HTML-атрибут: `orientation="value-name"`
`place` readonly	Тип: `Place optional` Только для чтения. Объект Place, содержащий идентификатор, местоположение и область просмотра для отображаемого в данный момент места.
`truncationPreferred` attr: truncation-preferred	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Если задано значение true, название и адрес места усекаются, чтобы поместиться в одну строку. HTML-атрибут: `truncation-preferred`

Свойства 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`, `removeEventListener`

События
`gmp-error`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-load`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда элемент загружает и отображает свой контент. Это событие не всплывает.

Интерфейс PlaceDetailsCompactElementOptions

интерфейс google.maps.places.PlaceDetailsCompactElementOptions
расширен AdvancedPlaceDetailsCompactElementOptions
реализован AdvancedPlaceDetailsCompactElement, PlaceDetailsCompactElement

Параметры для игры "PlaceDetailsCompactElement".

Свойства
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.
`orientation` необязательно	Тип: `PlaceDetailsOrientation optional` Посмотрите `PlaceDetailsCompactElement.orientation`.
`truncationPreferred` необязательно	Тип: `boolean optional` Посмотрите `PlaceDetailsCompactElement.truncationPreferred`.

Класс AdvancedPlaceDetailsElement

class google.maps.places.AdvancedPlaceDetailsElement extends PlaceDetailsElement, HTMLElement implements AdvancedPlaceDetailsElementOptions, PlaceDetailsElementOptions
library "places"

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

Пример:

 <gmp-advanced-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-standard-content>
   </gmp-place-standard-content>
 </gmp-advanced-place-details>

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

<gmp-advanced-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details>

const {AdvancedPlaceDetailsElement} = await google.maps.importLibrary("places");

Конструктор
`AdvancedPlaceDetailsElement`	`AdvancedPlaceDetailsElement([options])` Параметры: `options: AdvancedPlaceDetailsElementOptions optional`

Свойства

internalUsageAttributionIds
attr: internal-usage-attribution-ids

Тип входных данных: Iterable<string> optional
Тип выходных данных: Array<string> optional

Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.

HTML-атрибут: internal-usage-attribution-ids="space separated strings"

place
readonly

Тип: Place optional

игровые автоматы;
`action-corner`	Интервал для `PlaceLinkElement` и `PlaceButtonElement`.
`action-main`	Интервал для `PlaceLinkElement` и `PlaceButtonElement`.
`basic-section-bottom`	Примечание. Доступно только в альфа-версии. Область для пользовательского HTML-контента, который показывается внизу раздела с основной информацией, прямо под командными кнопками.
`basic-section-top`	Примечание. Доступно только в альфа-версии. Слот для пользовательского HTML-контента, отображаемого в разделе основной информации, непосредственно над названием места.

Свойства CSS
Унаследованные: `--gmp-button-border-color`, `--gmp-button-border-radius`, `--gmp-button-border-width`, `--gmp-collage-border-radius-outer`, `--gmp-dialog-border-radius`, `--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`, `--gmp-mat-color-secondary-container`, `--gmp-mat-color-surface`, `--gmp-mat-font-body-medium`, `--gmp-mat-font-body-small`, `--gmp-mat-font-display-small`, `--gmp-mat-font-family`, `--gmp-mat-font-headline-medium`, `--gmp-mat-font-label-large`, `--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`, `font-size`.

Свойства CSS

Унаследованные: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-collage-border-radius-outer, --gmp-dialog-border-radius, --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, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-display-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --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, font-size.

Методы
Унаследованные: `addEventListener`, `removeEventListener`

События
Унаследованные: `gmp-error`, `gmp-load`

Интерфейс AdvancedPlaceDetailsElementOptions

interface google.maps.places.AdvancedPlaceDetailsElementOptions extends PlaceDetailsElementOptions
implemented by AdvancedPlaceDetailsElement

Параметры для игры "AdvancedPlaceDetailsElement".

Свойства
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.

Класс AdvancedPlaceDetailsCompactElement

class google.maps.places.AdvancedPlaceDetailsCompactElement extends PlaceDetailsCompactElement, HTMLElement implements AdvancedPlaceDetailsCompactElementOptions, PlaceDetailsCompactElementOptions
library "places"

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

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

<gmp-advanced-place-details-compact
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details-compact>

const {AdvancedPlaceDetailsCompactElement} = await google.maps.importLibrary("places");

Конструктор
`AdvancedPlaceDetailsCompactElement`	`AdvancedPlaceDetailsCompactElement([options])` Параметры: `options: AdvancedPlaceDetailsCompactElementOptions optional`

Свойства
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	Тип: `Place optional` Только для чтения. Объект Place, содержащий идентификатор, местоположение и область просмотра для отображаемого в данный момент места.
Унаследовано: `orientation` (атрибут: `orientation`), `truncationPreferred` (атрибут: `truncation-preferred`)

игровые автоматы;
`action-corner`	Интервал для `PlaceLinkElement` и `PlaceButtonElement`.
`action-main`	Интервал для `PlaceLinkElement` и `PlaceButtonElement`.
`basic-section-bottom`	Примечание. Доступно только в альфа-версии. Область для пользовательского HTML-контента, который показывается внизу раздела с основной информацией, прямо под командными кнопками.
`basic-section-top`	Примечание. Доступно только в альфа-версии. Слот для пользовательского HTML-контента, отображаемого в разделе основной информации, непосредственно над названием места.

Свойства CSS
Наследуемые: `--gmp-button-border-color`, `--gmp-button-border-radius`, `--gmp-button-border-width`, `--gmp-dialog-border-radius`, `--gmp-mat-color-info`, `--gmp-mat-color-negative`, `--gmp-mat-color-neutral-container`, `--gmp-mat-color-on-secondary-container`, `--gmp-mat-color-on-surface`, `--gmp-mat-color-on-surface-variant`, `--gmp-mat-color-outline-decorative`, `--gmp-mat-color-positive`, `--gmp-mat-color-primary`, `--gmp-mat-color-secondary-container`, `--gmp-mat-color-surface`, `--gmp-mat-font-body-medium`, `--gmp-mat-font-body-small`, `--gmp-mat-font-family`, `--gmp-mat-font-headline-medium`, `--gmp-mat-font-label-large`, `--gmp-mat-font-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`, `font-size`

Свойства CSS

Наследуемые: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-dialog-border-radius, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-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, font-size

Методы
Унаследованные: `addEventListener`, `removeEventListener`

События
Унаследованные: `gmp-error`, `gmp-load`

Интерфейс AdvancedPlaceDetailsCompactElementOptions

interface google.maps.places.AdvancedPlaceDetailsCompactElementOptions extends PlaceDetailsCompactElementOptions
implemented by AdvancedPlaceDetailsCompactElement

Параметры для игры "AdvancedPlaceDetailsCompactElement".

Свойства
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.
Унаследованные: `orientation`, `truncationPreferred`

Константы PlaceDetailsOrientation

константы google.maps.places.PlaceDetailsOrientation
библиотека "places"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом PlaceDetailsOrientationString.

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places");

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

Класс PlaceDetailsPlaceRequestElement

class google.maps.places.PlaceDetailsPlaceRequestElement extends HTMLElement implements PlaceDetailsPlaceRequestElementOptions
library "places"

Настраивает 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="places/###">
</gmp-place-details-place-request>

const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceDetailsPlaceRequestElement`	`PlaceDetailsPlaceRequestElement([options])` Параметры: `options: PlaceDetailsPlaceRequestElementOptions optional`

Свойства
`place` attr: place	Тип входных данных: `Place\|string optional` Тип выходных данных: `Place optional` По умолчанию: `null`. Объект, идентификатор или название ресурса места, сведения о котором нужно показать в компактном элементе с информацией о месте. Это свойство отражается в атрибуте как название ресурса. HTML-атрибут: `place="places/###"`

Свойства

place
attr: place

Тип входных данных: Place|string optional
Тип выходных данных: Place optional

По умолчанию: null.

Объект, идентификатор или название ресурса места, сведения о котором нужно показать в компактном элементе с информацией о месте. Это свойство отражается в атрибуте как название ресурса.

HTML-атрибут: place="places/###"

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceDetailsPlaceRequestElementOptions

интерфейс google.maps.places.PlaceDetailsPlaceRequestElementOptions
реализован PlaceDetailsPlaceRequestElement

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

Свойства
`place` необязательно	Тип: `Place\|string optional` Посмотреть: `PlaceDetailsPlaceRequestElement.place`

Класс PlaceDetailsLocationRequestElement

class google.maps.places.PlaceDetailsLocationRequestElement extends HTMLElement implements PlaceDetailsLocationRequestElementOptions
library "places"

Позволяет настроить загрузку данных в 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>

const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceDetailsLocationRequestElement`	`PlaceDetailsLocationRequestElement([options])` Параметры: `options: PlaceDetailsLocationRequestElementOptions optional`

Свойства
`location` attr: location	Тип входных данных: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Тип выходных данных: `LatLngAltitude optional` По умолчанию: `null`. Местоположение, для которого нужно показать информацию в элементе Place Details. Нормализуется до `LatLngAltitude`. HTML-атрибут: `location="lat,lng"`

Свойства

location
attr: location

Тип входных данных: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Тип выходных данных: LatLngAltitude optional

По умолчанию: null.

Местоположение, для которого нужно показать информацию в элементе Place Details. Нормализуется до LatLngAltitude.

HTML-атрибут: location="lat,lng"

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceDetailsLocationRequestElementOptions

интерфейс google.maps.places.PlaceDetailsLocationRequestElementOptions
реализован PlaceDetailsLocationRequestElement

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

Свойства
`location` необязательно	Тип: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Местоположение, для которого нужно показать место.

Класс PlaceSearchElement

class google.maps.places.PlaceSearchElement extends HTMLElement implements PlaceSearchElementOptions
extended by AdvancedPlaceSearchElement
library "places"

Отображает результаты поиска мест в виде списка. Добавьте 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="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-place-search>

const {PlaceSearchElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceSearchElement`	`PlaceSearchElement([options])` Параметры: `options: PlaceSearchElementOptions optional`

Свойства
`attributionPosition` attr: attribution-position	Тип входных данных: `PlaceSearchAttributionPosition optional` Тип выходных данных: `PlaceSearchAttributionPosition` По умолчанию: `PlaceSearchAttributionPosition.TOP`. Положение логотипа атрибуции и кнопки юридически обязательного раскрытия информации. HTML-атрибут: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Тип входных данных: `PlaceSearchOrientation optional` Тип выходных данных: `PlaceSearchOrientation` По умолчанию: `PlaceSearchOrientation.VERTICAL`. Вариант ориентации элемента (вертикальная или горизонтальная). HTML-атрибут: `orientation="value-name"`
`places` readonly	Тип: `Array<Place>` Только для чтения. Массив объектов `Place`, содержащих идентификаторы, местоположения и области просмотра мест, которые отображаются в данный момент.
`selectable` attr: selectable	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Можно ли выбирать элементы списка. Если задано значение true, элементы списка будут кнопками, при нажатии на которые отправляется событие `gmp-select`. Также поддерживается навигация и выбор с помощью клавиатуры. HTML-атрибут: `selectable`
`truncationPreferred` attr: truncation-preferred	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Если задано значение true, некоторые строки контента усекаются, чтобы поместиться в одну строку без переноса. HTML-атрибут: `truncation-preferred`

Свойства 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`, `removeEventListener`

События
`gmp-error`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-load`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда элемент загружает и отображает свой контент. Это событие не всплывает.
`gmp-select`	`function(event)` Аргументы: `event: PlaceSelectEvent optional` Это событие активируется, когда пользователь выбирает место из списка. Содержит объект `Place` с идентификатором, местоположением и областью просмотра выбранного места.

Интерфейс PlaceSearchElementOptions

интерфейс google.maps.places.PlaceSearchElementOptions
расширен AdvancedPlaceSearchElementOptions
реализован AdvancedPlaceSearchElement, PlaceSearchElement

Параметры для игры "PlaceSearchElement".

Свойства
`attributionPosition` необязательно	Тип: `PlaceSearchAttributionPosition optional` Посмотрите `PlaceSearchElement.attributionPosition`.
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.
`orientation` необязательно	Тип: `PlaceSearchOrientation optional` Посмотрите `PlaceSearchElement.orientation`.
`selectable` необязательно	Тип: `boolean optional` Посмотреть: `PlaceSearchElement.selectable`
`truncationPreferred` необязательно	Тип: `boolean optional` Посмотрите `PlaceSearchElement.truncationPreferred`.

Класс PlaceItemElement

class google.maps.places.PlaceItemElement extends HTMLElement implements PlaceItemElementOptions
extended by AdvancedPlaceItemElement
library "places"

Общедоступный веб-компонент-контейнер (<gmp-place-item>) для элементов списка мест. Настраиваемый элемент <gmp-place-item> отображает карточку с результатом поиска места внутри <gmp-place-search>. Каждый элемент <gmp-place-item> показывает информацию о месте, состоящую из дочерних визуальных компонентов Places UI Kit.

<gmp-place-item></gmp-place-item>

const {PlaceItemElement} = await google.maps.importLibrary("places");

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceItemElementOptions

интерфейс google.maps.places.PlaceItemElementOptions
расширен AdvancedPlaceItemElementOptions
реализован AdvancedPlaceItemElement, PlaceItemElement

Параметры для игры "PlaceItemElement".

Класс AdvancedPlaceSearchElement

class google.maps.places.AdvancedPlaceSearchElement extends PlaceSearchElement, HTMLElement implements AdvancedPlaceSearchElementOptions, PlaceSearchElementOptions
library "places"

Показывает результаты расширенного поиска мест в виде списка. Добавьте PlaceTextSearchRequestElement или PlaceNearbySearchRequestElement, чтобы указать запрос, для которого нужно показать результаты. Добавьте PlaceStandardContentElement, PlaceAllContentElement или <template slot="details-item">, чтобы указать, какой контент нужно отобразить.

Пример:

 <gmp-advanced-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-search>

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

<gmp-advanced-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-advanced-place-search>

const {AdvancedPlaceSearchElement} = await google.maps.importLibrary("places");

Конструктор
`AdvancedPlaceSearchElement`	`AdvancedPlaceSearchElement([options])` Параметры: `options: AdvancedPlaceSearchElementOptions optional`

Свойства
`attributionPosition` attr: attribution-position	Тип входных данных: `PlaceSearchAttributionPosition optional` Тип выходных данных: `PlaceSearchAttributionPosition` По умолчанию: `PlaceSearchAttributionPosition.TOP`. Положение логотипа атрибуции и кнопки юридически обязательного раскрытия информации. HTML-атрибут: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Тип входных данных: `PlaceSearchOrientation optional` Тип выходных данных: `PlaceSearchOrientation` По умолчанию: `PlaceSearchOrientation.VERTICAL`. Вариант ориентации элемента (вертикальная или горизонтальная). HTML-атрибут: `orientation="value-name"`
`selectable` attr: selectable	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Можно ли выбирать элементы списка. Если задано значение true, элементы списка будут кнопками, при нажатии на которые отправляется событие `gmp-select`. Также поддерживается навигация и выбор с помощью клавиатуры. HTML-атрибут: `selectable`
`truncationPreferred` attr: truncation-preferred	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Если задано значение true, некоторые строки контента усекаются, чтобы поместиться в одну строку без переноса. HTML-атрибут: `truncation-preferred`
Унаследованные: `places`

игровые автоматы;
`details-item`	HTML-шаблон, содержащий виджеты gmp-place, которые будут отображаться для каждого места в результатах поиска.

Свойства 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`, `removeEventListener`

События
`gmp-error`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-load`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда элемент загружает и отображает свой контент. Это событие не всплывает.
`gmp-select`	`function(event)` Аргументы: `event: PlaceSelectEvent optional` Это событие активируется, когда пользователь выбирает место из списка. Содержит объект `Place` с идентификатором, местоположением и областью просмотра выбранного места.

Интерфейс AdvancedPlaceSearchElementOptions

interface google.maps.places.AdvancedPlaceSearchElementOptions extends PlaceSearchElementOptions
implemented by AdvancedPlaceSearchElement

Параметры для игры "AdvancedPlaceSearchElement".

Свойства
`attributionPosition` необязательно	Тип: `PlaceSearchAttributionPosition optional` Посмотрите `PlaceSearchElement.attributionPosition`.
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.
`orientation` необязательно	Тип: `PlaceSearchOrientation optional` Посмотрите `PlaceSearchElement.orientation`.
`selectable` необязательно	Тип: `boolean optional` Посмотреть: `PlaceSearchElement.selectable`
`truncationPreferred` необязательно	Тип: `boolean optional` Посмотрите `PlaceSearchElement.truncationPreferred`.

Класс AdvancedPlaceListElement

class google.maps.places.AdvancedPlaceListElement extends HTMLElement implements AdvancedPlaceListElementOptions
library "places"

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

Пример:

 <gmp-advanced-place-list>
   <gmp-place-details-place-request
     place="PLACE_ID"
   </gmp-place-details-place-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-list>

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

<gmp-advanced-place-list
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  places="space separated strings"
  selectable
  truncation-preferred>
</gmp-advanced-place-list>

const {AdvancedPlaceListElement} = await google.maps.importLibrary("places");

Конструктор
`AdvancedPlaceListElement`	`AdvancedPlaceListElement([options])` Параметры: `options: AdvancedPlaceListElementOptions optional`

Свойства
`attributionPosition` attr: attribution-position	Тип входных данных: `PlaceSearchAttributionPosition optional` Тип выходных данных: `PlaceSearchAttributionPosition` По умолчанию: `PlaceSearchAttributionPosition.TOP`. Положение логотипа атрибуции и кнопки юридически обязательного раскрытия информации. HTML-атрибут: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Тип входных данных: `Iterable<string> optional` Тип выходных данных: `Array<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS. HTML-атрибут: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Тип входных данных: `PlaceSearchOrientation optional` Тип выходных данных: `PlaceSearchOrientation` По умолчанию: `PlaceSearchOrientation.VERTICAL`. Вариант ориентации элемента (вертикальная или горизонтальная). HTML-атрибут: `orientation="value-name"`
`places` attr: places	Тип входных данных: `Iterable<Place\|string> optional` Тип выходных данных: `Array<Place>` Список объектов Place, содержащих идентификаторы, которые должны быть показаны в этом элементе. Обратите внимание, что не все места, заданные в свойстве places, могут быть показаны, если их не удалось отобразить(например, из-за недействительного идентификатора, ошибки сетевого запроса и т. д.). Свойство places можно прочитать, чтобы получить список мест, которые показываются в данный момент. HTML-атрибут: `places="space separated strings"`
`selectable` attr: selectable	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Можно ли выбирать элементы списка. Если задано значение true, элементы списка будут кнопками, при нажатии на которые отправляется событие `gmp-select`. Также поддерживается навигация и выбор с помощью клавиатуры. HTML-атрибут: `selectable`
`truncationPreferred` attr: truncation-preferred	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` По умолчанию: `false`. Если задано значение true, некоторые строки контента усекаются, чтобы поместиться в одну строку без переноса. HTML-атрибут: `truncation-preferred`

игровые автоматы;
`details-item`	Шаблон HTML, содержащий виджеты gmp-place, которые нужно отобразить для каждого места в списке.

Свойства 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`, `removeEventListener`

События
`gmp-error`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда запрос к серверной части отклонен (например, из-за неверного ключа API). Это событие не всплывает.
`gmp-load`	`function(event)` Аргументы: `event: Event optional` Это событие активируется, когда элемент загружает и отображает свой контент. Это событие не всплывает.
`gmp-select`	`function(event)` Аргументы: `event: PlaceSelectEvent optional` Это событие активируется, когда пользователь выбирает место из списка. Содержит объект `Place` с идентификатором, местоположением и областью просмотра выбранного места.

Интерфейс AdvancedPlaceListElementOptions

интерфейс google.maps.places.AdvancedPlaceListElementOptions
реализован AdvancedPlaceListElement

Параметры для игры "AdvancedPlaceListElement".

Свойства
`attributionPosition` необязательно	Тип: `PlaceSearchAttributionPosition optional` Посмотрите `PlaceSearchElement.attributionPosition`.
`internalUsageAttributionIds` необязательно	Тип: `Iterable<string> optional` Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.
`orientation` необязательно	Тип: `PlaceSearchOrientation optional` Посмотрите `PlaceSearchElement.orientation`.
`places` необязательно	Тип: `Iterable<Place\|string> optional` Посмотрите `AdvancedPlaceListElement.places`.
`selectable` необязательно	Тип: `boolean optional` Посмотреть: `PlaceSearchElement.selectable`
`truncationPreferred` необязательно	Тип: `boolean optional` Посмотрите `PlaceSearchElement.truncationPreferred`.

Класс AdvancedPlaceItemElement

class google.maps.places.AdvancedPlaceItemElement extends PlaceItemElement, HTMLElement implements AdvancedPlaceItemElementOptions, PlaceItemElementOptions
library "places"

Общедоступный веб-компонент-контейнер (<gmp-advanced-place-item>) для расширенных элементов списка мест. Пользовательский элемент <gmp-advanced-place-item> отрисовывает отдельную карточку расширенного результата для места в контейнере расширенного поиска или подборки, например <gmp-advanced-place-search> или <gmp-advanced-place-list>. Каждая карточка <gmp-advanced-place-item> содержит подробную информацию о месте, коллажи из медиафайлов, краткие описания и интерактивные командные кнопки, состоящие из дочерних визуальных компонентов Places UI Kit.

<gmp-advanced-place-item></gmp-advanced-place-item>

const {AdvancedPlaceItemElement} = await google.maps.importLibrary("places");

игровые автоматы;
`basic-section-bottom`	Примечание. Доступно только в альфа-версии. Область для пользовательского HTML-контента, который показывается внизу раздела с основной информацией, прямо под командными кнопками.
`basic-section-top`	Примечание. Доступно только в альфа-версии. Слот для пользовательского HTML-контента, отображаемого в разделе основной информации, непосредственно над названием места.

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс AdvancedPlaceItemElementOptions

interface google.maps.places.AdvancedPlaceItemElementOptions extends PlaceItemElementOptions
implemented by AdvancedPlaceItemElement

Параметры для игры "AdvancedPlaceItemElement".

Константы PlaceSearchAttributionPosition

константы google.maps.places.PlaceSearchAttributionPosition
библиотека "places"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом PlaceSearchAttributionPositionString.

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places");

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

PlaceSearchOrientation constants

константы google.maps.places.PlaceSearchOrientation
библиотека "places"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом PlaceSearchOrientationString.

const {PlaceSearchOrientation} = await google.maps.importLibrary("places");

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

Класс PlaceSelectEvent

class google.maps.places.PlaceSelectEvent extends Event
library "places"

Это событие активируется, когда место выбирается из списка мест. Чтобы перейти к выбранному элементу, нажмите event.place.

const {PlaceSelectEvent} = await google.maps.importLibrary("places");

Свойства
`place` readonly	Тип: `Place` Выбранное место.

Класс PlaceNearbySearchRequestElement

class google.maps.places.PlaceNearbySearchRequestElement extends HTMLElement implements PlaceNearbySearchRequestElementOptions
library "places"

Настраивает 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="value-name">
</gmp-place-nearby-search-request>

const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceNearbySearchRequestElement`	`PlaceNearbySearchRequestElement([options])` Параметры: `options: PlaceNearbySearchRequestElementOptions optional`

Свойства
`excludedPrimaryTypes` attr: excluded-primary-types	Тип входных данных: `Array<string> optional` Тип выходных данных: `Array<string> optional` По умолчанию: `null`. Исключенные основные типы мест. HTML-атрибут: `excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."`
`excludedTypes` attr: excluded-types	Тип входных данных: `Array<string> optional` Тип выходных данных: `Array<string> optional` По умолчанию: `null`. Исключенные типы мест. HTML-атрибут: `excluded-types="excluded-type1 excluded-type2..."`
`futureOpeningBusinessesIncluded`	Тип входных данных: `boolean optional` Тип выходных данных: `boolean optional` Включать в подсказки места, которые ещё не открылись, но должны открыться в будущем.
`includedPrimaryTypes` attr: included-primary-types	Тип входных данных: `Array<string> optional` Тип выходных данных: `Array<string> optional` По умолчанию: `null`. Включенный основной тип места. HTML-атрибут: `included-primary-types="included-primary-type1 included-primary-type2..."`
`includedTypes` attr: included-types	Тип входных данных: `Array<string> optional` Тип выходных данных: `Array<string> optional` По умолчанию: `null`. Включенный тип места. HTML-атрибут: `included-types="included-type1 included-type2..."`
`locationRestriction` attr: location-restriction	Тип входных данных: `Circle\|CircleLiteral optional` Тип выходных данных: `Circle optional` По умолчанию: `null`. Регион, в котором выполняется поиск. Нормализуется до `Circle`. HTML-атрибут: `location-restriction="radius@lat,lng"`
`maxResultCount` attr: max-result-count	Тип входных данных: `number optional` Тип выходных данных: `number optional` По умолчанию: `null`. Максимальное число результатов на странице. HTML-атрибут: `max-result-count="number"`
`rankPreference` attr: rank-preference	Тип входных данных: `SearchNearbyRankPreference optional` Тип выходных данных: `SearchNearbyRankPreference optional` По умолчанию: `null`. Как результаты будут ранжироваться в ответе. HTML-атрибут: `rank-preference="value-name"`

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceNearbySearchRequestElementOptions

интерфейс google.maps.places.PlaceNearbySearchRequestElementOptions
реализован PlaceNearbySearchRequestElement

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

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

Класс PlaceTextSearchRequestElement

class google.maps.places.PlaceTextSearchRequestElement extends HTMLElement implements PlaceTextSearchRequestElementOptions
library "places"

Настраивает 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="number"
  included-type="type"
  is-open-now
  location-bias="lat,lng"
  location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
  max-result-count="number"
  min-rating="number"
  price-levels="price-level1 price-level2..."
  rank-preference="value-name"
  text-query="string"
  use-strict-type-filtering>
</gmp-place-text-search-request>

const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceTextSearchRequestElement`	`PlaceTextSearchRequestElement([options])` Параметры: `options: PlaceTextSearchRequestElementOptions optional`

Свойства
`evConnectorTypes` attr: ev-connector-types	Тип входных данных: `Array<EVConnectorType> optional` Тип выходных данных: `Array<EVConnectorType> optional` По умолчанию: `null`. Список предпочитаемых типов коннекторов для электромобилей. HTML-атрибут: `ev-connector-types="ev-connector-type1 ev-connector-type2..."`
`evMinimumChargingRateKw` attr: ev-minimum-charging-rate-kw	Тип входных данных: `number optional` Тип выходных данных: `number optional` По умолчанию: `null`. Минимальная требуемая скорость зарядки в киловаттах. HTML-атрибут: `ev-minimum-charging-rate-kw="number"`
`futureOpeningBusinessesIncluded`	Тип входных данных: `boolean optional` Тип выходных данных: `boolean optional` Включать в подсказки места, которые ещё не открылись, но должны открыться в будущем.
`includedType` attr: included-type	Тип входных данных: `string optional` Тип выходных данных: `string optional` По умолчанию: `null`. Тип места, указанный в запросе. HTML-атрибут: `included-type="type"`
`isOpenNow` attr: is-open-now	Тип входных данных: `boolean optional` Тип выходных данных: `boolean optional` По умолчанию: `null`. Используется для ограничения поиска местами, которые открыты в текущий момент. HTML-атрибут: `is-open-now`
`locationBias` attr: location-bias	Тип входных данных: `LocationBias optional` Тип выходных данных: `LatLngAltitude\|LatLngBounds\|Circle\|string optional` По умолчанию: `null`. Предпочтительное местоположение для поиска. HTML-атрибут: `location-bias="lat,lng"` `location-bias="lat,lng[,altitude]"` `location-bias="swlat,swlng\|nelat,nelng"` `location-bias="radius@lat,lng"` `location-bias="IP_BIAS"`
`locationRestriction` attr: location-restriction	Тип входных данных: `LatLngBounds\|LatLngBoundsLiteral optional` Тип выходных данных: `LatLngBounds optional` По умолчанию: `null`. Ограничение местоположения для поиска. Нормализуется до `LatLngBounds`. HTML-атрибут: `location-restriction="southwest-lat,southwest-lng\|northeast-lat,northeast-lng"`
`maxResultCount` attr: max-result-count	Тип входных данных: `number optional` Тип выходных данных: `number optional` По умолчанию: `null`. Максимальное число результатов на странице. HTML-атрибут: `max-result-count="number"`
`minRating` attr: min-rating	Тип входных данных: `number optional` Тип выходных данных: `number optional` По умолчанию: `null`. Фильтровать результаты, средняя оценка которых строго меньше этого ограничения. HTML-атрибут: `min-rating="number"`
`priceLevels` attr: price-levels	Тип входных данных: `Array<PriceLevel> optional` Тип выходных данных: `Array<PriceLevel> optional` По умолчанию: `null`. Используется для ограничения поиска местами, которые отмечены как имеющие определенный уровень цен. HTML-атрибут: `price-levels="price-level1 price-level2..."`
`rankPreference` attr: rank-preference	Тип входных данных: `SearchByTextRankPreference optional` Тип выходных данных: `SearchByTextRankPreference optional` По умолчанию: `null`. Как результаты будут ранжироваться в ответе. HTML-атрибут: `rank-preference="value-name"`
`textQuery` attr: text-query	Тип входных данных: `string optional` Тип выходных данных: `string optional` По умолчанию: `null`. Текстовый запрос для текстового поиска. HTML-атрибут: `text-query="string"`
`useStrictTypeFiltering` attr: use-strict-type-filtering	Тип входных данных: `boolean optional` Тип выходных данных: `boolean optional` По умолчанию: `null`. Используется для настройки строгой фильтрации по типу для includedType. HTML-атрибут: `use-strict-type-filtering`

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceTextSearchRequestElementOptions

интерфейс google.maps.places.PlaceTextSearchRequestElementOptions
реализован PlaceTextSearchRequestElement

Параметры для игры "PlaceTextSearchRequestElement".

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

Класс Autocomplete

class google.maps.places.Autocomplete extends MVCObject
library "places"

Поддержка прекращена. С 1 марта 2025 г. google.maps.places.Autocomplete недоступен для новых клиентов. Используйте вместо них другие столбцы (PlaceAutocompleteElement). В настоящее время прекращение поддержки google.maps.places.Autocomplete не планируется, но мы рекомендуем использовать PlaceAutocompleteElement вместо google.maps.places.Autocomplete. Для google.maps.places.Autocomplete будут исправляться только критические ошибки. Об их отключении мы предупредим за 12 месяцев. Дополнительную информацию можно найти на странице https://developers.google.com/maps/legacy, а руководство по переносу – на странице https://developers.google.com/maps/documentation/javascript/places-migration-overview.

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

const {Autocomplete} = await google.maps.importLibrary("places");

Конструктор

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)` Параметры: `bounds: LatLngBounds\|LatLngBoundsLiteral optional` Границы смещения. Возвращаемое значение: нет. Задает предпочтительную область, в которой нужно искать места. Результаты подбираются с учетом этой области, но не ограничиваются ей.
`setComponentRestrictions`	`setComponentRestrictions(restrictions)` Параметры: `restrictions: ComponentRestrictions optional` Ограничения на использование. Возвращаемое значение: нет. Задает ограничения для компонентов. Ограничения компонентов используются, чтобы подсказки показывались только в родительском компоненте. например страну.
`setFields`	`setFields(fields)` Параметры: `fields: Array<string> optional` Возвращаемое значение: нет. Задает поля, которые будут включены в ответ со сведениями о месте, если они будут успешно получены. Список полей приведен в статье о `PlaceResult`.
`setOptions`	`setOptions(options)` Параметры: `options: AutocompleteOptions optional` Возвращаемое значение: нет.
`setTypes`	`setTypes(types)` Параметры: `types: Array<string> optional` Типы подсказок, которые нужно включить. Возвращаемое значение: нет. Задает типы возвращаемых подсказок. Поддерживаемые типы перечислены в руководстве для разработчиков. Если типы не указаны, будут возвращены все типы.
Унаследованные: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`.

События

place_changed

function()

Аргументы: нет.

Это событие срабатывает, когда для выбранного пользователем места становится доступен объект PlaceResult.
Если пользователь вводит название места, которое не было предложено элементом управления, и нажимает клавишу Ввод или если запрос информации о местах завершается ошибкой, PlaceResult содержит введенные пользователем данные в свойстве name, а другие свойства не определены.

Интерфейс AutocompleteOptions

интерфейс google.maps.places.AutocompleteOptions

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

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

class google.maps.places.SearchBox extends MVCObject
library "places"

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

const {SearchBox} = await google.maps.importLibrary("places");

Конструктор
`SearchBox`	`SearchBox(inputField[, opts])` Параметры: `inputField: HTMLInputElement` `opts: SearchBoxOptions optional` Создает новый экземпляр `SearchBox`, который прикрепляется к указанному текстовому полю ввода с заданными параметрами.

Методы
`getBounds`	`getBounds()` Параметры: нет. Возвращаемое значение: `LatLngBounds\|undefined` Возвращает границы, к которым привязаны подсказки запросов.
`getPlaces`	`getPlaces()` Параметры: нет. Возвращаемое значение: `Array<PlaceResult>\|undefined` Возвращает запрос, выбранный пользователем для использования с событием `places_changed`.
`setBounds`	`setBounds(bounds)` Параметры: `bounds: LatLngBounds\|LatLngBoundsLiteral optional` Возвращаемое значение: нет. Задает регион, который будет использоваться для подсказок в запросах. Результаты будут подбираться с учетом этой области, но не ограничиваться ей.
Унаследованные: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`.

События
`places_changed`	`function()` Аргументы: нет. Это событие активируется, когда пользователь выбирает запрос. Для получения новых мест следует использовать `getPlaces`.

Интерфейс SearchBoxOptions

интерфейс google.maps.places.SearchBoxOptions

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

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

Класс PlaceContextualElement

class google.maps.places.PlaceContextualElement extends HTMLElement implements PlaceContextualElementOptions
library "places"

Виджет, который использует токен контекста, чтобы показывать контекстный виджет ответа обоснования с Google Картами.

<gmp-place-contextual
  context-token="string">
</gmp-place-contextual>

const {PlaceContextualElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceContextualElement`	`PlaceContextualElement([options])` Параметры: `options: PlaceContextualElementOptions optional`

Свойства
`contextToken` attr: context-token	Тип входных данных: `string optional` Тип выходных данных: `string optional` Токен контекста. HTML-атрибут: `context-token="string"`

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceContextualElementOptions

интерфейс google.maps.places.PlaceContextualElementOptions
реализован PlaceContextualElement

Параметры для игры "PlaceContextualElement".

Свойства
`contextToken` необязательно	Тип: `string optional` Токен контекста, предоставленный в ответе функции обоснования с Google Картами.

Класс PlaceContextualListConfigElement

class google.maps.places.PlaceContextualListConfigElement extends HTMLElement implements PlaceContextualListConfigElementOptions
library "places"

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

<gmp-place-contextual-list-config
  layout="value-name"
  map-hidden>
</gmp-place-contextual-list-config>

const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places");

Конструктор
`PlaceContextualListConfigElement`	`PlaceContextualListConfigElement([options])` Параметры: `options: PlaceContextualListConfigElementOptions optional`

Свойства
`layout` attr: layout	Тип входных данных: `PlaceContextualListLayout optional` Тип выходных данных: `PlaceContextualListLayout` Макет. HTML-атрибут: `layout="value-name"`
`mapHidden` attr: map-hidden	Тип входных данных: `boolean optional` Тип выходных данных: `boolean` Скрыта ли карта. HTML-атрибут: `map-hidden`

Методы
Унаследованные: `addEventListener`, `removeEventListener`

Интерфейс PlaceContextualListConfigElementOptions

интерфейс google.maps.places.PlaceContextualListConfigElementOptions
реализован PlaceContextualListConfigElement

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

Свойства
`layout` необязательно	Тип: `PlaceContextualListLayout optional` По умолчанию: `PlaceContextualListLayout.VERTICAL`. Макет.
`mapHidden` необязательно	Тип: `boolean optional` По умолчанию: `false`. True, если карта должна быть скрыта.

PlaceContextualListLayout

константы google.maps.places.PlaceContextualListLayout
библиотека "places"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом PlaceContextualListLayoutString.

const {PlaceContextualListLayout} = await google.maps.importLibrary("places");

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

Класс PlacePinElement

class google.maps.places.PlacePinElement extends HTMLElement implements PlacePinElementOptions
library "places"

Показывает маркер места на карте, используя значок категории или фото места. Добавьте PlaceDetailsPlaceRequestElement или PlaceDetailsLocationRequestElement, чтобы указать место. Используйте PIN-код в качестве контента AdvancedMarkerElement. Не поддерживается на 3D-картах.

Пример:

 <gmp-advanced-marker>
   <gmp-place-pin>
     <gmp-place-details-place-request
       place="PLACE_ID"
     ></gmp-place-details-place-request>
     <gmp-place-rating></gmp-place-rating>
   </gmp-place-pin>
 </gmp-advanced-marker>

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

<gmp-place-pin
  icon="value-name"
  scale="number">
</gmp-place-pin>

const {PlacePinElement} = await google.maps.importLibrary("places");

Конструктор
`PlacePinElement`	`PlacePinElement([options])` Параметры: `options: PlacePinElementOptions optional`

Свойства
`icon` attr: icon	Тип входных данных: `PlacePinIcon optional` Тип выходных данных: `PlacePinIcon` По умолчанию: `PlacePinIcon.TYPE`. Значок, который показывается внутри маркера. Посмотрите `PlacePinIcon`. HTML-атрибут: `icon="value-name"`
`photoRendered` readonly	Тип: `boolean` Только для чтения. True, если на маркере показывается фото места. Всегда false, если `icon` не равно `PHOTO`. Если `icon` – `PHOTO`, но у места нет фотографии или она не загружается, то значение будет false, а на маркере будет показан значок типа места. Задайте до активации `gmp-load`.
`place` readonly	Тип: `Place optional` Только для чтения. Объект Place, содержащий идентификатор, местоположение и область просмотра для отображаемого в данный момент места. `undefined`, если место ещё не загружено или не удалось его загрузить.
`scale` attr: scale	Тип входных данных: `number optional` Тип выходных данных: `number` По умолчанию: `1`. Множитель размера маркера. HTML-атрибут: `scale="number"`

игровые автоматы;

default

Необязательный контент, который показывается на маркере, например PlaceRatingElement, пользовательский <span> или текст. Дочерние элементы Light DOM вставляются непосредственно в маркер. Место показа контента зависит от значения icon: рядом со значком типа места для TYPE, в виде значка на фотографии для PHOTO и в качестве основного контента маркера для NONE.

Свойства CSS
`--gmp-background`	Цвет фона маркера: овала, рамки фотографии, значка фотографии, клюва и границы маркера типа места.
`--gmp-border-radius`	Радиус границы маркера (значок типа места с контентом в слоте или только контент в слоте) и рамки фотографии в маркерах `PHOTO`. По умолчанию используется `30px` для значка типа места со вставленным контентом, `12px` только для вставленного контента и `12px` для рамки фотографии. Не применяется к маркеру типа места без контента в слоте.
`--gmp-glyph-background`	Цвет фона за глифом типа места. По умолчанию используется `iconBackgroundColor` места.
`--gmp-glyph-color`	Цвет глифа типа места. Применяется всегда, когда показывается глиф, в том числе когда маркер `PHOTO` заменяется значком типа места.

Методы
Унаследованные: `addEventListener`, `removeEventListener`

События

gmp-error

function(event)

Аргументы:

event: Event optional

Это событие возникает, когда маркер не может быть отрисован, например из-за сбоя сети, ошибки учетных данных (такой как неверный ключ API), идентификатора места, который не удается разрешить, или места без местоположения. Маркер скрыт. Это событие не всплывает.

gmp-load

function(event)

Аргументы:

event: Event optional

Это событие активируется после загрузки информации о месте и отрисовки маркера. Если для icon задано значение PHOTO, событие активируется только после того, как фотография загрузится или не загрузится. Если фотография не загрузится, событие gmp-error не активируется. Прочитайте загруженное место из PlacePinElement.place и узнайте, показывается ли фото из PlacePinElement.photoRendered. Это событие не всплывает.

Интерфейс PlacePinElementOptions

интерфейс google.maps.places.PlacePinElementOptions
реализован PlacePinElement

Параметры для создания PlacePinElement.

Свойства
`icon` необязательно	Тип: `PlacePinIcon optional` Посмотрите `PlacePinElement.icon`.
`scale` необязательно	Тип: `number optional` Посмотрите `PlacePinElement.scale`.

Константы PlacePinIcon

константы google.maps.places.PlacePinIcon
библиотека "places"

Варианты значков для PlacePinElement. TYPE – значение по умолчанию. Если данных для выбранного значка нет, используется значок TYPE. Если данные для TYPE отсутствуют, показывается стандартный значок.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом PlacePinIconString.

const {PlacePinIcon} = await google.maps.importLibrary("places");

Константы
`NONE`	Значок не показывается, только контент в слоте.
`PHOTO`	Фотография места в круге. Если у места нет фотографии, возвращается `TYPE`.
`TYPE`	Показывает значок категории места.

Places Widgets Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Класс PlaceAutocompleteElement

Конструктор

Свойства

игровые автоматы;

Запчасти

Свойства CSS

Методы

События

Интерфейс PlaceAutocompleteElementOptions

Свойства

Класс PlacePredictionSelectEvent

Свойства

Класс BasicPlaceAutocompleteElement

Конструктор

Свойства

игровые автоматы;

Запчасти

Свойства CSS

Методы

События

Интерфейс BasicPlaceAutocompleteElementOptions

Свойства

Класс PlaceDetailsElement

Конструктор

Свойства

Свойства CSS

Методы

События

Интерфейс PlaceDetailsElementOptions

Свойства

Класс PlaceDetailsCompactElement

Конструктор

Свойства

Свойства CSS

Методы

События

Интерфейс PlaceDetailsCompactElementOptions

Свойства

Класс AdvancedPlaceDetailsElement

Конструктор

Свойства

игровые автоматы;

Свойства CSS

Методы

События

Интерфейс AdvancedPlaceDetailsElementOptions

Свойства

Класс AdvancedPlaceDetailsCompactElement

Конструктор

Свойства

игровые автоматы;

Свойства CSS

Методы

События

Интерфейс AdvancedPlaceDetailsCompactElementOptions

Свойства

Константы PlaceDetailsOrientation

Константы

Класс PlaceDetailsPlaceRequestElement

Конструктор

Свойства

Методы

Интерфейс PlaceDetailsPlaceRequestElementOptions

Свойства

Класс PlaceDetailsLocationRequestElement

Конструктор

Свойства

Методы

Интерфейс PlaceDetailsLocationRequestElementOptions

Свойства

Класс PlaceSearchElement

Конструктор

Свойства

Свойства CSS

Методы

События

Интерфейс PlaceSearchElementOptions

Свойства

Класс PlaceItemElement

Places Widgets