Класс Map3DElement
google.maps.maps3d . Map3DElement
Map3DElement — это HTML-интерфейс для просмотра 3D-карты. Обратите внимание, что для начала рендеринга 3D-карты необходимо установить mode
.
Пользовательский элемент:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>
Этот класс расширяет HTMLElement
.
Этот класс реализует Map3DElementOptions
.
Доступ осуществляется путем вызова const {Map3DElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Map3DElement | Map3DElement([options]) Параметры:
|
Характеристики | |
---|---|
bounds | Тип: LatLngBounds | LatLngBoundsLiteral optional Если установлено, положение камеры ограничивается заданными границами широты и долготы. Обратите внимание, что объекты за пределами границ по-прежнему отображаются. Границы могут ограничивать как долготу, так и широту, либо только широту или только долготу. Для границ только по широте используйте западную и восточную долготы -180 и 180 соответственно. Для границ только по долготе используйте северную и южную широты 90 и -90 соответственно. |
center | Тип: LatLngAltitude | LatLngAltitudeLiteral optional Центр карты задаётся в формате LatLngAltitude, где высота над уровнем земли измеряется в метрах. Обратите внимание, что это не обязательно соответствует месту расположения камеры, так как поле range влияет на расстояние камеры от центра карты. Если значение не задано, по умолчанию используется значение {lat: 0, lng: 0, altitude: 63170000} . 63170000 метров — это максимально допустимая высота (радиус Земли, умноженный на 10). HTML-атрибут:
|
defaultUIDisabled | Тип: boolean optional По умолчанию: false При true все кнопки пользовательского интерфейса по умолчанию отключены. Управление клавиатурой и жестами не отключается. HTML-атрибут:
|
heading | Тип: number optional Компасный курс карты в градусах, где направление на север равно нулю. При отсутствии наклона любой крен будет интерпретироваться как направление. HTML-атрибут:
|
maxAltitude | Тип: number optional Максимальная высота над землёй, которая будет отображаться на карте. Допустимое значение — от 0 до 63170000 метров (радиус Земли, умноженный на 10). HTML-атрибут:
|
maxHeading | Тип: number optional Максимальный угол поворота карты. Допустимое значение — от 0 до 360 градусов. minHeading и maxHeading представляют собой интервал <= 360 градусов, в котором разрешены жесты направления. minHeading = 180 и maxHeading = 90 разрешают направление в диапазоне [0, 90] и направление в диапазоне [180, 360] . minHeading = 90 и maxHeading = 180 разрешают направление в диапазоне [90, 180] . HTML-атрибут:
|
maxTilt | Тип: number optional Максимальный угол наклона карты. Допустимое значение — от 0 до 90 градусов. HTML-атрибут:
|
minAltitude | Тип: number optional Минимальная высота над землёй, которая будет отображаться на карте. Допустимое значение — от 0 до 63170000 метров (радиус Земли, умноженный на 10). HTML-атрибут:
|
minHeading | Тип: number optional Минимальный угол поворота карты. Допустимое значение — от 0 до 360 градусов. minHeading и maxHeading представляют собой интервал <= 360 градусов, в котором разрешены жесты направления. minHeading = 180 и maxHeading = 90 разрешают направление в диапазоне [0, 90] и направление в диапазоне [180, 360] . minHeading = 90 и maxHeading = 180 разрешают направление в диапазоне [90, 180] . HTML-атрибут:
|
minTilt | Тип: number optional Минимальный угол наклона карты. Допустимое значение — от 0 до 90 градусов. HTML-атрибут:
|
mode | Тип: MapMode optional Указывает режим, в котором должна отображаться карта. Если не задано, карта не будет отображаться. HTML-атрибут:
|
range | Тип: number optional Расстояние от камеры до центра карты, в метрах. HTML-атрибут:
|
roll | Тип: number optional Поворот камеры относительно вектора обзора в градусах. Для устранения неоднозначностей, при отсутствии наклона любой поворот камеры будет интерпретироваться как направление. HTML-атрибут:
|
tilt | Тип: number optional Наклон вектора обзора камеры в градусах. Вектор обзора, направленный прямо на Землю, будет иметь наклон 0 градусов. Вектор обзора, направленный от Земли, будет иметь наклон 180 градусов. HTML-атрибут:
|
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener . |
flyCameraAround | flyCameraAround(options) Параметры:
Возвращаемое значение: нет Этот метод вращает камеру вокруг заданного местоположения в течение заданного времени, совершая заданное количество оборотов за это время. По умолчанию камера вращается по часовой стрелке. Если указать отрицательное число раундов, камера будет вращаться против часовой стрелки. Метод асинхронный, поскольку анимация может начаться только после загрузки минимального объёма карты. Метод возвращает управление после запуска анимации. Если количество раундов равно нулю, вращение не произойдет, а анимация завершится сразу после начала. |
flyCameraTo | flyCameraTo(options) Параметры:
Возвращаемое значение: нет Этот метод перемещает камеру по параболе из текущего местоположения в заданное конечное местоположение за заданный промежуток времени. Метод асинхронный, поскольку анимация может начаться только после загрузки минимального объёма карты. Метод возвращает управление после запуска анимации. |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener . |
stopCameraAnimation | stopCameraAnimation() Параметры: нет Возвращаемое значение: нет Этот метод останавливает любую анимацию полёта, которая может быть запущена. Камера остаётся там, где она находится в середине анимации; она не телепортируется в конечную точку. Метод асинхронный, поскольку анимация может запускаться или останавливаться только после загрузки минимального объёма карты. Метод возвращает управление после остановки анимации. |
События | |
---|---|
gmp-animationend | function(animationEndEvent) Аргументы:
Это событие срабатывает по завершении анимации полёта. Оно распространяется по дереву DOM. |
gmp-centerchange | function(centerChangeEvent) Аргументы:
Это событие возникает при изменении свойства центра Map3DElement. |
gmp-click | function(clickEvent) Аргументы:
Это событие вызывается при щелчке по элементу Map3DElement . |
gmp-headingchange | function(headingChangeEvent) Аргументы:
Это событие вызывается при изменении свойства заголовка Map3DElement. |
gmp-rangechange | function(rangeChangeEvent) Аргументы:
Это событие возникает при изменении свойства диапазона Map3DElement. |
gmp-rollchange | function(rollChangeEvent) Аргументы:
Это событие вызывается при изменении свойства вращения Map3DElement. |
gmp-steadychange | function(steadyChangeEvent) Аргументы:
Это событие срабатывает при изменении устойчивого состояния Map3DElement . |
gmp-tiltchange | function(tiltChangeEvent) Аргументы:
Это событие возникает при изменении свойства наклона Map3DElement. |
Интерфейс Map3DElementOptions
google.maps.maps3d . Map3DElementOptions
Объект Map3DElementOptions, используемый для определения свойств, которые можно установить для Map3DElement.
Характеристики | |
---|---|
bounds optional | Тип: LatLngBounds | LatLngBoundsLiteral optional См. Map3DElement.bounds . |
center optional | Тип: LatLngAltitude | LatLngAltitudeLiteral optional См. Map3DElement.center . |
defaultUIDisabled optional | Тип: boolean optional |
heading optional | Тип: number optional См. Map3DElement.heading . |
maxAltitude optional | Тип: number optional См. Map3DElement.maxAltitude . |
maxHeading optional | Тип: number optional См. Map3DElement.maxHeading . |
maxTilt optional | Тип: number optional См. Map3DElement.maxTilt . |
minAltitude optional | Тип: number optional См. Map3DElement.minAltitude . |
minHeading optional | Тип: number optional См. Map3DElement.minHeading . |
minTilt optional | Тип: number optional См. Map3DElement.minTilt . |
mode optional | Тип: MapMode optional См. Map3DElement.mode . |
range optional | Тип: number optional См. Map3DElement.range . |
roll optional | Тип: number optional См. Map3DElement.roll . |
tilt optional | Тип: number optional См. Map3DElement.tilt . |
Константы MapMode
google.maps.maps3d . MapMode
Указывает режим, в котором должна отображаться карта.
Доступ осуществляется путем вызова const {MapMode} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Константы | |
---|---|
HYBRID | Этот режим карты отображает прозрачный слой основных улиц на спутниковых или фотореалистичных снимках. |
SATELLITE | В этом режиме карты отображаются спутниковые или фотореалистичные изображения, если они доступны. |
Интерфейс FlyAroundAnimationOptions
google.maps.maps3d . FlyAroundAnimationOptions
Параметры настройки для анимации FlyCameraAround.
Характеристики | |
---|---|
camera | Тип: CameraOptions Центральная точка, на которую должна быть направлена камера во время анимации орбиты. Обратите внимание, что заголовок карты будет меняться по мере того, как камера вращается вокруг этой центральной точки. |
durationMillis optional | Тип: number optional Длительность анимации в миллисекундах. Это общая длительность анимации, а не длительность одного поворота. |
rounds optional | Тип: number optional Количество оборотов, совершаемых камерой вокруг центра за заданное время. Это определяет общую скорость вращения. Если передать отрицательное число в качестве параметра rounds, камера будет вращаться против часовой стрелки вместо стандартного направления по часовой стрелке. |
Интерфейс FlyToAnimationOptions
google.maps.maps3d . FlyToAnimationOptions
Параметры настройки для анимации FlyCameraTo.
Характеристики | |
---|---|
endCamera | Тип: CameraOptions Место, куда должна быть направлена камера в конце анимации. |
durationMillis optional | Тип: number optional Длительность анимации в миллисекундах. Длительность, равная 0, телепортирует камеру прямо в конечную точку. |
Интерфейс CameraOptions
google.maps.maps3d . CameraOptions
Объект CameraOptions используется для определения свойств, которые можно задать для объекта камеры. Объект камеры может быть любым объектом, имеющим положение камеры, например, текущим состоянием карты или запрошенным в будущем состоянием анимации.
Характеристики | |
---|---|
center optional | Тип: LatLngAltitude | LatLngAltitudeLiteral optional См. Map3DElement.center . |
heading optional | Тип: number optional См. Map3DElement.heading . |
range optional | Тип: number optional См. Map3DElement.range . |
roll optional | Тип: number optional См. Map3DElement.roll . |
tilt optional | Тип: number optional См. Map3DElement.tilt . |
Класс SteadyChangeEvent
google.maps.maps3d . SteadyChangeEvent
Это событие создаётся путём мониторинга устойчивого состояния Map3DElement
и распространяется по дереву DOM.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Характеристики | |
---|---|
isSteady | Тип: boolean Указывает, является ли Map3DElement устойчивым (т.е. весь рендеринг для текущей сцены завершен) или нет. |
Класс LocationClickEvent
google.maps.maps3d . LocationClickEvent
Это событие создается при щелчке по Map3DElement.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {LocationClickEvent} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Характеристики | |
---|---|
position | Тип: LatLngAltitude optional Широта/долгота/высота, находившиеся под курсором в момент события. Обратите внимание, что на более грубых уровнях будут возвращены менее точные данные. Кроме того, при щелчке по поверхности воды с более высоких позиций камеры для значения высоты может быть возвращена высота морского дна. Это событие всплывает по дереву DOM. |
Класс PlaceClickEvent
google.maps.maps3d . PlaceClickEvent
Это событие создаётся при нажатии на значок места в Map3DElement
. Чтобы предотвратить отображение всплывающего окна по умолчанию, вызовите метод preventDefault()
для этого события, чтобы предотвратить его обработку Map3DElement
.
Этот класс расширяет LocationClickEvent
.
Доступ осуществляется путем вызова const {PlaceClickEvent} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Характеристики | |
---|---|
placeId | Тип: string Идентификатор места объекта карты. |
Унаследовано: position |
Методы | |
---|---|
fetchPlace | fetchPlace() Параметры: нет Получает Place для идентификатора этого места. В результирующем объекте Place будет заполнено свойство id. Дополнительные поля могут быть впоследствии запрошены через Place.fetchFields() в соответствии со стандартными требованиями API Places и выставлением счетов. Запрос отклоняется, если при получении Place произошла ошибка. |
Класс Marker3DElement
google.maps.maps3d . Marker3DElement
Показывает положение на 3D-карте. Обратите внимание, что для отображения Marker3DElement
position
должно быть задано.
Пользовательский элемент:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" position="lat,lng" size-preserved z-index="number"></gmp-marker-3d>
Этот класс расширяет HTMLElement
.
Этот класс реализует Marker3DElementOptions
.
Доступ осуществляется путем вызова const {Marker3DElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Marker3DElement | Marker3DElement([options]) Параметры:
Создает Marker3DElement с указанными параметрами. |
Характеристики | |
---|---|
altitudeMode | Тип: AltitudeMode optional По умолчанию: AltitudeMode.CLAMP_TO_GROUND Указывает, как интерпретируется высотная составляющая местоположения. HTML-атрибут:
|
collisionBehavior | Тип: CollisionBehavior optional По умолчанию: CollisionBehavior.REQUIRED Перечисление, определяющее, как должен вести себя Marker3DElement при столкновении с другим Marker3DElement или с метками базовой карты. HTML-атрибут:
|
drawsWhenOccluded | Тип: boolean optional По умолчанию: false Указывает, следует ли отображать этот маркер, если он перекрыт. Маркер может быть перекрыт геометрией карты (например, зданиями). HTML-атрибут:
|
extruded | Тип: boolean optional По умолчанию: false Указывает, следует ли соединять маркер с землёй. Для выдавливания маркера altitudeMode должен иметь значение RELATIVE_TO_GROUND или ABSOLUTE . HTML-атрибут:
|
label | Тип: string optional Текст, который будет отображаться этим маркером. HTML-атрибут:
|
position | Тип: LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional Местоположение кончика маркера. Высота игнорируется в некоторых режимах и поэтому необязательна. HTML-атрибут:
|
sizePreserved | Тип: boolean optional По умолчанию: false Определяет, должен ли маркер сохранять свой размер независимо от расстояния до камеры. По умолчанию масштаб маркера зависит от расстояния до камеры/наклона. HTML-атрибут:
|
zIndex | Тип: number optional zIndex по сравнению с другими маркерами. HTML-атрибут:
|
Слоты | |
---|---|
default | Любые пользовательские элементы, непосредственно добавленные в Marker3DElement , будут помещены в слот, однако для отрисовки маркеров будут использоваться только элементы типов HTMLImageElement , SVGElement и PinElement , другие элементы будут игнорироваться.HTMLImageElement и SVGElement должны быть заключены в элемент <template> перед назначением их слоту по умолчанию Marker3DElement .Изображения и SVG в настоящее время растрируются перед отображением в 3D-сцене, поэтому пользовательский HTML, встроенный в SVG, или классы CSS, добавленные к изображениям, не будут применяться и могут не отражаться при отображении маркеров на экране. |
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener . |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener . |
Интерфейс Marker3DElementOptions
google.maps.maps3d . Marker3DElementOptions
Объект Marker3DElementOptions, используемый для определения свойств, которые можно установить для Marker3DElement.
Характеристики | |
---|---|
altitudeMode optional | Тип: AltitudeMode optional |
collisionBehavior optional | Тип: CollisionBehavior optional |
drawsWhenOccluded optional | Тип: boolean optional |
extruded optional | Тип: boolean optional См. Marker3DElement.extruded . |
label optional | Тип: string optional См. Marker3DElement.label . |
position optional | Тип: LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional См. Marker3DElement.position . |
sizePreserved optional | Тип: boolean optional |
zIndex optional | Тип: number optional См. Marker3DElement.zIndex . |
Класс Marker3DInteractiveElement
google.maps.maps3d . Marker3DInteractiveElement
Показывает позицию на 3D-карте. Обратите внимание, что для отображения Marker3DInteractiveElement
необходимо задать position
. В отличие от Marker3DElement
, Marker3DInteractiveElement
получает событие gmp-click
.
Пользовательский элемент:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>
Этот класс расширяет Marker3DElement
.
Этот класс реализует Marker3DInteractiveElementOptions
.
Доступ осуществляется путем вызова const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Marker3DInteractiveElement | Marker3DInteractiveElement([options]) Параметры:
Создает Marker3DInteractiveElement с указанными параметрами. |
Характеристики | |
---|---|
gmpPopoverTargetElement | Тип: PopoverElement optional Если установлено, элемент всплывающего окна будет открываться при щелчке по этому маркеру. HTML-атрибут:
|
title | Тип: string Текст, отображаемый при наведении курсора. Если он указан, текст для специальных возможностей (например, для использования программами чтения с экрана) будет добавлен в элемент Marker3DInteractiveElement с указанным значением. HTML-атрибут:
|
Унаследовано: altitudeMode , collisionBehavior , drawsWhenOccluded , extruded , label , position , sizePreserved , zIndex |
Слоты | |
---|---|
default | Любые пользовательские элементы, добавленные непосредственно в Marker3DInteractiveElement будут помещены в слот, однако для отрисовки маркеров будут использоваться только элементы типа PinElement , другие элементы будут игнорироваться. |
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener. |
События | |
---|---|
gmp-click | function(clickEvent) Аргументы:
Это событие вызывается при щелчке по элементу Marker3DInteractiveElement . |
Интерфейс Marker3DInteractiveElementOptions
google.maps.maps3d . Marker3DInteractiveElementOptions
Объект Marker3DInteractiveElementOptions, используемый для определения свойств, которые можно установить для Marker3DInteractiveElement.
Этот интерфейс расширяет Marker3DElementOptions
.
Характеристики | |
---|---|
gmpPopoverTargetElement optional | Тип: PopoverElement optional |
title optional | Тип: string optional |
Унаследовано: altitudeMode , collisionBehavior , drawsWhenOccluded , extruded , label , position , sizePreserved , zIndex |
Класс Model3DElement
google.maps.maps3d . Model3DElement
3D-модель, позволяющая визуализировать модели gLTF. Обратите внимание, что для отображения Model3DElement
необходимо задать position
и src
.
Основные свойства gLTF PBR должны поддерживаться. Расширения и свойства расширений в настоящее время не поддерживаются.
Пользовательский элемент:
<gmp-model-3d altitude-mode="absolute" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></gmp-model-3d>
Этот класс расширяет HTMLElement
.
Этот класс реализует Model3DElementOptions
.
Доступ осуществляется путем вызова const {Model3DElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Model3DElement | Model3DElement([options]) Параметры:
Создает Model3DElement с указанными параметрами. |
Характеристики | |
---|---|
altitudeMode | Тип: AltitudeMode optional По умолчанию: AltitudeMode.CLAMP_TO_GROUND Указывает, как интерпретируется высота в данном положении. HTML-атрибут:
|
orientation | Тип: Orientation3D | Orientation3DLiteral optional Описывает вращение системы координат 3D-модели для позиционирования модели на 3D-карте. Повороты к модели применяются в следующем порядке: крен, наклон и затем направление. HTML-атрибут:
|
position | Тип: LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional Задаёт положение Model3DElement . Высота игнорируется в некоторых режимах и поэтому необязательна. HTML-атрибут:
|
scale | Тип: number| Vector3D | Vector3DLiteral optional По умолчанию: 1 Масштабирует модель по осям x, y и z в координатном пространстве модели. HTML-атрибут:
|
src | Тип: string| URL optional Указывает URL-адрес 3D-модели. В настоящее время поддерживаются только модели в формате .glb .Любые относительные HTTP-адреса будут преобразованы в соответствующие им абсолютные. Обратите внимание: если вы размещаете файлы моделей .glb на другом сайте или сервере, чем ваше основное приложение, обязательно настройте корректные HTTP-заголовки CORS. Это позволит вашему приложению безопасно получать доступ к файлам моделей из другого домена. HTML-атрибут:
|
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener . |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener . |
Интерфейс Model3DElementOptions
google.maps.maps3d . Model3DElementOptions
Объект Model3DElementOptions, используемый для определения свойств, которые можно установить для Model3DElement.
Характеристики | |
---|---|
altitudeMode optional | Тип: AltitudeMode optional |
orientation optional | Тип: Orientation3D | Orientation3DLiteral optional |
position optional | Тип: LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional См. Model3DElement.position . |
scale optional | Тип: number| Vector3D | Vector3DLiteral optional См. Model3DElement.scale . |
src optional | Тип: string| URL optional См. Model3DElement.src . |
Класс Model3DInteractiveElement
google.maps.maps3d . Model3DInteractiveElement
3D-модель, позволяющая визуализировать модели gLTF. Обратите внимание, что для отображения Model3DElement
необходимо задать position
и src
.
Основные свойства gLTF PBR должны поддерживаться. Расширения и свойства расширений в настоящее время не поддерживаются.
В отличие от Model3DElement
, Model3DInteractiveElement
получает событие gmp-click
.
Пользовательский элемент:
<gmp-model-3d-interactive></gmp-model-3d-interactive>
Этот класс расширяет Model3DElement
.
Этот класс реализует Model3DInteractiveElementOptions
.
Доступ осуществляется путем вызова const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Model3DInteractiveElement | Model3DInteractiveElement([options]) Параметры:
Создает Model3DInteractiveElement с указанными параметрами. |
Характеристики | |
---|---|
Унаследовано: altitudeMode , orientation , position , scale , src |
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener. |
События | |
---|---|
gmp-click | function(clickEvent) Аргументы:
Это событие вызывается при щелчке по элементу Model3DInteractiveElement . |
Интерфейс Model3DInteractiveElementOptions
google.maps.maps3d . Model3DInteractiveElementOptions
Объект Model3DInteractiveElementOptions, используемый для определения свойств, которые можно установить для Model3DInteractiveElement.
Этот интерфейс расширяет Model3DElementOptions
.
Характеристики | |
---|---|
Унаследовано: altitudeMode , orientation , position , scale , src |
Класс Polyline3DElement
google.maps.maps3d . Polyline3DElement
3D-полилиния — это линейное наложение соединенных отрезков линий на 3D-карту.
Пользовательский элемент:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>
Этот класс расширяет HTMLElement
.
Этот класс реализует Polyline3DElementOptions
.
Доступ осуществляется путем вызова const {Polyline3DElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Polyline3DElement | Polyline3DElement([options]) Параметры:
Создает Polyline3DElement с указанными параметрами. |
Характеристики | |
---|---|
altitudeMode | Тип: AltitudeMode optional По умолчанию: AltitudeMode.CLAMP_TO_GROUND Определяет, как интерпретируются компоненты высоты в координатах. HTML-атрибут:
|
coordinates | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > optional Упорядоченная последовательность координат полилинии. Высота игнорируется в некоторых режимах и поэтому необязательна. |
drawsOccludedSegments | Тип: boolean optional По умолчанию: false Указывает, отображаются ли части полилинии, которые могут быть перекрыты. Полилинии могут быть перекрыты геометрией карты (например, зданиями). HTML-атрибут:
|
extruded | Тип: boolean optional По умолчанию: false Указывает, следует ли соединять полилинию с землёй. Для выдавливания полилинии altitudeMode должен иметь значение RELATIVE_TO_GROUND или ABSOLUTE . HTML-атрибут:
|
geodesic | Тип: boolean optional По умолчанию: false При true края полилинии интерпретируются как геодезические и повторяют кривизну Земли. При значении false края полилинии отображаются в экранном пространстве как прямые линии. HTML-атрибут:
|
outerColor | Тип: string optional Внешний цвет. Поддерживаются все цвета CSS3. HTML-атрибут:
|
outerWidth | Тип: number optional Внешняя ширина находится в диапазоне от 0.0 до 1.0 . Это процент от значения strokeWidth . HTML-атрибут:
|
strokeColor | Тип: string optional Цвет обводки. Поддерживаются все цвета CSS3. HTML-атрибут:
|
strokeWidth | Тип: number optional Ширина обводки в пикселях. HTML-атрибут:
|
zIndex | Тип: number optional zIndex по сравнению с другими полигонами. HTML-атрибут:
|
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener . |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener . |
Интерфейс Polyline3DElementOptions
google.maps.maps3d . Polyline3DElementOptions
Объект Polyline3DElementOptions, используемый для определения свойств, которые можно установить для Polyline3DElement.
Характеристики | |
---|---|
altitudeMode optional | Тип: AltitudeMode optional |
coordinates optional | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > optional |
drawsOccludedSegments optional | Тип: boolean optional |
extruded optional | Тип: boolean optional |
geodesic optional | Тип: boolean optional |
outerColor optional | Тип: string optional |
outerWidth optional | Тип: number optional |
strokeColor optional | Тип: string optional |
strokeWidth optional | Тип: number optional |
zIndex optional | Тип: number optional См. Polyline3DElement.zIndex . |
Класс Polyline3DInteractiveElement
google.maps.maps3d . Polyline3DInteractiveElement
3D-полилиния — это линейное наложение соединённых отрезков на 3D-карту. В отличие от Polyline3DElement
, Polyline3DInteractiveElement
получает событие gmp-click
.
Пользовательский элемент:
<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
Этот класс расширяет Polyline3DElement
.
Этот класс реализует Polyline3DInteractiveElementOptions
.
Доступ осуществляется путем вызова const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
См. Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Polyline3DInteractiveElement | Polyline3DInteractiveElement([options]) Параметры:
Создает Polyline3DInteractiveElement с указанными параметрами. |
Характеристики | |
---|---|
Унаследовано: altitudeMode , coordinates , drawsOccludedSegments , extruded , geodesic , outerColor , outerWidth , strokeColor , strokeWidth , zIndex |
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener. |
События | |
---|---|
gmp-click | function(clickEvent) Аргументы:
Это событие вызывается при щелчке по элементу Polyline3DInteractiveElement . |
Интерфейс Polyline3DInteractiveElementOptions
google.maps.maps3d . Polyline3DInteractiveElementOptions
Объект Polyline3DInteractiveElementOptions, используемый для определения свойств, которые можно установить для Polyline3DInteractiveElement.
Этот интерфейс расширяет Polyline3DElementOptions
.
Характеристики | |
---|---|
Унаследовано: altitudeMode , coordinates , drawsOccludedSegments , extruded , geodesic , outerColor , outerWidth , strokeColor , strokeWidth , zIndex |
Класс Polygon3DElement
google.maps.maps3d . Polygon3DElement
Трехмерный многоугольник (например, трехмерная ломаная линия) определяет ряд связанных координат в упорядоченной последовательности. Кроме того, полигоны образуют замкнутый контур и определяют заполненную область.
Пользовательский элемент:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>
Этот класс расширяет HTMLElement
.
Этот класс реализует Polygon3DElementOptions
.
Доступ осуществляется путем вызова const {Polygon3DElement} = await google.maps.importLibrary("maps3d")
.
См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Polygon3DElement | Polygon3DElement([options]) Параметры:
Создает Polygon3DElement с указанными параметрами. |
Характеристики | |
---|---|
altitudeMode | Тип: AltitudeMode optional По умолчанию: AltitudeMode.CLAMP_TO_GROUND Указывает, как интерпретируются компоненты высоты в координатах. HTML-атрибут:
|
drawsOccludedSegments | Тип: boolean optional По умолчанию: false Указывает, будут ли нарисованы части многоугольника, которые могут быть перекрыты. Полигоны могут быть перекрыты геометрией карты (например, зданиями). HTML-атрибут:
|
extruded | Тип: boolean optional По умолчанию: false Указывает, следует ли соединить многоугольник с землей. Чтобы выдавить многоугольник, параметр altitudeMode должен быть либо RELATIVE_TO_GROUND , либо ABSOLUTE . HTML-атрибут:
|
fillColor | Тип: string optional Цвет заливки. Поддерживаются все цвета CSS3. HTML-атрибут:
|
geodesic | Тип: boolean optional По умолчанию: false Если true , края многоугольника интерпретируются как геодезические и следуют кривизне Земли. Если установлено false , края многоугольника отображаются как прямые линии в пространстве экрана. HTML-атрибут:
|
innerCoordinates | Type: Iterable < Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral >> optional Упорядоченная последовательность координат, обозначающая замкнутый контур. В отличие от полилиний, многоугольник может состоять из одного или нескольких контуров, которые создают несколько вырезов внутри многоугольника. |
outerCoordinates | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > optional Упорядоченная последовательность координат, обозначающая замкнутый контур. Высота игнорируется в некоторых режимах и поэтому является необязательной. |
strokeColor | Тип: string optional Цвет штриха. Поддерживаются все цвета CSS3. HTML-атрибут:
|
strokeWidth | Тип: number optional Ширина штриха в пикселях. HTML-атрибут:
|
zIndex | Тип: number optional zIndex по сравнению с другими полигонами. HTML-атрибут:
|
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener . |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener . |
Интерфейс Polygon3DElementOptions
google.maps.maps3d . Polygon3DElementOptions
Объект Polygon3DElementOptions, используемый для определения свойств, которые можно задать для Polygon3DElement.
Характеристики | |
---|---|
altitudeMode optional | Тип: AltitudeMode optional |
drawsOccludedSegments optional | Тип: boolean optional |
extruded optional | Тип: boolean optional |
fillColor optional | Тип: string optional |
geodesic optional | Тип: boolean optional |
innerCoordinates optional | Type: Iterable < Iterable < LatLngAltitude | LatLngAltitudeLiteral >| Iterable < LatLngLiteral >> optional |
outerCoordinates optional | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > optional |
strokeColor optional | Тип: string optional |
strokeWidth optional | Тип: number optional |
zIndex optional | Тип: number optional См. Polygon3DElement.zIndex . |
Класс Polygon3DInteractiveElement
google.maps.maps3d . Polygon3DInteractiveElement
Трехмерный многоугольник (например, трехмерная ломаная линия) определяет ряд связанных координат в упорядоченной последовательности. Кроме того, полигоны образуют замкнутый контур и определяют заполненную область. В отличие от Polygon3DElement
, Polygon3DInteractiveElement
получает событие gmp-click
.
Пользовательский элемент:
<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
Этот класс расширяет Polygon3DElement
.
Этот класс реализует Polygon3DInteractiveElementOptions
.
Доступ осуществляется путем вызова const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Polygon3DInteractiveElement | Polygon3DInteractiveElement([options]) Параметры:
Создает Polygon3DInteractiveElement с указанными параметрами. |
Характеристики | |
---|---|
Унаследовано: altitudeMode , drawsOccludedSegments , extruded , fillColor , geodesic , innerCoordinates , outerCoordinates , strokeColor , strokeWidth , zIndex |
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener. |
События | |
---|---|
gmp-click | function(clickEvent) Аргументы:
Это событие вызывается при щелчке элемента Polygon3DInteractiveElement . |
Интерфейс Polygon3DInteractiveElementOptions
google.maps.maps3d . Polygon3DInteractiveElementOptions
Объект Polygon3DInteractiveElementOptions, используемый для определения свойств, которые можно задать для Polygon3DInteractiveElement.
Этот интерфейс расширяет Polygon3DElementOptions
.
Характеристики | |
---|---|
Унаследовано: altitudeMode , drawsOccludedSegments , extruded , fillColor , geodesic , innerCoordinates , outerCoordinates , strokeColor , strokeWidth , zIndex |
Класс ПоповерЭлемент
google.maps.maps3d . PopoverElement
Пользовательский HTML-элемент, отображающий всплывающее окно. Он выглядит как пузырь и часто связан с маркером.
Пользовательский элемент:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>
Этот класс расширяет HTMLElement
.
Этот класс реализует PopoverElementOptions
.
Доступ осуществляется путем вызова const {PopoverElement} = await google.maps.importLibrary("maps3d")
.
См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
PopoverElement | PopoverElement([options]) Параметры:
|
Характеристики | |
---|---|
altitudeMode | Тип: AltitudeMode optional По умолчанию: AltitudeMode.CLAMP_TO_GROUND Указывает, как интерпретируется компонент высоты положения. HTML-атрибут:
|
lightDismissDisabled | Тип: boolean optional По умолчанию: false Указывает, должен ли этот поповер быть «легко отклоненным» или нет. Поведение «легкого отклонения» аналогично установке атрибута popover="auto" , который является частью API Popover браузера. HTML-атрибут:
|
open | Тип: boolean optional По умолчанию: false Указывает, должно ли это всплывающее окно быть открытым или нет. HTML-атрибут:
|
positionAnchor | Тип: LatLngLiteral | LatLngAltitudeLiteral | Marker3DInteractiveElement |string optional Позиция, в которой будет отображаться это всплывающее окно. Если всплывающее окно привязано к интерактивному маркеру, вместо него будет использоваться позиция маркера. HTML-атрибут:
|
Слоты | |
---|---|
default | Помещает выделенный контент в основной раздел всплывающего окна. |
header | Помещает выделенный контент в раздел заголовка всплывающего окна. |
Свойства CSS | |
---|---|
--gmp-popover-max-width | Максимальная ширина поповера, независимо от ширины контента. |
--gmp-popover-min-width | Минимальная ширина поповера, независимо от ширины контента. При использовании этого свойства настоятельно рекомендуется установить для него значение меньше ширины карты (в пикселях). |
--gmp-popover-pixel-offset-x | Смещение кончика всплывающего окна по оси X (в пикселях) от точки на карте, к географическим координатам которой привязано всплывающее окно. |
--gmp-popover-pixel-offset-y | Смещение по оси Y (в пикселях) кончика всплывающего окна от точки на карте, к географическим координатам которой прикреплено всплывающее окно. |
color-scheme | Указывает, в какой цветовой схеме может отображаться это всплывающее окно. Дополнительные сведения см. в документации по color-scheme . Если не указано, по умолчанию используются настройки цветовой схемы пользователя. |
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener . |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener . |
Интерфейс PopoverElementOptions
google.maps.maps3d . PopoverElementOptions
Объект PopoverElementOptions, используемый для определения свойств, которые можно задать для PopoverElement.
Характеристики | |
---|---|
altitudeMode optional | Тип: AltitudeMode optional |
lightDismissDisabled optional | Тип: boolean optional |
open optional | Тип: boolean optional См. PopoverElement.open . |
positionAnchor optional | Тип: LatLngLiteral | LatLngAltitudeLiteral |string| Marker3DInteractiveElement optional |
Константы AltitudeMode
google.maps.maps3d . AltitudeMode
Указывает, как интерпретируются компоненты высоты в координатах.
Доступ осуществляется путем вызова const {AltitudeMode} = await google.maps.importLibrary("maps3d")
.
См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
ABSOLUTE | Позволяет выражать объекты относительно среднего среднего уровня моря. Это также означает, что если уровень детализации местности под объектом изменится, его абсолютное положение останется прежним. |
CLAMP_TO_GROUND | Позволяет выражать объекты, расположенные на земле. Они останутся на уровне земли, следуя за рельефом местности, независимо от заданной высоты. Если объект расположен над большим водоемом, он будет размещен на уровне моря. |
RELATIVE_TO_GROUND | Позволяет выражать объекты относительно поверхности земли. Если уровень детализации местности изменится, положение объекта относительно земли останется постоянным. При нахождении над водой высота будет интерпретироваться как значение в метрах над уровнем моря. |
RELATIVE_TO_MESH | Позволяет отображать объекты относительно самой высокой поверхности земли+здания+воды. Когда над водой это будет водная поверхность; если над местностью, это будет поверхность здания (если есть) или поверхность земли (если зданий нет). |