이 페이지는 Cloud Translation API를 통해 번역되었습니다.

3D Maps

Map3DElement 클래스

google.maps.maps3d.Map3DElement 클래스

Map3DElement는 3D 지도 뷰의 HTML 인터페이스입니다.

맞춤 요소:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>

이 클래스는 HTMLElement를 확장합니다.

이 클래스는 Map3DElementOptions를 구현합니다.

const {Map3DElement} = await google.maps.importLibrary("maps3d")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

생성자
`Map3DElement`	`Map3DElement([options])` 매개변수: `options`: `Map3DElementOptions optional`

속성
`bounds`	유형: `LatLngBounds\|LatLngBoundsLiteral optional` 설정된 경우 지정된 위도/경도 범위 내에서 카메라 위치를 제한합니다. 경계 외부의 객체는 계속 렌더링됩니다. 경계는 경도와 위도를 모두 제한할 수도 있고 위도 또는 경도만 제한할 수도 있습니다. 위도 전용 경계의 경우 각각 `-180` 및 `180`의 서쪽 및 동쪽 경도를 사용합니다. 경도 전용 경계의 경우 각각 `90` 및 `-90`의 북쪽 및 남쪽 위도를 사용합니다.
`center`	유형: `LatLngAltitude\|LatLngAltitudeLiteral optional` 지도의 중심입니다. LatLngAltitude로 지정되며 고도는 지상에서 미터 단위입니다. `range` 필드는 카메라와 지도 중심 간 거리에 영향을 미치므로 카메라가 반드시 이 위치에 있는 것은 아닙니다. 설정하지 않으면 기본값은 `{lat: 0, lng: 0, altitude: 63170000}`입니다. 63,170,000미터는 허용되는 최대 고도입니다 (지구 반지름에 10을 곱한 값). HTML 속성: `<gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>`
`defaultLabelsDisabled`	유형: `boolean optional` 기본값: `false` `true`인 경우 기본 지도 라벨이 렌더링되지 않습니다. HTML 속성: `<gmp-map-3d default-labels-disabled></gmp-map-3d>`
`defaultUIDisabled`	유형: `boolean optional` 기본값: `false` `true`인 경우 모든 기본 UI 버튼이 사용 중지됩니다. 키보드 및 동작 컨트롤을 사용 중지하지 않습니다. HTML 속성: `<gmp-map-3d default-ui-disabled></gmp-map-3d>`
`heading`	유형: `number optional` 지도의 나침반 방향입니다(단위: 도). 정북은 0입니다. 기울기가 없으면 모든 롤이 방향으로 해석됩니다. HTML 속성: `<gmp-map-3d heading="number"></gmp-map-3d>`
`maxAltitude`	유형: `number optional` 지도에 표시되는 지상 위의 최대 고도입니다. 유효한 값은 `0`~`63170000`미터 (지구 반지름에 10을 곱한 값)입니다. HTML 속성: `<gmp-map-3d max-altitude="number"></gmp-map-3d>`
`maxHeading`	유형: `number optional` 지도의 최대 방위각 (회전)입니다. 유효한 값은 `0`~`360`도 사이입니다. `minHeading`와 `maxHeading`는 방향 제스처가 허용되는 `360`도 이하의 간격을 나타냅니다. `minHeading = 180` 및 `maxHeading = 90`은 `[0, 90]`의 헤딩과 `[180, 360]`의 헤딩을 허용합니다. `minHeading = 90` 및 `maxHeading = 180`은 `[90, 180]`에서 헤딩을 허용합니다. HTML 속성: `<gmp-map-3d max-heading="number"></gmp-map-3d>`
`maxTilt`	유형: `number optional` 지도의 최대 입사각입니다. 유효한 값은 `0`~`90`도 사이입니다. HTML 속성: `<gmp-map-3d max-tilt="number"></gmp-map-3d>`
`minAltitude`	유형: `number optional` 지도에 표시되는 지상 위의 최소 고도입니다. 유효한 값은 `0`~`63170000`미터 (지구 반지름에 10을 곱한 값)입니다. HTML 속성: `<gmp-map-3d min-altitude="number"></gmp-map-3d>`
`minHeading`	유형: `number optional` 지도의 최소 방위각 (회전)입니다. 유효한 값은 `0`~`360`도 사이입니다. `minHeading`와 `maxHeading`는 방향 제스처가 허용되는 `360`도 이하의 간격을 나타냅니다. `minHeading = 180` 및 `maxHeading = 90`은 `[0, 90]`의 헤딩과 `[180, 360]`의 헤딩을 허용합니다. `minHeading = 90` 및 `maxHeading = 180`은 `[90, 180]`에서 헤딩을 허용합니다. HTML 속성: `<gmp-map-3d min-heading="number"></gmp-map-3d>`
`minTilt`	유형: `number optional` 지도의 최소 입사각입니다. 유효한 값은 `0`~`90`도 사이입니다. HTML 속성: `<gmp-map-3d min-tilt="number"></gmp-map-3d>`
`range`	유형: `number optional` 카메라에서 지도 중심까지의 거리(미터)입니다. HTML 속성: `<gmp-map-3d range="number"></gmp-map-3d>`
`roll`	유형: `number optional` 뷰 벡터를 기준으로 한 카메라의 회전입니다(단위: 도). 모호성을 해결하기 위해 기울기가 없으면 모든 롤이 방향으로 해석됩니다. HTML 속성: `<gmp-map-3d roll="number"></gmp-map-3d>`
`tilt`	유형: `number optional` 카메라의 뷰 벡터의 기울기(도)입니다. 지구를 바로 아래에서 바라보는 뷰 벡터의 기울기는 0도입니다. 지구에서 멀어지는 뷰 벡터의 기울기는 `180`도입니다. HTML 속성: `<gmp-map-3d tilt="number"></gmp-map-3d>`

메서드
`addEventListener`	알림: v=beta 채널에서만 사용할 수 있습니다. `addEventListener(type, listener[, options])` 매개변수: `type`: `string` 수신할 이벤트 유형을 나타내는 대소문자를 구분하는 문자열입니다. `listener`: `EventListener\|EventListenerObject` 알림을 수신하는 객체입니다. handleEvent 메서드가 있는 함수 또는 객체여야 합니다. `options`: `boolean\|AddEventListenerOptions optional` 옵션을 참고하세요. 맞춤 이벤트는 `capture` 및 `passive`만 지원합니다. 반환 값: `void` 지정된 이벤트가 타겟에 전달될 때마다 호출될 함수를 설정합니다. addEventListener를 참고하세요.
`flyCameraAround`	`flyCameraAround(options)` 매개변수: `options`: `FlyAroundAnimationOptions` 반환 값: None 이 메서드는 지정된 시간 동안 지정된 위치를 중심으로 카메라를 회전시켜 해당 시간 동안 지정된 횟수만큼 회전합니다. 기본적으로 카메라가 시계 방향으로 회전합니다. 라운드에 음수가 지정되면 카메라가 시계 반대 방향으로 회전합니다. 지도가 최소한의 양을 로드한 후에만 애니메이션을 시작할 수 있으므로 이 메서드는 비동기입니다. 애니메이션이 시작되면 메서드가 반환됩니다. 라운드 수가 0이면 회전이 발생하지 않으며 애니메이션이 시작된 직후 완료됩니다.
`flyCameraTo`	`flyCameraTo(options)` 매개변수: `options`: `FlyToAnimationOptions` 반환 값: None 이 메서드는 지정된 시간 동안 현재 위치에서 지정된 종료 위치로 카메라를 포물선으로 이동합니다. 지도가 최소한의 양을 로드한 후에만 애니메이션을 시작할 수 있으므로 이 메서드는 비동기입니다. 애니메이션이 시작되면 메서드가 반환됩니다.
`removeEventListener`	알림: v=beta 채널에서만 사용할 수 있습니다. `removeEventListener(type, listener[, options])` 매개변수: `type`: `string` 이벤트 리스너를 삭제할 이벤트 유형을 지정하는 문자열입니다. `listener`: `EventListener\|EventListenerObject` 이벤트 타겟에서 삭제할 이벤트 핸들러의 이벤트 리스너입니다. `options`: `boolean\|EventListenerOptions optional` 옵션을 참고하세요. 반환 값: `void` 이전에 addEventListener로 등록된 이벤트 리스너를 타겟에서 삭제합니다. removeEventListener을 참고하세요.
`stopCameraAnimation`	`stopCameraAnimation()` 매개변수: 없음 반환 값: None 이 메서드는 실행 중인 플라이 애니메이션을 중지합니다. 카메라가 애니메이션 중간에 있는 위치에 그대로 유지되며 끝점으로 순간 이동하지 않습니다. 지도가 최소한의 양을 로드한 후에만 애니메이션을 시작하거나 중지할 수 있으므로 이 메서드는 비동기입니다. 애니메이션이 중지되면 메서드가 반환됩니다.

이벤트
`gmp-animationend`	`function(animationEndEvent)` 인수: `animationEndEvent`: `Event` 이 이벤트는 플라이 애니메이션이 종료될 때 발생합니다. 이 이벤트는 DOM 트리를 통해 버블링됩니다.
`gmp-centerchange`	`function(centerChangeEvent)` 인수: `centerChangeEvent`: `Event` 이 이벤트는 Map3DElement의 center 속성이 변경될 때 발생합니다.
`gmp-click`	`function(clickEvent)` 인수: `clickEvent`: `LocationClickEvent\|PlaceClickEvent` 이 이벤트는 `Map3DElement` 요소를 클릭하면 발생합니다.
`gmp-headingchange`	`function(headingChangeEvent)` 인수: `headingChangeEvent`: `Event` 이 이벤트는 Map3DElement의 방향 속성이 변경될 때 발생합니다.
`gmp-rangechange`	`function(rangeChangeEvent)` 인수: `rangeChangeEvent`: `Event` 이 이벤트는 Map3DElement의 범위 속성이 변경될 때 발생합니다.
`gmp-rollchange`	`function(rollChangeEvent)` 인수: `rollChangeEvent`: `Event` 이 이벤트는 Map3DElement의 roll 속성이 변경될 때 발생합니다.
`gmp-steadychange`	`function(steadyChangeEvent)` 인수: `steadyChangeEvent`: `SteadyChangeEvent` 이 이벤트는 `Map3DElement`의 정상 상태가 변경될 때 발생합니다.
`gmp-tiltchange`	`function(tiltChangeEvent)` 인수: `tiltChangeEvent`: `Event` 이 이벤트는 Map3DElement의 기울기 속성이 변경될 때 발생합니다.

Map3DElementOptions 인터페이스

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

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

속성
`bounds optional`	유형: `LatLngBounds\|LatLngBoundsLiteral optional` `Map3DElement.bounds`를 참조하세요.
`center optional`	유형: `LatLngAltitude\|LatLngAltitudeLiteral optional` `Map3DElement.center`를 참조하세요.
`defaultLabelsDisabled optional`	유형: `boolean optional` `Map3DElement.defaultLabelsDisabled`를 참조하세요.
`defaultUIDisabled optional`	유형: `boolean optional` `Map3DElement.defaultUIDisabled`를 참조하세요.
`heading optional`	유형: `number optional` `Map3DElement.heading`를 참조하세요.
`maxAltitude optional`	유형: `number optional` `Map3DElement.maxAltitude`를 참조하세요.
`maxHeading optional`	유형: `number optional` `Map3DElement.maxHeading`를 참조하세요.
`maxTilt optional`	유형: `number optional` `Map3DElement.maxTilt`를 참조하세요.
`minAltitude optional`	유형: `number optional` `Map3DElement.minAltitude`를 참조하세요.
`minHeading optional`	유형: `number optional` `Map3DElement.minHeading`를 참조하세요.
`minTilt optional`	유형: `number optional` `Map3DElement.minTilt`를 참조하세요.
`range optional`	유형: `number optional` `Map3DElement.range`를 참조하세요.
`roll optional`	유형: `number optional` `Map3DElement.roll`를 참조하세요.
`tilt optional`	유형: `number optional` `Map3DElement.tilt`를 참조하세요.

FlyAroundAnimationOptions 인터페이스

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

FlyCameraAround 애니메이션의 맞춤설정 옵션입니다.

속성
`camera`	유형: `CameraOptions` 궤도 애니메이션 중에 카메라가 바라봐야 하는 중심점입니다. 카메라가 이 중심점을 중심으로 회전하면 지도 방향이 변경됩니다.
`durationMillis optional`	유형: `number optional` 애니메이션의 지속 시간(밀리초)입니다. 단일 회전의 지속 시간이 아닌 애니메이션의 총 지속 시간입니다.
`rounds optional`	유형: `number optional` 지정된 시간 동안 중심을 회전할 라운드 수입니다. 이 설정은 전체 회전 속도를 제어합니다. 음수를 rounds에 전달하면 카메라가 기본 시계 방향 대신 시계 반대 방향으로 회전합니다.

FlyToAnimationOptions 인터페이스

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

FlyCameraTo 애니메이션의 맞춤설정 옵션입니다.

속성
`endCamera`	유형: `CameraOptions` 애니메이션이 끝날 때 카메라가 향해야 하는 위치입니다.