Draw on the map

Класс MarkerElement

class google.maps.maps3d.MarkerElement extends HTMLElement implements MarkerElementOptions
extended by MarkerInteractiveElement
library "maps3d"

Показывает местоположение на 3D-карте. Обратите внимание, что для показа MarkerElement необходимо задать position.

MarkerElement поддерживает широкие возможности настройки с помощью пользовательских элементов HTML, но имеет более низкую производительность взаимодействия, чем Marker3DElement, особенно при обработке более 1000 маркеров на карте.

<gmp-marker
  altitude-mode="value-name"
  anchor-left="string"
  anchor-top="string"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  position="lat,lng"
  title="string">
</gmp-marker>
const {MarkerElement} = await google.maps.importLibrary("maps3d");
MarkerElement
MarkerElement([options])
Параметры:
Создает объект MarkerElement с указанными параметрами.
altitudeMode
attr: altitude-mode
Тип входных данных: AltitudeMode optional
Тип выходных данных: AltitudeMode
По умолчанию: AltitudeMode.CLAMP_TO_GROUND.
Определяет, как интерпретируется высота.
HTML-атрибут: altitude-mode="value-name"
anchorLeft
attr: anchor-left
Тип входных данных: string optional
Тип выходных данных: string
По умолчанию: -50 %.
Значение length-percentage в CSS, которое используется для смещения опорной точки относительно левого верхнего угла маркера. Это полезно, если вы используете визуальный элемент, у которого точка привязки отличается от стандартной точки внизу по центру маркера по умолчанию.
HTML-атрибут: anchor-left="string"
anchorTop
attr: anchor-top
Тип входных данных: string optional
Тип выходных данных: string
Значение по умолчанию: -100 %.
Значение length-percentage в CSS, которое используется для смещения опорной точки относительно левого верхнего угла маркера. Это полезно, если вы используете визуальный элемент, у которого точка привязки отличается от стандартной точки внизу по центру маркера по умолчанию.
HTML-атрибут: anchor-top="string"
AlphaautofitsCamera
attr: autofits-camera
Тип: boolean optional
По умолчанию: false.
Если он указан, то будет виден в области просмотра карты вместе с другими элементами, для которых включен показ.
HTML-атрибут: autofits-camera
collisionBehavior
attr: collision-behavior
Тип входных данных: CollisionBehavior optional
Тип выходных данных: CollisionBehavior
По умолчанию: CollisionBehavior.REQUIRED.
Перечисление, определяющее, как должен вести себя MarkerElement при наложении на другой MarkerElement, Marker3DElement или ярлыки базовой карты.
HTML-атрибут: collision-behavior="value-name"
collisionPriority
attr: collision-priority
Тип входных данных: number optional
Тип выходных данных: number optional
Число, которое используется для определения относительного приоритета маркеров CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY (включая Marker3DElement). Чем больше значение collisionPriority, тем выше приоритет.
HTML-атрибут: collision-priority="number"
position
attr: position
Тип входных данных: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Тип выходных данных: LatLngAltitude optional
Местоположение кончика маркера. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
HTML-атрибут:
  • position="lat,lng"
  • position="lat,lng,altitude"
title
attr: title
Тип: string
текст, выводимый при наведении курсора на элемент. Если указан текст специальных возможностей (например, для программ чтения с экрана), он будет добавлен в MarkerElement с указанным значением.
HTML-атрибут: title="string"
default
Любые пользовательские элементы, добавленные непосредственно в MarkerElement, будут размещены в слотах.
z-index
Z-индекс маркера. Подробная информация приведена в документации по z-index. Маркеры с более высоким Z-индексом перекрывают маркеры с меньшим. По умолчанию маркеры отображаются в соответствии с их положением в DOM: маркеры, добавленные в DOM позже, отображаются перед маркерами, добавленными в DOM раньше.
Унаследованные: addEventListener, removeEventListener

Интерфейс MarkerElementOptions

интерфейс google.maps.maps3d.MarkerElementOptions
расширен MarkerInteractiveElementOptions
реализован MarkerElement, MarkerInteractiveElement

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

altitudeMode
необязательно
Тип: AltitudeMode optional
Посмотрите MarkerElement.altitudeMode.
anchorLeft
необязательно
Тип: string optional
Посмотрите MarkerElement.anchorLeft.
anchorTop
необязательно
Тип: string optional
Посмотрите MarkerElement.anchorTop.
AlphaautofitsCamera
необязательно
Тип: boolean optional
Посмотрите AlphaMarkerElement.autofitsCamera.
collisionBehavior
необязательно
Тип: CollisionBehavior optional
Посмотрите MarkerElement.collisionBehavior.
collisionPriority
необязательно
Тип: number optional
Посмотрите MarkerElement.collisionPriority.
position
необязательно
Посмотрите MarkerElement.position.
title
необязательно
Тип: string optional
Посмотрите MarkerElement.title.

Класс MarkerInteractiveElement

class google.maps.maps3d.MarkerInteractiveElement extends MarkerElement, HTMLElement implements MarkerElementOptions, MarkerInteractiveElementOptions
library "maps3d"

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

<gmp-marker-interactive
  gmp-popover-target-element="popover-id">
</gmp-marker-interactive>
const {MarkerInteractiveElement} = await google.maps.importLibrary("maps3d");
MarkerInteractiveElement
MarkerInteractiveElement([options])
Параметры:
Создает MarkerInteractiveElement с указанными параметрами.
gmpPopoverTargetElement
attr: gmp-popover-target-element
Тип входных данных: PopoverElement optional
Тип выходных данных: PopoverElement optional
Если задать этот параметр, всплывающий элемент будет открываться при нажатии на маркер.
HTML-атрибут: gmp-popover-target-element="popover-id"
Унаследованные: altitudeMode (атрибут: altitude-mode), anchorLeft (атрибут: anchor-left), anchorTop (атрибут: anchor-top), AlphaautofitsCamera (атрибут: autofits-camera), collisionBehavior (атрибут: collision-behavior), collisionPriority (атрибут: collision-priority), position (атрибут: position), title (атрибут: title)
Унаследованные: default
Унаследованные: z-index
Унаследованные: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Аргументы:
Это событие активируется при нажатии на элемент MarkerInteractiveElement.

Интерфейс MarkerInteractiveElementOptions

interface google.maps.maps3d.MarkerInteractiveElementOptions extends MarkerElementOptions
implemented by MarkerInteractiveElement

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

gmpPopoverTargetElement
необязательно
Тип: PopoverElement optional
Унаследованные: altitudeMode, anchorLeft, anchorTop, AlphaautofitsCamera, collisionBehavior, collisionPriority, position, title.

Класс Marker3DElement

class google.maps.maps3d.Marker3DElement extends HTMLElement implements Marker3DElementOptions
extended by Marker3DInteractiveElement
library "maps3d"

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

<gmp-marker-3d
  altitude-mode="value-name"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  draws-when-occluded
  extruded
  label="string"
  position="lat,lng"
  size-preserved
  z-index="number">
</gmp-marker-3d>
const {Marker3DElement} = await google.maps.importLibrary("maps3d");
Marker3DElement
Marker3DElement([options])
Параметры:
Создает объект Marker3DElement с указанными параметрами.
altitudeMode
attr: altitude-mode
Тип входных данных: AltitudeMode optional
Тип выходных данных: AltitudeMode
По умолчанию: AltitudeMode.CLAMP_TO_GROUND.
Определяет, как интерпретируется высота.
HTML-атрибут: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Если он указан, то будет виден в области просмотра карты вместе с другими элементами, для которых включен показ.
HTML-атрибут: autofits-camera
collisionBehavior
attr: collision-behavior
Тип входных данных: CollisionBehavior optional
Тип выходных данных: CollisionBehavior
По умолчанию: CollisionBehavior.REQUIRED.
Перечисление, указывающее, как должен вести себя элемент Marker3DElement, когда он сталкивается с другим элементом Marker3DElement или с метками базовой карты.
HTML-атрибут: collision-behavior="value-name"
collisionPriority
attr: collision-priority
Тип входных данных: number optional
Тип выходных данных: number optional
Приоритет, используемый для обнаружения конфликтов.
HTML-атрибут: collision-priority="number"
drawsWhenOccluded
attr: draws-when-occluded
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, нужно ли рисовать маркер, если он перекрыт. Маркер может быть скрыт геометрическими объектами карты (например, зданиями).
HTML-атрибут: draws-when-occluded
extruded
attr: extruded
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, нужно ли соединить маркер с землей. Чтобы вытянуть маркер, для altitudeMode нужно задать значение RELATIVE_TO_GROUND или ABSOLUTE.
HTML-атрибут: extruded
label
attr: label
Тип входных данных: string optional
Тип выходных данных: string optional
Текст, который будет показываться рядом с маркером.
HTML-атрибут: label="string"
position
attr: position
Тип входных данных: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Тип выходных данных: LatLngAltitude optional
Местоположение кончика маркера. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
HTML-атрибут:
  • position="lat,lng"
  • position="lat,lng,altitude"
sizePreserved
attr: size-preserved
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, должен ли маркер сохранять свой размер независимо от расстояния до камеры. По умолчанию размер маркера зависит от расстояния до камеры и угла наклона.
HTML-атрибут: size-preserved
zIndex
attr: z-index
Тип входных данных: number optional
Тип выходных данных: number optional
zIndex по сравнению с другими маркерами.
HTML-атрибут: z-index="number"
default
Любые пользовательские элементы, добавленные непосредственно в Marker3DElement, будут размещены, однако для рисования маркеров будут использоваться только элементы типов HTMLImageElement, SVGElement и PinElement, другие элементы будут игнорироваться.
HTMLImageElement и SVGElement должны быть заключены в элемент <template>, прежде чем их можно будет назначить в слот по умолчанию для Marker3DElement.

Изображения и SVG-файлы перед отрисовкой в 3D-сцене растрируются, поэтому пользовательский HTML-код, встроенный в SVG, или классы CSS, добавленные к изображениям, не будут применяться и могут не отражаться при показе маркеров на экране.
Унаследованные: addEventListener, removeEventListener

Интерфейс Marker3DElementOptions

интерфейс google.maps.maps3d.Marker3DElementOptions
расширен Marker3DInteractiveElementOptions
реализован Marker3DElement, Marker3DInteractiveElement

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

altitudeMode
необязательно
Тип: AltitudeMode optional
Посмотрите Marker3DElement.altitudeMode.
AlphaautofitsCamera
необязательно
Тип: boolean optional
Посмотрите AlphaMarker3DElement.autofitsCamera.
collisionBehavior
необязательно
Тип: CollisionBehavior optional
Посмотрите Marker3DElement.collisionBehavior.
collisionPriority
необязательно
Тип: number optional
Посмотрите Marker3DElement.collisionPriority.
drawsWhenOccluded
необязательно
Тип: boolean optional
Посмотрите Marker3DElement.drawsWhenOccluded.
extruded
необязательно
Тип: boolean optional
Посмотрите Marker3DElement.extruded.
label
необязательно
Тип: string optional
Посмотрите Marker3DElement.label.
position
необязательно
Посмотрите Marker3DElement.position.
sizePreserved
необязательно
Тип: boolean optional
Посмотрите Marker3DElement.sizePreserved.
zIndex
необязательно
Тип: number optional
Посмотрите Marker3DElement.zIndex.

Класс Marker3DInteractiveElement

class google.maps.maps3d.Marker3DInteractiveElement extends Marker3DElement, HTMLElement implements Marker3DElementOptions, Marker3DInteractiveElementOptions
library "maps3d"

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

<gmp-marker-3d-interactive
  gmp-popover-target-element="popover-id"
  title="string">
</gmp-marker-3d-interactive>
const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Параметры:
Создает объект Marker3DInteractiveElement с указанными параметрами.
gmpPopoverTargetElement
attr: gmp-popover-target-element
Тип входных данных: PopoverElement optional
Тип выходных данных: PopoverElement optional
Если задать этот параметр, всплывающий элемент будет открываться при нажатии на маркер.
HTML-атрибут: gmp-popover-target-element="popover-id"
title
attr: title
Тип: string
текст, выводимый при наведении курсора на элемент. Если указан текст специальных возможностей (например, для программ чтения с экрана), он будет добавлен в Marker3DInteractiveElement с указанным значением.
HTML-атрибут: title="string"
Унаследованные: altitudeMode (атрибут: altitude-mode), AlphaautofitsCamera (атрибут: autofits-camera), collisionBehavior (атрибут: collision-behavior), collisionPriority (атрибут: collision-priority), drawsWhenOccluded (атрибут: draws-when-occluded), extruded (атрибут: extruded), label (атрибут: label), position (атрибут: position), sizePreserved (атрибут: size-preserved), zIndex (атрибут: z-index)
default
Любые пользовательские элементы, добавленные непосредственно в Marker3DInteractiveElement, будут размещены, однако для рисования маркеров будут использоваться только элементы типа PinElement, другие элементы будут игнорироваться.
Унаследованные: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Аргументы:
Это событие активируется при нажатии на элемент Marker3DInteractiveElement.
gmp-pointermove
function(pointerMoveEvent)
Аргументы:
Это событие активируется, когда указатель перемещается в пределах элемента Marker3DInteractiveElement.
gmp-pointerout
function(pointerOutEvent)
Аргументы:
Это событие активируется, когда указатель покидает элемент Marker3DInteractiveElement.
gmp-pointerover
function(pointerOverEvent)
Аргументы:
Это событие активируется, когда указатель входит в элемент Marker3DInteractiveElement.

Интерфейс Marker3DInteractiveElementOptions

interface google.maps.maps3d.Marker3DInteractiveElementOptions extends Marker3DElementOptions
implemented by Marker3DInteractiveElement

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

gmpPopoverTargetElement
необязательно
Тип: PopoverElement optional
title
необязательно
Тип: string optional
Посмотрите Marker3DInteractiveElement.title.
Наследуется: altitudeMode, AlphaautofitsCamera, collisionBehavior, collisionPriority, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex.

Класс Model3DElement

class google.maps.maps3d.Model3DElement extends HTMLElement implements Model3DElementOptions
extended by Model3DInteractiveElement
library "maps3d"

3D-модель, которая позволяет отрисовывать модели gLTF. Обратите внимание, что для показа Model3DElement необходимо задать position и src.

Должны поддерживаться основные свойства gLTF PBR. Расширения и их свойства в настоящее время не поддерживаются.

<gmp-model-3d
  altitude-mode="value-name"
  orientation="heading,tilt,roll"
  position="lat,lng"
  scale="number"
  src="url">
</gmp-model-3d>
const {Model3DElement} = await google.maps.importLibrary("maps3d");
Model3DElement
Model3DElement([options])
Параметры:
Создает объект Model3DElement с указанными параметрами.
altitudeMode
attr: altitude-mode
Тип входных данных: AltitudeMode optional
Тип выходных данных: AltitudeMode
По умолчанию: AltitudeMode.CLAMP_TO_GROUND.
Определяет, как интерпретируется высота в позиции.
HTML-атрибут: altitude-mode="value-name"
orientation
attr: orientation
Тип входных данных: Orientation3D|Orientation3DLiteral optional
Тип выходных данных: Orientation3D optional
Описывает поворот системы координат 3D-модели для ее размещения на 3D-карте.

Повороты применяются к модели в следующем порядке: крен, наклон, а затем курс.
HTML-атрибут: orientation="heading,tilt,roll"
position
attr: position
Тип входных данных: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Тип выходных данных: LatLngAltitude optional
Задает положение Model3DElement. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
HTML-атрибут:
  • position="lat,lng"
  • position="lat,lng,altitude"
scale
attr: scale
Тип входных данных: number|Vector3D|Vector3DLiteral optional
Тип выходных данных: Vector3D optional
По умолчанию: 1.
Масштабирует модель по осям X, Y и Z в системе координат модели.
HTML-атрибут:
  • scale="number"
  • scale="x,y,z"
src
attr: src
Тип входных данных: string|URL optional
Тип выходных данных: URL optional
URL 3D-модели. В настоящее время поддерживаются только модели формата .glb.

Относительные URL с протоколом HTTP будут преобразованы в абсолютные.

Обратите внимание, что если вы размещаете файлы модели .glb на сайте или сервере, отличном от основного приложения, вам необходимо настроить правильные HTTP-заголовки CORS. Это позволит вашему приложению безопасно получать доступ к файлам модели из другого домена.
HTML-атрибут: src="url"
Унаследованные: addEventListener, removeEventListener

Интерфейс Model3DElementOptions

интерфейс google.maps.maps3d.Model3DElementOptions
расширен Model3DInteractiveElementOptions
реализован Model3DElement, Model3DInteractiveElement

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

altitudeMode
необязательно
Тип: AltitudeMode optional
Посмотрите Model3DElement.altitudeMode.
orientation
необязательно
Посмотрите Model3DElement.orientation.
position
необязательно
Посмотрите Model3DElement.position.
scale
необязательно
Тип: number|Vector3D|Vector3DLiteral optional
Посмотрите Model3DElement.scale.
src
необязательно
Тип: string|URL optional
Посмотрите Model3DElement.src.

Класс Model3DInteractiveElement

class google.maps.maps3d.Model3DInteractiveElement extends Model3DElement, HTMLElement implements Model3DElementOptions, Model3DInteractiveElementOptions
library "maps3d"

3D-модель, которая позволяет отрисовывать модели gLTF. Обратите внимание, что для показа Model3DElement необходимо задать position и src.

Должны поддерживаться основные свойства gLTF PBR. Расширения и их свойства в настоящее время не поддерживаются.

В отличие от Model3DElement, Model3DInteractiveElement получает событие gmp-click.

<gmp-model-3d-interactive></gmp-model-3d-interactive>
const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Model3DInteractiveElement
Model3DInteractiveElement([options])
Параметры:
Создает Model3DInteractiveElement с указанными параметрами.
Унаследованные: altitudeMode (атрибут: altitude-mode), orientation (атрибут: orientation), position (атрибут: position), scale (атрибут: scale), src (атрибут: src)
Унаследованные: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Аргументы:
Это событие активируется при нажатии на элемент Model3DInteractiveElement.
gmp-pointermove
function(pointerMoveEvent)
Аргументы:
Это событие активируется, когда указатель перемещается в пределах элемента Model3DInteractiveElement.
gmp-pointerout
function(pointerOutEvent)
Аргументы:
Это событие активируется, когда указатель покидает элемент Model3DInteractiveElement.
gmp-pointerover
function(pointerOverEvent)
Аргументы:
Это событие активируется, когда указатель входит в элемент Model3DInteractiveElement.

Интерфейс Model3DInteractiveElementOptions

interface google.maps.maps3d.Model3DInteractiveElementOptions extends Model3DElementOptions
implemented by Model3DInteractiveElement

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

Унаследованные: altitudeMode, orientation, position, scale, src.

Класс Polyline3DElement

class google.maps.maps3d.Polyline3DElement extends HTMLElement implements Polyline3DElementOptions
extended by Polyline3DInteractiveElement
library "maps3d"

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

<gmp-polyline-3d
  altitude-mode="value-name"
  autofits-camera
  draws-occluded-segments
  extruded
  geodesic
  outer-color="string"
  outer-width="number"
  path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
  stroke-color="string"
  stroke-width="number"
  z-index="number">
</gmp-polyline-3d>
const {Polyline3DElement} = await google.maps.importLibrary("maps3d");
Polyline3DElement
Polyline3DElement([options])
Параметры:
Создает объект Polyline3DElement с указанными параметрами.
altitudeMode
attr: altitude-mode
Тип входных данных: AltitudeMode optional
Тип выходных данных: AltitudeMode
По умолчанию: AltitudeMode.CLAMP_TO_GROUND.
Определяет, как интерпретируются компоненты высоты в координатах.
HTML-атрибут: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Если указать ломаную линию, она будет видна в области просмотра карты вместе с другими элементами, для которых включен показ.
HTML-атрибут: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, рисуются ли части ломаной линии, которые могут быть скрыты. Ломаные линии могут быть скрыты геометрическими объектами на карте (например, зданиями).
HTML-атрибут: draws-occluded-segments
extruded
attr: extruded
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, нужно ли соединять ломаную линию с землей. Чтобы вытянуть ломаную линию, для свойства altitudeMode нужно задать значение RELATIVE_TO_GROUND или ABSOLUTE.
HTML-атрибут: extruded
geodesic
attr: geodesic
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Если задано значение true, края ломаной линии интерпретируются как геодезические и следуют кривизне Земли. Если задано значение false, края ломаной линии отображаются на экране как прямые линии.
HTML-атрибут: geodesic
outerColor
attr: outer-color
Тип входных данных: string optional
Тип выходных данных: string optional
Внешний цвет. Поддерживаются все цвета CSS3.
HTML-атрибут: outer-color="string"
outerWidth
attr: outer-width
Тип входных данных: number optional
Тип выходных данных: number optional
Внешняя ширина должна быть в диапазоне от 0.0 до 1.0. Это процент от strokeWidth.
HTML-атрибут: outer-width="number"
path
attr: path
Тип входных данных: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral> optional
Тип выходных данных: Array<LatLngAltitude> optional
Заданная последовательность координат полилинии. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
HTML-атрибут: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
Тип входных данных: string optional
Тип выходных данных: string optional
Цвет штриха. Поддерживаются все цвета CSS3.
HTML-атрибут: stroke-color="string"
strokeWidth
attr: stroke-width
Тип входных данных: number optional
Тип выходных данных: number optional
ширина штриха в пикселях.
HTML-атрибут: stroke-width="number"
zIndex
attr: z-index
Тип входных данных: number optional
Тип выходных данных: number optional
zIndex по сравнению с другими полилиниями.
HTML-атрибут: z-index="number"
coordinates
Заданная последовательность координат полилинии. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
Унаследованные: addEventListener, removeEventListener

Интерфейс Polyline3DElementOptions

интерфейс google.maps.maps3d.Polyline3DElementOptions
расширен Polyline3DInteractiveElementOptions
реализован Polyline3DElement, Polyline3DInteractiveElement

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

altitudeMode
необязательно
Тип: AltitudeMode optional
Посмотрите Polyline3DElement.altitudeMode.
AlphaautofitsCamera
необязательно
Тип: boolean optional
Посмотрите AlphaPolyline3DElement.autofitsCamera.
coordinates
необязательно
Посмотрите Polyline3DElement.coordinates.
drawsOccludedSegments
необязательно
Тип: boolean optional
extruded
необязательно
Тип: boolean optional
Посмотрите Polyline3DElement.extruded.
geodesic
необязательно
Тип: boolean optional
Посмотрите Polyline3DElement.geodesic.
outerColor
необязательно
Тип: string optional
Посмотрите Polyline3DElement.outerColor.
outerWidth
необязательно
Тип: number optional
Посмотрите Polyline3DElement.outerWidth.
path
необязательно
Посмотрите Polyline3DElement.path.
strokeColor
необязательно
Тип: string optional
Посмотрите Polyline3DElement.strokeColor.
strokeWidth
необязательно
Тип: number optional
Посмотрите Polyline3DElement.strokeWidth.
zIndex
необязательно
Тип: number optional
Посмотрите Polyline3DElement.zIndex.

Класс Polyline3DInteractiveElement

class google.maps.maps3d.Polyline3DInteractiveElement extends Polyline3DElement, HTMLElement implements Polyline3DElementOptions, Polyline3DInteractiveElementOptions
library "maps3d"

Трехмерная ломаная линия – это линейное наложение соединенных отрезков прямой на 3D-карту. В отличие от Polyline3DElement, Polyline3DInteractiveElement получает событие gmp-click.

<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
Параметры:
Создает Polyline3DInteractiveElement с указанными параметрами.
Унаследованные: altitudeMode (атрибут: altitude-mode), AlphaautofitsCamera (атрибут: autofits-camera), drawsOccludedSegments (атрибут: draws-occluded-segments), extruded (атрибут: extruded), geodesic (атрибут: geodesic), outerColor (атрибут: outer-color), outerWidth (атрибут: outer-width), path (атрибут: path), strokeColor (атрибут: stroke-color), strokeWidth (атрибут: stroke-width), zIndex (атрибут: z-index), coordinates
Унаследованные: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Аргументы:
  • clickEvent: LocationClickEvent optional Объект события будет содержать широту, долготу и высоту места, где был выполнен клик.
Это событие активируется при нажатии на элемент Polyline3DInteractiveElement.
gmp-pointermove
function(pointerMoveEvent)
Аргументы:
Это событие активируется, когда указатель перемещается в пределах элемента Polyline3DInteractiveElement.
gmp-pointerout
function(pointerOutEvent)
Аргументы:
Это событие активируется, когда указатель покидает элемент Polyline3DInteractiveElement.
gmp-pointerover
function(pointerOverEvent)
Аргументы:
Это событие активируется, когда указатель входит в элемент Polyline3DInteractiveElement.

Интерфейс Polyline3DInteractiveElementOptions

interface google.maps.maps3d.Polyline3DInteractiveElementOptions extends Polyline3DElementOptions
implemented by Polyline3DInteractiveElement

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

Унаследованные: altitudeMode, AlphaautofitsCamera, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, path, strokeColor, strokeWidth, zIndex.

Класс Polygon3DElement

class google.maps.maps3d.Polygon3DElement extends HTMLElement implements Polygon3DElementOptions
extended by Polygon3DInteractiveElement
library "maps3d"

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

<gmp-polygon-3d
  autofits-camera
  draws-occluded-segments
  extruded
  fill-color="string"
  geodesic
  path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
  stroke-color="string"
  stroke-width="number"
  z-index="number">
</gmp-polygon-3d>
const {Polygon3DElement} = await google.maps.importLibrary("maps3d");
Polygon3DElement
Polygon3DElement([options])
Параметры:
Создает объект Polygon3DElement с указанными параметрами.
altitudeMode
Тип входных данных: AltitudeMode optional
Тип выходных данных: AltitudeMode
По умолчанию: AltitudeMode.CLAMP_TO_GROUND.
Определяет, как интерпретируются компоненты высоты в координатах.
AlphaautofitsCamera
attr: autofits-camera
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Если он указан, то будет показан в области просмотра карты вместе с другими элементами, для которых включено отображение.
HTML-атрибут: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, отрисовываются ли части многоугольника, которые могут быть скрыты. Многоугольники могут быть скрыты геометрическими объектами карты (например, зданиями).
HTML-атрибут: draws-occluded-segments
extruded
attr: extruded
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, нужно ли соединить многоугольник с землей. Чтобы вытянуть многоугольник, для свойства altitudeMode нужно задать значение RELATIVE_TO_GROUND или ABSOLUTE.
HTML-атрибут: extruded
fillColor
attr: fill-color
Тип входных данных: string optional
Тип выходных данных: string optional
Цвет заливки. Поддерживаются все цвета CSS3.
HTML-атрибут: fill-color="string"
geodesic
attr: geodesic
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Если задано значение true, края многоугольника интерпретируются как геодезические и следуют кривизне Земли. Если задано значение false, края многоугольника отображаются на экране в виде прямых линий.
HTML-атрибут: geodesic
innerPaths
Тип входных данных: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral>> optional
Тип выходных данных: Array<Array<LatLngAltitude>> optional
Упорядоченная последовательность координат, обозначающих замкнутый контур. В отличие от ломаных линий, многоугольник может состоять из одного или нескольких контуров, которые создают несколько вырезов внутри многоугольника.
path
attr: path
Тип входных данных: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral> optional
Тип выходных данных: Array<LatLngAltitude> optional
Упорядоченная последовательность координат, обозначающих замкнутый контур. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
HTML-атрибут: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
Тип входных данных: string optional
Тип выходных данных: string optional
Цвет штриха. Поддерживаются все цвета CSS3.
HTML-атрибут: stroke-color="string"
strokeWidth
attr: stroke-width
Тип входных данных: number optional
Тип выходных данных: number optional
ширина штриха в пикселях.
HTML-атрибут: stroke-width="number"
zIndex
attr: z-index
Тип входных данных: number optional
Тип выходных данных: number optional
zIndex по сравнению с другими полилиниями.
HTML-атрибут: z-index="number"
outerCoordinates
Упорядоченная последовательность координат, обозначающих замкнутый контур. В некоторых режимах высота игнорируется, поэтому указывать ее необязательно.
innerCoordinates
Упорядоченная последовательность координат, обозначающих замкнутый контур. В отличие от ломаных линий, многоугольник может состоять из одного или нескольких контуров, которые создают несколько вырезов внутри многоугольника.
Унаследованные: addEventListener, removeEventListener

Интерфейс Polygon3DElementOptions

интерфейс google.maps.maps3d.Polygon3DElementOptions
расширен Polygon3DInteractiveElementOptions
реализован Polygon3DElement, Polygon3DInteractiveElement

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

altitudeMode
необязательно
Тип: AltitudeMode optional
Посмотрите Polygon3DElement.altitudeMode.
AlphaautofitsCamera
необязательно
Тип: boolean optional
Посмотрите AlphaPolygon3DElement.autofitsCamera.
drawsOccludedSegments
необязательно
Тип: boolean optional
extruded
необязательно
Тип: boolean optional
Посмотрите Polygon3DElement.extruded.
fillColor
необязательно
Тип: string optional
Посмотрите Polygon3DElement.fillColor.
geodesic
необязательно
Тип: boolean optional
Посмотрите Polygon3DElement.geodesic.
innerCoordinates
необязательно
Посмотрите Polygon3DElement.innerCoordinates.
innerPaths
необязательно
Посмотрите Polygon3DElement.innerPaths.
outerCoordinates
необязательно
Посмотрите Polygon3DElement.outerCoordinates.
path
необязательно
Посмотрите Polygon3DElement.path.
strokeColor
необязательно
Тип: string optional
Посмотрите Polygon3DElement.strokeColor.
strokeWidth
необязательно
Тип: number optional
Посмотрите Polygon3DElement.strokeWidth.
zIndex
необязательно
Тип: number optional
Посмотрите Polygon3DElement.zIndex.

Класс Polygon3DInteractiveElement

class google.maps.maps3d.Polygon3DInteractiveElement extends Polygon3DElement, HTMLElement implements Polygon3DElementOptions, Polygon3DInteractiveElementOptions
library "maps3d"

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

<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
Параметры:
Создает Polygon3DInteractiveElement с указанными параметрами.
Наследуемые: altitudeMode, AlphaautofitsCamera (атрибут: autofits-camera), drawsOccludedSegments (атрибут: draws-occluded-segments), extruded (атрибут: extruded), fillColor (атрибут: fill-color), geodesic (атрибут: geodesic), innerPaths, path (атрибут: path), strokeColor (атрибут: stroke-color), strokeWidth (атрибут: stroke-width), zIndex (атрибут: z-index), outerCoordinates, innerCoordinates
Унаследованные: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Аргументы:
  • clickEvent: LocationClickEvent optional Объект события будет содержать широту, долготу и высоту места, где был выполнен клик.
Это событие активируется при нажатии на элемент Polygon3DInteractiveElement.
gmp-pointermove
function(pointerMoveEvent)
Аргументы:
Это событие активируется, когда указатель перемещается в пределах элемента Polygon3DInteractiveElement.
gmp-pointerout
function(pointerOutEvent)
Аргументы:
Это событие активируется, когда указатель покидает элемент Polygon3DInteractiveElement.
gmp-pointerover
function(pointerOverEvent)
Аргументы:
Это событие активируется, когда указатель входит в элемент Polygon3DInteractiveElement.

Интерфейс Polygon3DInteractiveElementOptions

interface google.maps.maps3d.Polygon3DInteractiveElementOptions extends Polygon3DElementOptions
implemented by Polygon3DInteractiveElement

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

Унаследованные: altitudeMode, AlphaautofitsCamera, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, innerPaths, outerCoordinates, path, strokeColor, strokeWidth, zIndex

Класс FlattenerElement

class google.maps.maps3d.FlattenerElement extends HTMLElement implements FlattenerElementOptions
library "maps3d"

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

<gmp-flattener
  path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ...">
</gmp-flattener>
const {FlattenerElement} = await google.maps.importLibrary("maps3d");
FlattenerElement
FlattenerElement([options])
Параметры:
innerPaths
Тип входных данных: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral>> optional
Тип выходных данных: Array<Array<LatLngAltitude>> optional
Упорядоченная последовательность координат, обозначающих замкнутый контур. Эти контуры определяют исключенные области в основном контуре многоугольника, который является зоной выравнивания. Области внутри innerPath не выравниваются.
path
attr: path
Тип входных данных: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral> optional
Тип выходных данных: Array<LatLngAltitude> optional
Упорядоченная последовательность координат, обозначающих замкнутый контур. Это правило действует в зоне выравнивания.
HTML-атрибут: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
Унаследованные: addEventListener, removeEventListener

Интерфейс FlattenerElementOptions

интерфейс google.maps.maps3d.FlattenerElementOptions
реализован FlattenerElement

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

innerPaths
необязательно
Посмотрите FlattenerElement.innerPaths.
path
необязательно
Посмотрите FlattenerElement.path.

Класс Label3DElement

class google.maps.maps3d.Label3DElement extends HTMLElement implements Label3DElementOptions
library "maps3d"

Представляет текстовую метку, связанную с 3D-маркером на карте, что позволяет независимо настраивать такие свойства, как поведение при наложении.

<gmp-label-3d
  collision-behavior="value-name"
  for="marker-id">
</gmp-label-3d>
const {Label3DElement} = await google.maps.importLibrary("maps3d");
Label3DElement
Label3DElement([options])
Параметры:
Создает объект Label3DElement с указанными параметрами.
collisionBehavior
attr: collision-behavior
Тип входных данных: CollisionBehavior optional
Тип выходных данных: CollisionBehavior optional
По умолчанию: CollisionBehavior.REQUIRED.
Перечисление, определяющее, как должна вести себя метка Marker3DElement при наложении на другой элемент.
HTML-атрибут: collision-behavior="value-name"
for
attr: for
Тип входных данных: string|HTMLElement optional
Тип выходных данных: string|HTMLElement optional
Marker3DElement, к которому относится этот ярлык.
HTML-атрибут: for="marker-id"
Унаследованные: addEventListener, removeEventListener

Интерфейс Label3DElementOptions

интерфейс google.maps.maps3d.Label3DElementOptions
реализован Label3DElement

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

collisionBehavior
необязательно
Тип: CollisionBehavior optional
Перечисление, определяющее, как должна вести себя метка Marker3DElement при наложении на другой элемент.
for
необязательно
Тип: string|HTMLElement optional
Marker3DElement, к которому относится этот ярлык.

Класс PopoverElement

class google.maps.maps3d.PopoverElement extends HTMLElement implements PopoverElementOptions
library "maps3d"

Пользовательский элемент HTML, который отображает всплывающее окно. Оно похоже на всплывающую подсказку и часто связано с маркером.

<gmp-popover
  auto-pan-disabled
  light-dismiss-disabled
  open
  position-anchor="lat,lng">
</gmp-popover>
const {PopoverElement} = await google.maps.importLibrary("maps3d");
PopoverElement
PopoverElement([options])
Параметры:
altitudeMode
Тип входных данных: AltitudeMode optional
Тип выходных данных: AltitudeMode
По умолчанию: AltitudeMode.CLAMP_TO_GROUND.
Определяет, как интерпретируется высота.
autoPanDisabled
attr: auto-pan-disabled
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Если задано значение true, отключает панорамирование карты, чтобы всплывающее окно было полностью видно при открытии.
HTML-атрибут: auto-pan-disabled
lightDismissDisabled
attr: light-dismiss-disabled
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, должно ли это всплывающее окно быть "легко отклоняемым" или нет. Поведение "light dismiss" похоже на настройку атрибута popover="auto", который является частью Popover API браузера.
HTML-атрибут: light-dismiss-disabled
open
attr: open
Тип входных данных: boolean optional
Тип выходных данных: boolean
По умолчанию: false.
Указывает, должно ли быть открыто это всплывающее окно.
HTML-атрибут: open
positionAnchor
attr: position-anchor
Позиция, в которой будет показано всплывающее окно. Если всплывающее окно привязано к интерактивному маркеру, будет использоваться позиция маркера.
HTML-атрибут:
  • position-anchor="lat,lng"
  • position-anchor="lat,lng,altitude"
  • position-anchor="marker-id"
default
Размещает контент в основной части всплывающего окна.
header
Размещает контент в заголовке всплывающего окна.
--gmp-popover-max-width
Максимальная ширина всплывающего окна независимо от ширины контента.
--gmp-popover-min-width
Минимальная ширина всплывающего окна независимо от ширины контента. При использовании этого свойства настоятельно рекомендуется задать для него значение, которое меньше ширины карты (в пикселях).
--gmp-popover-pixel-offset-x
Смещение по оси X (в пикселях) между кончиком всплывающего окна и точкой на карте, к географическим координатам которой оно привязано.
--gmp-popover-pixel-offset-y
Смещение по оси Y (в пикселях) кончика всплывающего окна от точки на карте, к географическим координатам которой привязано всплывающее окно.
background-color
Цвет фона всплывающего окна. Подробная информация приведена в документации по background-color. Обратите внимание, что это свойство также влияет на всплывающее окно места по умолчанию. Чтобы не менять стиль всплывающего окна по умолчанию, используйте целевые классы CSS или встроенные стили для настраиваемых всплывающих окон.
border-radius
Радиус границы всплывающего окна. Подробная информация приведена в документации по border-radius. Обратите внимание, что это свойство также влияет на всплывающее окно места по умолчанию. Чтобы не менять стиль всплывающего окна по умолчанию, используйте целевые классы CSS или встроенные стили для настраиваемых всплывающих окон.
box-shadow
Тень всплывающего окна. Подробная информация приведена в документации по box-shadow. Обратите внимание, что это свойство также влияет на всплывающее окно места по умолчанию. Чтобы не менять стиль всплывающего окна по умолчанию, используйте целевые классы CSS или встроенные стили для настраиваемых всплывающих окон.
color-scheme
Указывает, в какой цветовой схеме может отображаться это всплывающее окно. Подробная информация приведена в документации по color-scheme. Если не указано, по умолчанию используются настройки цветовой схемы пользователя.
padding
Отступы всплывающего окна. Подробная информация приведена в документации по padding. Обратите внимание, что это свойство также влияет на всплывающее окно места по умолчанию. Чтобы не менять стиль всплывающего окна по умолчанию, используйте целевые классы CSS или встроенные стили для настраиваемых всплывающих окон.
Унаследованные: addEventListener, removeEventListener

Интерфейс PopoverElementOptions

интерфейс google.maps.maps3d.PopoverElementOptions
реализован PopoverElement

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

altitudeMode
необязательно
Тип: AltitudeMode optional
Посмотрите PopoverElement.altitudeMode.
autoPanDisabled
необязательно
Тип: boolean optional
Посмотрите PopoverElement.autoPanDisabled.
lightDismissDisabled
необязательно
Тип: boolean optional
open
необязательно
Тип: boolean optional
Посмотрите PopoverElement.open.
positionAnchor
необязательно
Посмотрите PopoverElement.positionAnchor.

Константы AltitudeMode

константы google.maps.maps3d.AltitudeMode
библиотека "maps3d"

Определяет, как интерпретируются компоненты высоты в координатах.

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

const {AltitudeMode} = await google.maps.importLibrary("maps3d");
ABSOLUTE Позволяет выражать объекты относительно среднего уровня моря. Это также означает, что если уровень детализации рельефа под объектом изменится, его абсолютное положение останется прежним.
CLAMP_TO_GROUND Позволяет выражать объекты, размещенные на земле. Они будут оставаться на уровне земли, повторяя рельеф местности, независимо от указанной высоты. Если объект расположен над крупным водоемом, он будет размещен на уровне моря.
RELATIVE_TO_GROUND Позволяет выражать объекты относительно поверхности земли. Если уровень детализации рельефа изменится, положение объекта относительно земли останется прежним. Если объект находится над водой, высота будет интерпретироваться как значение в метрах над уровнем моря.
RELATIVE_TO_MESH Позволяет выражать объекты относительно самой высокой точки земли, здания или водной поверхности. Если вы находитесь над водой, это будет водная поверхность; если над сушей – поверхность здания (при наличии) или поверхность земли (если зданий нет).

Класс CirclePathElement

class google.maps.maps3d.CirclePathElement extends HTMLElement implements CirclePathElementOptions
library "maps3d"

Трехмерный круг на трехмерной карте.

<gmp-circle-path
  center="lat,lng,altitude"
  radius="number">
</gmp-circle-path>
const {CirclePathElement} = await google.maps.importLibrary("maps3d");
CirclePathElement
CirclePathElement([options])
Параметры:
Создает CirclePathElement с указанными параметрами.
center
attr: center
Тип входных данных: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Тип выходных данных: LatLngAltitude optional
Центр круга.
HTML-атрибут: center="lat,lng,altitude"
radius
attr: radius
Тип входных данных: number optional
Тип выходных данных: number optional
Радиус круга в метрах.
HTML-атрибут: radius="number"
Унаследованные: addEventListener, removeEventListener

Интерфейс CirclePathElementOptions

интерфейс google.maps.maps3d.CirclePathElementOptions
реализован CirclePathElement

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

center
необязательно
Посмотрите CirclePathElement.center.
radius
необязательно
Тип: number optional
Посмотрите CirclePathElement.radius.