3D Maps

Класс Map3DElement

google.maps.maps3d . Map3DElement

Map3DElement — это HTML-интерфейс для просмотра 3D-карт.

Пользовательский элемент:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" 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, где высота над уровнем земли измеряется в метрах. Обратите внимание, что это не обязательно соответствует месту расположения камеры, так как поле range влияет на расстояние камеры от центра карты. Если значение не задано, по умолчанию используется значение {lat: 0, lng: 0, altitude: 63170000} . 63170000 метров — это максимально допустимая высота (радиус Земли, умноженный на 10).
HTML-атрибут:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
Тип: boolean optional
По умолчанию: false
Если true , метки карты по умолчанию не отображаются.
HTML-атрибут:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Тип: boolean optional
По умолчанию: false
При true все кнопки пользовательского интерфейса по умолчанию отключены. Управление клавиатурой и жестами не отключается.
HTML-атрибут:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Тип: number optional
Компасный курс карты в градусах, где направление на север равно нулю. При отсутствии наклона любой крен будет интерпретироваться как направление.
HTML-атрибут:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Тип: number optional
Максимальная высота над землёй, которая будет отображаться на карте. Допустимое значение — от 0 до 63170000 метров (радиус Земли, умноженный на 10).
HTML-атрибут:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Тип: number optional
Максимальный угол поворота карты. Допустимое значение — от 0 до 360 градусов. minHeading и maxHeading представляют собой интервал <= 360 градусов, в котором разрешены жесты направления. minHeading = 180 и maxHeading = 90 разрешают направление в диапазоне [0, 90] и направление в диапазоне [180, 360] . minHeading = 90 и maxHeading = 180 разрешают направление в диапазоне [90, 180] .
HTML-атрибут:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Тип: number optional
Максимальный угол наклона карты. Допустимое значение — от 0 до 90 градусов.
HTML-атрибут:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
Тип: number optional
Минимальная высота над землёй, которая будет отображаться на карте. Допустимое значение — от 0 до 63170000 метров (радиус Земли, умноженный на 10).
HTML-атрибут:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Тип: number optional
Минимальный угол поворота карты. Допустимое значение — от 0 до 360 градусов. minHeading и maxHeading представляют собой интервал <= 360 градусов, в котором разрешены жесты направления. minHeading = 180 и maxHeading = 90 разрешают направление в диапазоне [0, 90] и направление в диапазоне [180, 360] . minHeading = 90 и maxHeading = 180 разрешают направление в диапазоне [90, 180] .
HTML-атрибут:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Тип: number optional
Минимальный угол наклона карты. Допустимое значение — от 0 до 90 градусов.
HTML-атрибут:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
Тип: number optional
Расстояние от камеры до центра карты, в метрах.
HTML-атрибут:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Тип: number optional
Поворот камеры относительно вектора обзора в градусах. Для устранения неоднозначностей, при отсутствии наклона любой поворот камеры будет интерпретироваться как направление.
HTML-атрибут:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Тип: number optional
Наклон вектора обзора камеры в градусах. Вектор обзора, направленный прямо на Землю, будет иметь наклон 0 градусов. Вектор обзора, направленный от Земли, будет иметь наклон 180 градусов.
HTML-атрибут:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
flyCameraAround
flyCameraAround(options)
Параметры:
Возвращаемое значение: нет
Этот метод вращает камеру вокруг заданного местоположения в течение заданного времени, совершая заданное количество оборотов за это время.

По умолчанию камера вращается по часовой стрелке. Если указать отрицательное число раундов, камера будет вращаться против часовой стрелки.

Метод асинхронный, поскольку анимация может начаться только после загрузки минимального объёма карты. Метод возвращает управление после запуска анимации.

Если количество раундов равно нулю, вращение не произойдет, а анимация завершится сразу после начала.
flyCameraTo
flyCameraTo(options)
Параметры:
Возвращаемое значение: нет
Этот метод перемещает камеру по параболе из текущего местоположения в заданное конечное местоположение за заданный промежуток времени.

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

Метод асинхронный, поскольку анимация может запускаться или останавливаться только после загрузки минимального объёма карты. Метод возвращает управление после остановки анимации.
gmp-animationend
function(animationEndEvent)
Аргументы:
  • animationEndEvent : Event
Это событие срабатывает по завершении анимации полёта. Оно распространяется по дереву DOM.
gmp-centerchange
function(centerChangeEvent)
Аргументы:
  • centerChangeEvent : Event
Это событие возникает при изменении свойства центра Map3DElement.
gmp-click
function(clickEvent)
Аргументы:
Это событие вызывается при щелчке по элементу Map3DElement .
gmp-headingchange
function(headingChangeEvent)
Аргументы:
  • headingChangeEvent : Event
Это событие вызывается при изменении свойства заголовка Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
Аргументы:
  • rangeChangeEvent : Event
Это событие возникает при изменении свойства диапазона 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
См. Map3DElement.center .
defaultLabelsDisabled optional
Тип: boolean optional
См. Map3DElement.defaultLabelsDisabled .
defaultUIDisabled optional
Тип: boolean optional
См. Map3DElement.defaultUIDisabled .
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 .
range optional
Тип: number optional
См. Map3DElement.range .
roll optional
Тип: number optional
См. Map3DElement.roll .
tilt optional
Тип: number optional
См. Map3DElement.tilt .

Интерфейс 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
См. 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.

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

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

placeId
Тип: string
Идентификатор места объекта карты.
Унаследовано: position
fetchPlace
fetchPlace()
Параметры: нет
Возвращаемое значение: Promise < Place >
Получает 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" 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-атрибут:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
Тип: CollisionBehavior optional
По умолчанию: CollisionBehavior.REQUIRED
Перечисление, определяющее, как должен вести себя Marker3DElement при столкновении с другим Marker3DElement или с метками базовой карты.
HTML-атрибут:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
Тип: boolean optional
По умолчанию: false
Указывает, следует ли отображать этот маркер, если он перекрыт. Маркер может быть перекрыт геометрией карты (например, зданиями).
HTML-атрибут:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Тип: boolean optional
По умолчанию: false
Указывает, следует ли соединять маркер с землёй. Для выдавливания маркера altitudeMode должен иметь значение RELATIVE_TO_GROUND или ABSOLUTE .
HTML-атрибут:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Тип: string optional
Текст, который будет отображаться этим маркером.
HTML-атрибут:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Местоположение кончика маркера. Высота игнорируется в некоторых режимах и поэтому необязательна.
sizePreserved
Тип: boolean optional
По умолчанию: false
Определяет, должен ли маркер сохранять свой размер независимо от расстояния до камеры. По умолчанию масштаб маркера зависит от расстояния до камеры/наклона.
HTML-атрибут:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Тип: number optional
zIndex по сравнению с другими маркерами.
HTML-атрибут:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Любые пользовательские элементы, непосредственно добавленные в Marker3DElement , будут помещены в слот, однако для отрисовки маркеров будут использоваться только элементы типов HTMLImageElement , SVGElement и PinElement , другие элементы будут игнорироваться.
HTMLImageElement и SVGElement должны быть заключены в элемент <template> перед назначением их слоту по умолчанию Marker3DElement .

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

Интерфейс Marker3DElementOptions

google.maps.maps3d . Marker3DElementOptions

Объект Marker3DElementOptions, используемый для определения свойств, которые можно установить для Marker3DElement.

altitudeMode optional
Тип: AltitudeMode optional
См. Marker3DElement.altitudeMode .
collisionBehavior optional
Тип: CollisionBehavior optional
См. Marker3DElement.collisionBehavior .
drawsWhenOccluded optional
Тип: boolean optional
См. Marker3DElement.drawsWhenOccluded .
extruded optional
Тип: boolean optional
См. Marker3DElement.extruded .
label optional
Тип: string optional
См. Marker3DElement.label .
position optional
См. Marker3DElement.position .
sizePreserved optional
Тип: boolean optional
См. Marker3DElement.sizePreserved .
zIndex optional
Тип: number optional
См. Marker3DElement.zIndex .

Класс Marker3DInteractiveElement

google.maps.maps3d . Marker3DInteractiveElement

Показывает позицию на 3D-карте. Обратите внимание, что для отображения Marker3DInteractiveElement необходимо задать position . В отличие от Marker3DElement , Marker3DInteractiveElement получает событие gmp-click .

Пользовательский элемент:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

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

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

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

Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Параметры:
Создает Marker3DInteractiveElement с указанными параметрами.
Унаследовано: altitudeMode , collisionBehavior , drawsWhenOccluded , extruded , label , position , sizePreserved , zIndex
default
Любые пользовательские элементы, добавленные непосредственно в Marker3DInteractiveElement будут помещены в слот, однако для отрисовки маркеров будут использоваться только элементы типа PinElement , другие элементы будут игнорироваться.
addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. параметры
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener.
gmp-click
function(clickEvent)
Аргументы:
Это событие вызывается при щелчке по элементу Marker3DInteractiveElement .

Интерфейс Marker3DInteractiveElementOptions

google.maps.maps3d . Marker3DInteractiveElementOptions

Объект Marker3DInteractiveElementOptions, используемый для определения свойств, которые можно установить для Marker3DInteractiveElement.

Этот интерфейс расширяет Marker3DElementOptions .

Унаследовано: 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" src="src"></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-атрибут:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
Описывает вращение системы координат 3D-модели для позиционирования модели на 3D-карте.

Повороты к модели применяются в следующем порядке: крен, наклон и затем направление.
position
Задаёт положение Model3DElement . Высота игнорируется в некоторых режимах и поэтому необязательна.
scale
Тип: number| Vector3D | Vector3DLiteral optional
По умолчанию: 1
Масштабирует модель по осям x, y и z в координатном пространстве модели.
src
Тип: string| URL optional
Указывает URL-адрес 3D-модели. В настоящее время поддерживаются только модели в формате .glb .

Любые относительные HTTP-адреса будут преобразованы в соответствующие им абсолютные.

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

Интерфейс Model3DElementOptions

google.maps.maps3d . Model3DElementOptions

Объект Model3DElementOptions, используемый для определения свойств, которые можно установить для Model3DElement.

altitudeMode optional
Тип: AltitudeMode optional
См. Model3DElement.altitudeMode .
orientation optional
См. Model3DElement.orientation .
position optional
См. Model3DElement.position .
scale optional
Тип: number| Vector3D | Vector3DLiteral optional
См. Model3DElement.scale .
src optional
Тип: string| URL optional
См. Model3DElement.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.ABSOLUTE
Определяет, как интерпретируются компоненты высоты в координатах.
HTML-атрибут:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
Упорядоченная последовательность координат полилинии. Высота игнорируется в некоторых режимах и поэтому необязательна.
drawsOccludedSegments
Тип: boolean optional
По умолчанию: false
Указывает, отображаются ли части полилинии, которые могут быть перекрыты. Полилинии могут быть перекрыты геометрией карты (например, зданиями).
HTML-атрибут:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Тип: boolean optional
По умолчанию: false
Указывает, следует ли соединять полилинию с землёй. Для выдавливания полилинии altitudeMode должен иметь значение RELATIVE_TO_GROUND или ABSOLUTE .
HTML-атрибут:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Тип: boolean optional
По умолчанию: false
При true края полилинии интерпретируются как геодезические и повторяют кривизну Земли. При значении false края полилинии отображаются в экранном пространстве как прямые линии.
HTML-атрибут:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Тип: string optional
Внешний цвет. Поддерживаются все цвета CSS3.
HTML-атрибут:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Тип: number optional
Внешняя ширина находится в диапазоне от 0.0 до 1.0 . Это процент от значения strokeWidth .
HTML-атрибут:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Тип: string optional
Цвет обводки. Поддерживаются все цвета CSS3.
HTML-атрибут:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Тип: number optional
Ширина обводки в пикселях.
HTML-атрибут:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Тип: number optional
zIndex по сравнению с другими полигонами.
HTML-атрибут:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс Polyline3DElementOptions

google.maps.maps3d . Polyline3DElementOptions

Объект Polyline3DElementOptions, используемый для определения свойств, которые можно установить для Polyline3DElement.

altitudeMode optional
Тип: AltitudeMode optional
См. Polyline3DElement.altitudeMode .
coordinates optional
См. Polyline3DElement.coordinates .
drawsOccludedSegments optional
Тип: boolean optional
См. Polyline3DElement.drawsOccludedSegments .
extruded optional
Тип: boolean optional
См. Polyline3DElement.extruded .
geodesic optional
Тип: boolean optional
См. Polyline3DElement.geodesic .
outerColor optional
Тип: string optional
См. Polyline3DElement.outerColor .
outerWidth optional
Тип: number optional
См. Polyline3DElement.outerWidth .
strokeColor optional
Тип: string optional
См. Polyline3DElement.strokeColor .
strokeWidth optional
Тип: number optional
См. Polyline3DElement.strokeWidth .
zIndex optional
Тип: number optional
См. Polyline3DElement.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.ABSOLUTE
Определяет, как интерпретируются компоненты высоты в координатах.
HTML-атрибут:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
Тип: boolean optional
По умолчанию: false
Определяет, отображаются ли части полигона, которые могут быть перекрыты. Полигоны могут быть перекрыты геометрией карты (например, зданиями).
HTML-атрибут:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Тип: boolean optional
По умолчанию: false
Указывает, следует ли соединять полигон с землёй. Для выдавливания полигона altitudeMode должен иметь значение RELATIVE_TO_GROUND или ABSOLUTE .
HTML-атрибут:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Тип: string optional
Цвет заливки. Поддерживаются все цвета CSS3.
HTML-атрибут:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
Тип: boolean optional
По умолчанию: false
При true рёбра многоугольника интерпретируются как геодезические и повторяют кривизну Земли. При значении false рёбра многоугольника отображаются в экранном пространстве как прямые линии.
HTML-атрибут:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
Упорядоченная последовательность координат, определяющая замкнутый контур. В отличие от ломаных линий, многоугольник может состоять из одного или нескольких контуров, создающих множество вырезов внутри многоугольника.
outerCoordinates
Упорядоченная последовательность координат, определяющая замкнутый контур. Высота в некоторых режимах игнорируется и, следовательно, необязательна.
strokeColor
Тип: string optional
Цвет обводки. Поддерживаются все цвета CSS3.
HTML-атрибут:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Тип: number optional
Ширина обводки в пикселях.
HTML-атрибут:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Тип: number optional
zIndex по сравнению с другими полигонами.
HTML-атрибут:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс Polygon3DElementOptions

google.maps.maps3d . Polygon3DElementOptions

Объект Polygon3DElementOptions, используемый для определения свойств, которые можно установить для Polygon3DElement.

altitudeMode optional
Тип: AltitudeMode optional
См. Polygon3DElement.altitudeMode .
drawsOccludedSegments optional
Тип: boolean optional
См. Polygon3DElement.drawsOccludedSegments .
extruded optional
Тип: boolean optional
См. Polygon3DElement.extruded .
fillColor optional
Тип: string optional
См. Polygon3DElement.fillColor .
geodesic optional
Тип: boolean optional
См. Polygon3DElement.geodesic .
innerCoordinates optional
См. Polygon3DElement.innerCoordinates .
outerCoordinates optional
См. Polygon3DElement.outerCoordinates .
strokeColor optional
Тип: string optional
См. Polygon3DElement.strokeColor .
strokeWidth optional
Тип: number optional
См. Polygon3DElement.strokeWidth .
zIndex optional
Тип: number optional
См. Polygon3DElement.zIndex .

Константы 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 Позволяет отображать объекты относительно самой высокой поверхности земли, зданий и воды. Над водой это будет водная поверхность; над рельефом — поверхность здания (при наличии) или поверхность земли (при отсутствии зданий).