Класс 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 | LatLngAltitudeLiteral optional Центр карты указан как LatLngAltitude, где высота указана в метрах над уровнем земли. Обратите внимание, что это не обязательно то место, где расположена камера, поскольку поле range влияет на расстояние камеры от центра карты. Если не установлено, по умолчанию используется значение {lat: 0, lng: 0, altitude: 63170000} . 63170000 метров — это максимально допустимая высота (радиус Земли, умноженный на 10). HTML-атрибут:
|
defaultLabelsDisabled | Тип: 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-атрибут:
|
range | Тип: number optional Расстояние от камеры до центра карты в метрах. HTML-атрибут:
|
roll | Тип: number optional Поворот камеры вокруг вектора обзора в градусах. Чтобы устранить неоднозначность, при отсутствии наклона любой поворот будет интерпретироваться как курс. HTML-атрибут:
|
tilt | Тип: number optional Наклон вектора обзора камеры в градусах. Вектор обзора, смотрящий прямо вниз на Землю, будет иметь наклон в ноль градусов. Вектор обзора, направленный от земли, будет иметь наклон 180 градусов. HTML-атрибут:
|
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: 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 См. Map3DElement.bounds . |
center optional | Тип: LatLngAltitude | LatLngAltitudeLiteral optional См. Map3DElement.center . |
defaultLabelsDisabled 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 . |
range optional | Тип: number optional См. Map3DElement.range . |
roll optional | Тип: number optional См. Map3DElement.roll . |
tilt optional | Тип: number optional См. Map3DElement.tilt . |
Класс SteadyChangeEvent
google.maps.maps3d . SteadyChangeEvent
Класс google.maps.maps3d . SteadyChangeEvent
Это событие создается в результате мониторинга устойчивого состояния Map3DElement
.
Этот класс расширяет 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 Широта/долгота/высота, которая находилась под курсором в момент возникновения события. Обратите внимание, что на более грубых уровнях будут возвращены менее точные данные. Кроме того, для значения высоты может быть возвращена высота морского дна при нажатии на поверхность воды с более высоких позиций камеры. |
Класс CenterChangeEvent
google.maps.maps3d . CenterChangeEvent
Класс google.maps.maps3d . CenterChangeEvent
Это событие создается в результате изменения центра мониторинга на Map3DElement
.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {CenterChangeEvent} = await google.maps.importLibrary("maps3d")
. См. раздел Библиотеки в Maps JavaScript API .
Класс HeadingChangeEvent
google.maps.maps3d . HeadingChangeEvent
Класс google.maps.maps3d . HeadingChangeEvent
Это событие создается в результате мониторинга изменения заголовка в Map3DElement
.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d")
. См. раздел Библиотеки в Maps JavaScript API .
Класс RangeChangeEvent
google.maps.maps3d . RangeChangeEvent
Класс google.maps.maps3d . RangeChangeEvent
Это событие создается в результате отслеживания изменения диапазона в Map3DElement
.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {RangeChangeEvent} = await google.maps.importLibrary("maps3d")
. См. раздел Библиотеки в Maps JavaScript API .
Класс RollChangeEvent
google.maps.maps3d . RollChangeEvent
Класс google.maps.maps3d . RollChangeEvent
Это событие создается в результате мониторинга изменений в Map3DElement
.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {RollChangeEvent} = await google.maps.importLibrary("maps3d")
. См. раздел Библиотеки в Maps JavaScript API .
Класс TiltChangeEvent
google.maps.maps3d . TiltChangeEvent
Класс google.maps.maps3d . TiltChangeEvent
Это событие создается в результате мониторинга изменения наклона в Map3DElement
.
Этот класс расширяет 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-атрибут:
|
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-атрибут:
|
outerOpacity | Тип: number optional Внешняя непрозрачность от 0.0 до 1.0 . HTML-атрибут:
|
outerWidth | Тип: number optional Внешняя ширина находится в диапазоне от 0.0 до 1.0 . Это процент от strokeWidth . HTML-атрибут:
|
strokeColor | Тип: string optional Цвет штриха. Поддерживаются все цвета CSS3, за исключением расширенных именованных цветов. HTML-атрибут:
|
strokeOpacity | Тип: number optional Непрозрачность обводки от 0.0 до 1.0 . HTML-атрибут:
|
strokeWidth | Тип: number optional Ширина штриха в пикселях. HTML-атрибут:
|
zIndex | Тип: number optional zIndex по сравнению с другими полигонами. HTML-атрибут:
|
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener. |
Интерфейс Polyline3DElementOptions
google.maps.maps3d . Polyline3DElementOptions
Интерфейс google.maps.maps3d . Polyline3DElementOptions
Объект Polyline3DElementOptions, используемый для определения свойств, которые можно задать для Polyline3DElement.
Характеристики | |
---|---|
altitudeMode optional | Тип: AltitudeMode optional По умолчанию: AltitudeMode.ABSOLUTE |
coordinates optional | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > 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 См. Polyline3DElement.zIndex . |
Класс 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-атрибут:
|
drawsOccludedSegments | Тип: boolean optional По умолчанию: false Указывает, будут ли нарисованы части многоугольника, которые могут быть перекрыты. Полигоны могут быть перекрыты геометрией карты (например, зданиями). HTML-атрибут:
|
extruded | Тип: boolean optional По умолчанию: false Указывает, следует ли соединить многоугольник с землей. Чтобы выдавить многоугольник, altitudeMode должен быть либо RELATIVE_TO_GROUND , либо ABSOLUTE . HTML-атрибут:
|
fillColor | Тип: string optional Цвет заливки. Поддерживаются все цвета CSS3, за исключением расширенных именованных цветов. HTML-атрибут:
|
fillOpacity | Тип: number optional Непрозрачность заливки от 0,0 до 1,0. HTML-атрибут:
|
geodesic | Тип: boolean optional По умолчанию: false Если true , края многоугольника интерпретируются как геодезические и следуют кривизне Земли. Если false , края многоугольника отображаются как прямые линии в пространстве экрана. HTML-атрибут:
|
innerCoordinates | Тип: Iterable < Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral >> optional Упорядоченная последовательность координат, обозначающая замкнутый контур. В отличие от полилиний, многоугольник может состоять из одного или нескольких контуров, которые создают несколько вырезов внутри многоугольника. |
outerCoordinates | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > optional Упорядоченная последовательность координат, обозначающая замкнутый контур. Высота игнорируется в некоторых режимах и поэтому является необязательной. |
strokeColor | Тип: string optional Цвет штриха. Поддерживаются все цвета CSS3, за исключением расширенных именованных цветов. HTML-атрибут:
|
strokeOpacity | Тип: number optional Непрозрачность обводки от 0.0 до 1.0 . HTML-атрибут:
|
strokeWidth | Тип: number optional Ширина штриха в пикселях. HTML-атрибут:
|
zIndex | Тип: number optional zIndex по сравнению с другими полигонами. HTML-атрибут:
|
Методы | |
---|---|
addEventListener | addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener. |
removeEventListener | removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: 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 | Тип: Iterable < Iterable < LatLngAltitude | LatLngAltitudeLiteral >| Iterable < LatLngLiteral >> optional |
outerCoordinates optional | Тип: Iterable < LatLngAltitude | LatLngAltitudeLiteral | LatLngLiteral > optional |
strokeColor optional | Тип: string optional |
strokeOpacity optional | Тип: number optional |
strokeWidth optional | Тип: number optional |
zIndex optional | Тип: number optional См. Polygon3DElement.zIndex . |
Константы 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 | Позволяет отображать объекты относительно самой высокой поверхности земли+здания+воды. Когда над водой это будет водная поверхность; если над местностью, это будет поверхность здания (если есть) или поверхность земли (если зданий нет). |