3D Maps

Класс Map3DElement

google.maps.maps3d . Map3DElement Класс google.maps.maps3d . Map3DElement

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

Пользовательский элемент:
<gmp-map-3d center="lat,lng,altitude" default-labels-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>
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
Наклон вектора обзора камеры в градусах. Вектор обзора, смотрящий прямо вниз на Землю, будет иметь наклон в ноль градусов. Вектор обзора, направленный от земли, будет иметь наклон 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 См. параметры . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. AddEventListener.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, определяющая тип события, для которого необходимо удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из целевого объекта события.
  • options : boolean| EventListenerOptions optional См. параметры.
Возвращаемое значение: void
Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener.
gmp-centerchange
function(centerChangeEvent)
Аргументы:
Это событие вызывается при изменении свойства center Map3DElement.
gmp-click
function(clickEvent)
Аргументы:
Это событие вызывается при щелчке элемента Map3DElement .
gmp-headingchange
function(headingChangeEvent)
Аргументы:
Это событие вызывается при изменении свойства заголовка Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
Аргументы:
Это событие вызывается при изменении свойства диапазона Map3DElement.
gmp-rollchange
function(rollChangeEvent)
Аргументы:
Это событие вызывается при изменении свойства Roll Map3DElement.
gmp-steadychange
function(steadyChangeEvent)
Аргументы:
Это событие вызывается при изменении устойчивого состояния Map3DElement .
gmp-tiltchange
function(tiltChangeEvent)
Аргументы:
Это событие вызывается при изменении свойства наклона Map3DElement.

Интерфейс Map3DElementOptions

google.maps.maps3d . Map3DElementOptions Интерфейс google.maps.maps3d . Map3DElementOptions

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

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
center optional
defaultLabelsDisabled optional
Тип: boolean optional
heading optional
Тип: number optional
maxAltitude optional
Тип: number optional
maxHeading optional
Тип: number optional
maxTilt optional
Тип: number optional
minAltitude optional
Тип: number optional
minHeading optional
Тип: number optional
minTilt optional
Тип: number optional
range optional
Тип: number optional
roll optional
Тип: number optional
tilt optional
Тип: number optional

Класс SteadyChangeEvent

google.maps.maps3d . SteadyChangeEvent Класс google.maps.maps3d . SteadyChangeEvent

Это событие создается в результате мониторинга устойчивого состояния Map3DElement . Это событие всплывает в дереве DOM.

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

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

isSteady
Тип: boolean
Указывает, является ли Map3DElement устойчивым (т. е. весь рендеринг текущей сцены завершен) или нет.

Класс ClickEvent

google.maps.maps3d . ClickEvent Класс google.maps.maps3d . ClickEvent

Это событие создается при нажатии Map3DElement.

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

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

position
Тип: LatLngAltitude optional
Широта/долгота/высота, которая находилась под курсором в момент возникновения события. Обратите внимание, что на более грубых уровнях будут возвращены менее точные данные. Кроме того, для значения высоты может быть возвращена высота морского дна при нажатии на поверхность воды с более высоких позиций камеры. Это событие всплывает в дереве DOM.

Класс CenterChangeEvent

google.maps.maps3d . CenterChangeEvent Класс google.maps.maps3d . CenterChangeEvent

Это событие создается в результате изменения центра мониторинга в Map3DElement . Это событие всплывает в дереве DOM.

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

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

Класс HeadingChangeEvent

google.maps.maps3d . HeadingChangeEvent Класс google.maps.maps3d . HeadingChangeEvent

Это событие создается в результате мониторинга изменения заголовка в Map3DElement . Это событие всплывает в дереве DOM.

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

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

Класс RangeChangeEvent

google.maps.maps3d . RangeChangeEvent Класс google.maps.maps3d . RangeChangeEvent

Это событие создается в результате отслеживания изменения диапазона в Map3DElement . Это событие всплывает в дереве DOM.

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

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

Класс RollChangeEvent

google.maps.maps3d . RollChangeEvent Класс google.maps.maps3d . RollChangeEvent

Это событие создается в результате отслеживания изменений в Map3DElement . Это событие всплывает в дереве DOM.

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

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

Класс TiltChangeEvent

google.maps.maps3d . TiltChangeEvent Класс google.maps.maps3d . TiltChangeEvent

Это событие создается в результате мониторинга изменения наклона в Map3DElement . Это событие всплывает в дереве DOM.

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

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

Класс Polyline3DElement

google.maps.maps3d . Polyline3DElement Класс google.maps.maps3d . Polyline3DElement

3D-полилиния — это линейное наложение соединенных сегментов линии на 3D-карту.

Пользовательский элемент:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-opacity="number" outer-width="number" stroke-color="string" stroke-opacity="number" stroke-width="number" z-index="number"></gmp-polyline-3d>

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

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

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

Polyline3DElement
Polyline3DElement([options])
Параметры:
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>
outerOpacity
Тип: number optional
Внешняя непрозрачность от 0.0 до 1.0 .
HTML-атрибут:
  • <gmp-polyline-3d outer-opacity="number"></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>
strokeOpacity
Тип: number optional
Непрозрачность обводки от 0.0 до 1.0 .
HTML-атрибут:
  • <gmp-polyline-3d stroke-opacity="number"></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 См. параметры . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. AddEventListener.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, определяющая тип события, для которого необходимо удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из целевого объекта события.
  • options : boolean| EventListenerOptions optional См. параметры.
Возвращаемое значение: void
Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener.

Интерфейс Polyline3DElementOptions

google.maps.maps3d . Polyline3DElementOptions Интерфейс google.maps.maps3d . Polyline3DElementOptions

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

altitudeMode optional
Тип: AltitudeMode optional
По умолчанию: AltitudeMode.ABSOLUTE
coordinates optional
drawsOccludedSegments optional
Тип: boolean optional
По умолчанию: false
extruded optional
Тип: boolean optional
По умолчанию: false
geodesic optional
Тип: boolean optional
По умолчанию: false
outerColor optional
Тип: string optional
outerOpacity optional
Тип: number optional
outerWidth optional
Тип: number optional
strokeColor optional
Тип: string optional
strokeOpacity optional
Тип: number optional
strokeWidth optional
Тип: number optional
zIndex optional
Тип: number optional

Класс Polygon3DElement

google.maps.maps3d . Polygon3DElement Класс google.maps.maps3d . Polygon3DElement

Трехмерный многоугольник (например, трехмерная ломаная линия) определяет ряд связанных координат в упорядоченной последовательности. Кроме того, полигоны образуют замкнутый контур и определяют заполненную область.

Пользовательский элемент:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" fill-opacity="number" geodesic stroke-color="string" stroke-opacity="number" stroke-width="number" z-index="number"></gmp-polygon-3d>

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

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

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

Polygon3DElement
Polygon3DElement([options])
Параметры:
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>
fillOpacity
Тип: number optional
Непрозрачность заливки от 0,0 до 1,0.
HTML-атрибут:
  • <gmp-polygon-3d fill-opacity="number"></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>
strokeOpacity
Тип: number optional
Непрозрачность обводки от 0.0 до 1.0 .
HTML-атрибут:
  • <gmp-polygon-3d stroke-opacity="number"></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 См. параметры . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. AddEventListener.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, определяющая тип события, для которого необходимо удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из целевого объекта события.
  • options : boolean| EventListenerOptions optional См. параметры.
Возвращаемое значение: void
Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener.

Интерфейс Polygon3DElementOptions

google.maps.maps3d . Polygon3DElementOptions Интерфейс google.maps.maps3d . Polygon3DElementOptions

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

altitudeMode optional
Тип: AltitudeMode optional
По умолчанию: AltitudeMode.ABSOLUTE
drawsOccludedSegments optional
Тип: boolean optional
По умолчанию: false
extruded optional
Тип: boolean optional
По умолчанию: false
fillColor optional
Тип: string optional
fillOpacity optional
Тип: number optional
geodesic optional
Тип: boolean optional
По умолчанию: false
innerCoordinates optional
outerCoordinates optional
strokeColor optional
Тип: string optional
strokeOpacity optional
Тип: number optional
strokeWidth optional
Тип: number optional
zIndex optional
Тип: number optional

Константы AltitudeMode

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