只要在支援的子元素上設定 autofits-camera HTML 屬性或 autofitsCamera 屬性,即可在 <gmp-map-3d> 檢視區中自動框住標記、折線、多邊形和 3D 路線。當一或多個子項元素選擇加入時,地圖會計算攝影機位置,讓所有選擇加入的元素都保持在檢視畫面中。
Maps JavaScript API 的 v=beta 管道提供自動調整攝影機功能。如需載入 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 地圖平台 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 地圖平台 API 金鑰。
攝影機屬性和限制如何相互影響
當至少有一個子項元素選擇加入 autofits-camera 時,Map3DElement 會根據下列規則,將地圖設定與計算出的邊界結合:
center和range:由計算出的取景範圍覆寫,這會增加 20% 的範圍邊框間距,並強制執行 80 公尺的最小範圍。如果沒有任何選擇加入的子元素提供座標,地圖會使用設定的center和range做為備用。tilt和heading:在取景時視為建議值。如果省略,兩者都會預設為0°,呈現由上往下、北方朝上的檢視畫面。roll和fov:依據Map3DElement的設定保留。- 非同步子項元素:
Map3DElement會等待已選擇加入的非同步子項 (例如<gmp-route-3d>) 完成載入路線幾何圖形,然後才算完成初始檢視畫面的算繪。 - 地圖和攝影機限制:地理
bounds和攝影機限制 (minAltitude、maxAltitude、minTilt、maxTilt、minHeading和maxHeading) 仍會限制自動調整大小的檢視畫面。詳情請參閱「限制攝影機檢視畫面和邊界」。