サポートされている子要素に autofits-camera HTML 属性または autofitsCamera プロパティを設定することで、<gmp-map-3d> ビューポート内にマーカー、ポリライン、ポリゴン、3D ルートを自動的にフレーム表示できます。1 つ以上の子要素がオプトインすると、オプトインしたすべての要素がビューに表示されるようにカメラの位置が計算されます。
カメラの自動調整は、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 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 キーに置き換えます。
カメラのプロパティと制限の相互作用
少なくとも 1 つの子要素が autofits-camera でオプトインすると、Map3DElement は次のルールに従って、地図の構成と計算された境界を組み合わせます。
centerとrange: 計算されたフレーミングによってオーバーライドされます。これにより、20% の範囲パディングが追加され、80 m の最小範囲が適用されます。オプトインされた子要素が座標を提供しない場合、地図は構成済みのcenterとrangeをフォールバックとして使用します。tiltとheading: フレーミング中に候補値として扱われます。省略すると、どちらもデフォルトの0°になり、真上から見た北向きのビューになります。rollとfov:Map3DElementで構成されたとおりに保持されます。- 非同期の子要素:
Map3DElementは、初期ビューをレンダリングする前に、<gmp-route-3d>などのオプトインされた非同期の子要素がルート ジオメトリの読み込みを完了するのを待ちます。 - 地図とカメラの制限: 地理的制限(
bounds)とカメラの制限(minAltitude、maxAltitude、minTilt、maxTilt、minHeading、maxHeading)は、自動調整されたビューにも適用されます。詳細については、カメラビューと境界を制限するをご覧ください。