Draw on the map

MarkerElement 클래스

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

3D 지도에 위치를 표시합니다. MarkerElement를 표시하려면 position를 설정해야 합니다.

      
<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
위치의 고도 구성요소가 해석되는 방식을 지정합니다.
HTML 속성: altitude-mode="value-name"
anchorLeft
attr: anchor-left
입력 유형: string optional
출력 유형: string
기본값: -50%
마커의 왼쪽 상단에서 기준점을 오프셋하는 데 사용되는 CSS 길이 백분율 값입니다. 이는 기본 마커의 일반적인 하단 중앙 지점과 다른 기준점이 있는 시각적 요소를 사용할 때 유용합니다.
HTML 속성: anchor-left="string"
anchorTop
attr: anchor-top
입력 유형: string optional
출력 유형: string
기본값: -100%
마커의 왼쪽 상단에서 기준점을 오프셋하는 데 사용되는 CSS 길이 백분율 값입니다. 이는 기본 마커의 일반적인 하단 중앙 지점과 다른 기준점이 있는 시각적 요소를 사용할 때 유용합니다.
HTML 속성: anchor-top="string"
AlphaautofitsCamera
attr: autofits-camera
유형: boolean optional
기본값: false
제공된 경우 지정된 마커가 선택한 다른 요소와 함께 지도 표시 영역 내에 표시됩니다.
HTML 속성: autofits-camera
collisionBehavior
attr: collision-behavior
입력 유형: CollisionBehavior optional
출력 유형: CollisionBehavior
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
입력 유형: 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-색인이 큰 마커가 겹치면 Z-색인이 작은 마커를 가립니다. 기본적으로 마커는 DOM 위치에 따라 표시되며, DOM에 나중에 추가된 마커가 DOM에 먼저 추가된 마커 앞에 표시됩니다.
상속됨: addEventListener, removeEventListener

MarkerElementOptions 인터페이스

google.maps.maps3d.MarkerElementOptions 인터페이스

MarkerElement에 설정할 수 있는 속성을 정의하는 데 사용되는 MarkerElementOptions 객체입니다.

altitudeMode
선택사항
유형: AltitudeMode optional
MarkerElement.altitudeMode를 참조하세요.
anchorLeft
선택사항
유형: string optional
MarkerElement.anchorLeft를 참조하세요.
anchorTop
선택사항
유형: string optional
MarkerElement.anchorTop를 참조하세요.
AlphaautofitsCamera
선택사항
유형: boolean optional
AlphaMarkerElement.autofitsCamera를 참조하세요.
collisionBehavior
선택사항
유형: CollisionBehavior optional
collisionPriority
선택사항
유형: number optional
position
선택사항
MarkerElement.position를 참조하세요.
title
선택사항
유형: string optional
MarkerElement.title를 참조하세요.

MarkerInteractiveElement 클래스

google.maps.maps3d.MarkerInteractiveElement class
extends MarkerElement
implements 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 (attr: altitude-mode), anchorLeft (attr: anchor-left), anchorTop (attr: anchor-top), AlphaautofitsCamera (attr: autofits-camera), collisionBehavior (attr: collision-behavior), collisionPriority (attr: collision-priority), position (attr: position), title (attr: title)
상속됨: default
상속됨: z-index
상속됨: addEventListener, removeEventListener
gmp-click
function(clickEvent)
인수:
이 이벤트는 MarkerInteractiveElement 요소를 클릭하면 실행됩니다.

MarkerInteractiveElementOptions 인터페이스

google.maps.maps3d.MarkerInteractiveElementOptions interface
extends MarkerElementOptions

MarkerInteractiveElement에 설정할 수 있는 속성을 정의하는 데 사용되는 MarkerInteractiveElementOptions 객체입니다.

gmpPopoverTargetElement
선택사항
유형: PopoverElement optional
상속됨: altitudeMode, anchorLeft, anchorTop, AlphaautofitsCamera, collisionBehavior, collisionPriority, position, title

<p>Marker3DElement 클래스

google.maps.maps3d.Marker3DElement class
extends HTMLElement
implements Marker3DElementOptions
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
위치의 고도 구성요소가 해석되는 방식을 지정합니다.
HTML 속성: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
입력 유형: boolean optional
출력 유형: boolean
기본값: false
제공된 경우 지정된 마커가 선택한 다른 요소와 함께 지도 표시 영역 내에 표시됩니다.
HTML 속성: autofits-camera
collisionBehavior
attr: collision-behavior
입력 유형: CollisionBehavior optional
출력 유형: CollisionBehavior
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
입력 유형: 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는 Marker3DElement의 기본 슬롯에 할당하기 전에 <template> 요소로 래핑해야 합니다.

이미지와 SVG는 현재 3D 장면에 렌더링되기 전에 래스터화되므로 SVG에 삽입된 맞춤 HTML 또는 이미지에 추가된 CSS 클래스는 적용되지 않으며 마커가 화면에 표시될 때 반영되지 않을 수 있습니다.
상속됨: addEventListener, removeEventListener

Marker3DElementOptions 인터페이스

google.maps.maps3d.Marker3DElementOptions 인터페이스

Marker3DElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Marker3DElementOptions 객체입니다.

altitudeMode
선택사항
유형: AltitudeMode optional
Marker3DElement.altitudeMode를 참조하세요.
AlphaautofitsCamera
선택사항
유형: boolean optional
AlphaMarker3DElement.autofitsCamera를 참조하세요.
collisionBehavior
선택사항
유형: CollisionBehavior optional
collisionPriority
선택사항
유형: number optional
drawsWhenOccluded
선택사항
유형: boolean optional
extruded
선택사항
유형: boolean optional
Marker3DElement.extruded를 참조하세요.
label
선택사항
유형: string optional
Marker3DElement.label를 참조하세요.
position
선택사항
Marker3DElement.position를 참조하세요.
sizePreserved
선택사항
유형: boolean optional
Marker3DElement.sizePreserved를 참조하세요.
zIndex
선택사항
유형: number optional
Marker3DElement.zIndex를 참조하세요.

Marker3DInteractiveElement 클래스

google.maps.maps3d.Marker3DInteractiveElement class
extends Marker3DElement
implements 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 (attr: altitude-mode), AlphaautofitsCamera (attr: autofits-camera), collisionBehavior (attr: collision-behavior), collisionPriority (attr: collision-priority), drawsWhenOccluded (attr: draws-when-occluded), extruded (attr: extruded), label (attr: label), position (attr: position), sizePreserved (attr: size-preserved), zIndex (attr: z-index)
default
Marker3DInteractiveElement에 직접 추가된 모든 맞춤 요소는 슬롯에 배치되지만 PinElement 유형의 요소만 마커를 그리는 데 사용되며 다른 요소는 무시됩니다.
상속됨: addEventListener, removeEventListener
gmp-click
function(clickEvent)
인수:
이 이벤트는 Marker3DInteractiveElement 요소를 클릭하면 실행됩니다.

Marker3DInteractiveElementOptions 인터페이스

google.maps.maps3d.Marker3DInteractiveElementOptions interface
extends Marker3DElementOptions

Marker3DInteractiveElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Marker3DInteractiveElementOptions 객체입니다.

gmpPopoverTargetElement
선택사항
유형: PopoverElement optional
title
선택사항
유형: string optional
상속됨: altitudeMode, AlphaautofitsCamera, collisionBehavior, collisionPriority, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Model3DElement 클래스

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

glTF 모델을 렌더링할 수 있는 3D 모델입니다. 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
위치의 고도가 해석되는 방식을 지정합니다.
HTML 속성: altitude-mode="value-name"
orientation
attr: orientation
입력 유형: Orientation3D|Orientation3DLiteral optional
출력 유형: Orientation3D optional
3D 지도에 모델을 배치하기 위한 3D 모델 좌표계의 회전을 설명합니다.

회전은 롤, 기울기, 방향 순서로 모델에 적용됩니다.
HTML 속성: orientation="heading,tilt,roll"
position
attr: position
입력 유형: 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
3D 모델의 URL을 지정합니다. 현재는 .glb 형식의 모델만 지원됩니다.

상대 HTTP URL은 상응하는 절대 URL로 변환됩니다.

기본 애플리케이션과 다른 웹사이트 또는 서버에서 .glb 모델 파일을 호스팅하는 경우 올바른 CORS HTTP 헤더를 설정해야 합니다. 이렇게 하면 애플리케이션이 다른 도메인의 모델 파일에 안전하게 액세스할 수 있습니다.
HTML 속성: src="url"
상속됨: addEventListener, removeEventListener

Model3DElementOptions 인터페이스

google.maps.maps3d.Model3DElementOptions 인터페이스

Model3DElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Model3DElementOptions 객체입니다.

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 클래스

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

glTF 모델을 렌더링할 수 있는 3D 모델입니다. 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 (attr: altitude-mode), orientation (attr: orientation), position (attr: position), scale (attr: scale), src (attr: src)
상속됨: addEventListener, removeEventListener
gmp-click
function(clickEvent)
인수:
이 이벤트는 Model3DInteractiveElement 요소를 클릭하면 실행됩니다.

Model3DInteractiveElementOptions 인터페이스

google.maps.maps3d.Model3DInteractiveElementOptions interface
extends Model3DElementOptions

Model3DInteractiveElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Model3DInteractiveElementOptions 객체입니다.

상속됨: altitudeMode, orientation, position, scale, src

Polyline3DElement 클래스

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

3D 다중선은 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
좌표의 고도 구성요소가 해석되는 방식을 지정합니다.
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|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 인터페이스

Polyline3DElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Polyline3DElementOptions 객체입니다.

altitudeMode
선택사항
유형: AltitudeMode optional
Polyline3DElement.altitudeMode를 참조하세요.
AlphaautofitsCamera
선택사항
유형: boolean optional
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 클래스

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

3D 다중선은 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 (attr: altitude-mode), AlphaautofitsCamera (attr: autofits-camera), drawsOccludedSegments (attr: draws-occluded-segments), extruded (attr: extruded), geodesic (attr: geodesic), outerColor (attr: outer-color), outerWidth (attr: outer-width), path (attr: path), strokeColor (attr: stroke-color), strokeWidth (attr: stroke-width), zIndex (attr: z-index), coordinates
상속됨: addEventListener, removeEventListener
gmp-click
function(clickEvent)
인수:
  • clickEvent: LocationClickEvent optional 이벤트 객체에는 클릭의 위도-경도-고도 위치가 포함됩니다.
이 이벤트는 Polyline3DInteractiveElement 요소를 클릭하면 실행됩니다.

Polyline3DInteractiveElementOptions 인터페이스

google.maps.maps3d.Polyline3DInteractiveElementOptions interface
extends Polyline3DElementOptions

Polyline3DInteractiveElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Polyline3DInteractiveElementOptions 객체입니다.

상속됨: altitudeMode, AlphaautofitsCamera, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, path, strokeColor, strokeWidth, zIndex

Polygon3DElement 클래스

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

3D 다각형은 3D 다중선과 마찬가지로 순서가 지정된 일련의 연결된 좌표를 정의합니다. 또한 다각형은 닫힌 루프를 형성하고 채워진 영역을 정의합니다.

    
<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
좌표의 고도 구성요소가 해석되는 방식을 지정합니다.
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|LatLngLiteral>> optional
출력 유형: Array<Array<LatLngAltitude>> optional
닫힌 루프를 지정하는, 순서대로 된 좌표입니다. 다중선과 달리 다각형은 하나 이상의 경로로 구성될 수 있으며, 이 경로는 다각형 내부에 여러 개의 컷아웃을 만듭니다.
path
attr: path
입력 유형: Iterable<LatLngAltitude|LatLngAltitudeLiteral|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 인터페이스

Polygon3DElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Polygon3DElementOptions 객체입니다.

altitudeMode
선택사항
유형: AltitudeMode optional
Polygon3DElement.altitudeMode를 참조하세요.
AlphaautofitsCamera
선택사항
유형: boolean optional
drawsOccludedSegments
선택사항
유형: boolean optional
extruded
선택사항
유형: boolean optional
Polygon3DElement.extruded를 참조하세요.
fillColor
선택사항
유형: string optional
Polygon3DElement.fillColor를 참조하세요.
geodesic
선택사항
유형: boolean optional
Polygon3DElement.geodesic를 참조하세요.
innerCoordinates
선택사항
innerPaths
선택사항
Polygon3DElement.innerPaths를 참조하세요.
outerCoordinates
선택사항
path
선택사항
Polygon3DElement.path를 참조하세요.
strokeColor
선택사항
유형: string optional
Polygon3DElement.strokeColor를 참조하세요.
strokeWidth
선택사항
유형: number optional
Polygon3DElement.strokeWidth를 참조하세요.
zIndex
선택사항
유형: number optional
Polygon3DElement.zIndex를 참조하세요.

<p>Polygon3DInteractiveElement 클래스

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

3D 다각형은 3D 다중선과 마찬가지로 순서가 지정된 일련의 연결된 좌표를 정의합니다. 또한 다각형은 닫힌 루프를 형성하고 채워진 영역을 정의합니다. 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 (attr: autofits-camera), drawsOccludedSegments (attr: draws-occluded-segments), extruded (attr: extruded), fillColor (attr: fill-color), geodesic (attr: geodesic), innerPaths, path (attr: path), strokeColor (attr: stroke-color), strokeWidth (attr: stroke-width), zIndex (attr: z-index), outerCoordinates, innerCoordinates
상속됨: addEventListener, removeEventListener
gmp-click
function(clickEvent)
인수:
  • clickEvent: LocationClickEvent optional 이벤트 객체에는 클릭의 위도-경도-고도 위치가 포함됩니다.
이 이벤트는 Polygon3DInteractiveElement 요소를 클릭하면 실행됩니다.

Polygon3DInteractiveElementOptions 인터페이스

google.maps.maps3d.Polygon3DInteractiveElementOptions interface
extends Polygon3DElementOptions

Polygon3DInteractiveElement에 설정할 수 있는 속성을 정의하는 데 사용되는 Polygon3DInteractiveElementOptions 객체입니다.

상속됨: altitudeMode, AlphaautofitsCamera, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, innerPaths, outerCoordinates, path, strokeColor, strokeWidth, zIndex

FlattenerElement 클래스

google.maps.maps3d.FlattenerElement class
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|LatLngLiteral>> optional
출력 유형: Array<Array<LatLngAltitude>> optional
닫힌 루프를 지정하는, 순서대로 된 좌표입니다. 이러한 경로는 평탄화 영역인 다각형의 기본 경로 내에서 제외 구멍을 정의합니다. innerPath 내의 영역은 평면화에서 제외됩니다.
path
attr: path
입력 유형: Iterable<LatLngAltitude|LatLngAltitudeLiteral|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 객체입니다.

innerPaths
선택사항
FlattenerElement.innerPaths를 참조하세요.
path
선택사항
FlattenerElement.path를 참조하세요.

PopoverElement 클래스

google.maps.maps3d.PopoverElement class
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
위치의 고도 구성요소가 해석되는 방식을 지정합니다.
autoPanDisabled
attr: auto-pan-disabled
입력 유형: boolean optional
출력 유형: boolean
기본값: false
true로 설정하면 팝오버가 열릴 때 완전히 표시되도록 지도를 화면 이동하는 기능이 사용 중지됩니다.
HTML 속성: auto-pan-disabled
lightDismissDisabled
attr: light-dismiss-disabled
입력 유형: boolean optional
출력 유형: boolean
기본값: false
이 팝오버를 '가볍게 닫을'지 여부를 지정합니다. '가벼운 닫기' 동작은 브라우저 Popover API의 일부인 popover="auto" 속성을 설정하는 것과 유사합니다.
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 객체입니다.

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 클래스

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

3D 지도에 표시된 3D 원 오버레이

 
<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
입력 유형: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral 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 객체입니다.

center
선택사항
CirclePathElement.center를 참조하세요.
radius
선택사항
유형: number optional
CirclePathElement.radius를 참조하세요.