지원되는 하위 요소에 autofits-camera HTML 속성 또는 autofitsCamera 속성을 설정하여 <gmp-map-3d> 표시 영역 내에서 마커, 다중선, 다각형, 3D 경로를 자동으로 프레이밍할 수 있습니다. 하나 이상의 하위 요소가 선택되면 지도에서 선택된 모든 요소를 표시하는 카메라 위치를 계산합니다.
자동 카메라 맞춤은 Maps JavaScript API의 v=beta 채널에서 사용할 수 있습니다. 베타 채널을 로드하는 방법은 버전 관리를 참고하세요.
지원되는 요소
다음 표에는 autofits-camera(autofitsCamera)를 지원하는 Map3DElement의 하위 요소가 나와 있습니다.
| HTML 요소 | JavaScript 클래스 | 라이브러리 | 참고 |
|---|---|---|---|
<gmp-marker-3d>, <gmp-marker-3d-interactive> |
Marker3DElement,
Marker3DInteractiveElement
|
maps3d |
마커의 position을 프레이밍합니다. |
<gmp-marker>, <gmp-marker-interactive> |
MarkerElement,
MarkerInteractiveElement
|
maps3d |
마커의 position을 프레이밍합니다. |
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> |
Polyline3DElement,
Polyline3DInteractiveElement
|
maps3d |
다중선의 path에 있는 모든 좌표를 프레이밍합니다. |
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> |
Polygon3DElement,
Polygon3DInteractiveElement
|
maps3d |
다각형의 path에 있는 모든 좌표를 프레이밍합니다. |
<gmp-route-3d> |
Route3DElement
|
routes |
경로 요청이 해결될 때까지 기다린 후 경로를 프레이밍합니다. |
지원되지 않는 요소
Model3DElement, PopoverElement, FlattenerElement은 autofitsCamera를 지원하지 않습니다. 이러한 요소를 프레이밍하려면 <gmp-map-3d>에서 center 및 range를 설정하거나 flyCameraTo를 호출합니다.
초기 로드 시 카메라 맞추기
지도가 로드될 때 요소를 프레이밍하려면 초기 표시 영역 내에 원하는 각 하위 요소에 autofits-camera 속성을 추가합니다. <gmp-map-3d>에서 center 또는 range를 계산할 필요가 없습니다.
<gmp-map-3d
style="height: 400px; width: 100%;"
mode="hybrid">
<gmp-marker-3d
position="47.6205,-122.3493"
title="Space Needle"
autofits-camera>
</gmp-marker-3d>
<gmp-marker-3d
position="47.6097,-122.3425"
title="Pike Place Market"
autofits-camera>
</gmp-marker-3d>
<gmp-polyline-3d
path="47.6205,-122.3493,0 47.6097,-122.3425,0"
stroke-color="#4285F4"
stroke-width="8"
altitude-mode="clamp-to-ground"
autofits-camera>
</gmp-polyline-3d>
</gmp-map-3d>
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>
YOUR_API_KEY를 Google Maps Platform API 키로 바꿉니다.
동적 업데이트 맞춤 및 애니메이션 처리
초기 로드 후 선택한 요소를 추가하거나, 좌표 또는 경로 엔드포인트를 업데이트하거나, autofitsCamera를 true로 설정하면 지도가 카메라를 다시 계산하여 선택한 모든 요소를 프레이밍합니다. 요소를 삭제하거나 autofitsCamera를 false로 설정하면 카메라가 해당 위치에 유지되고 향후 업데이트에서 해당 요소가 제외됩니다.
동적 업데이트가 스냅되는지 또는 애니메이션되는지 제어하려면 Map3DElement에서 autofitsCameraAnimation(autofits-camera-animation)를 AutofitsCameraAnimation 값으로 설정합니다.
AutofitsCameraAnimation.NONE("none", 기본값): 애니메이션 없이 업데이트된 위치로 이동합니다.AutofitsCameraAnimation.FLY_TO("fly-to"): 업데이트된 위치로 부드럽게 이동합니다. 초기 지도 로드는 애니메이션 없이 스냅되며, 사용자의 운영체제에서 모션 감소를 요청하면FLY_TO가 스냅으로 대체됩니다.
autofitsCamera 및 AutofitsCameraAnimation.FLY_TO를 프로그래매틱 방식으로 구성하려면 다음 예를 참고하세요.
<div id="map-container" style="height: 400px; width: 100%;"></div>
<script>
async function initMap() {
const {
AutofitsCameraAnimation,
Map3DElement,
Marker3DElement,
MapMode,
} = await google.maps.importLibrary('maps3d');
const map = new Map3DElement({
mode: MapMode.HYBRID,
autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
});
document.getElementById('map-container').append(map);
const originMarker = new Marker3DElement({
position: { lat: 37.7955, lng: -122.3937 },
autofitsCamera: true,
});
map.append(originMarker);
/* Adding a second opted-in marker flies the camera to frame both. */
const destinationMarker = new Marker3DElement({
position: { lat: 37.8080, lng: -122.4177 },
autofitsCamera: true,
});
map.append(destinationMarker);
}
</script>
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>
YOUR_API_KEY를 Google Maps Platform API 키로 바꿉니다.
카메라 속성과 제한사항의 상호작용 방식
하나 이상의 하위 요소가 autofits-camera로 선택하면 Map3DElement는 다음 규칙에 따라 지도 구성을 계산된 경계와 결합합니다.
center및range: 계산된 프레이밍으로 재정의됩니다. 이 프레이밍은 20% 범위 패딩을 추가하고 80m 최소 범위를 적용합니다. 선택한 하위 요소가 좌표를 제공하지 않으면 지도는 구성된center및range를 대체로 사용합니다.tilt및heading: 프레이밍 중에 추천 값으로 처리됩니다. 생략하면 둘 다 기본적으로0°로 설정되어 하향식, 정북 뷰가 됩니다.roll및fov:Map3DElement에 구성된 대로 보존됩니다.- 비동기 하위 요소: 초기 뷰를 렌더링하기 전에
Map3DElement는<gmp-route-3d>와 같은 선택된 비동기 하위 요소가 경로 도형 로드를 완료할 때까지 기다립니다. - 지도 및 카메라 제한사항: 지리적
bounds및 카메라 제한(minAltitude,maxAltitude,minTilt,maxTilt,minHeading,maxHeading)은 여전히 자동 맞춤 뷰를 제한합니다. 자세한 내용은 카메라 뷰 및 경계 제한을 참고하세요.