カメラを地図要素に自動的に合わせる

サポートされている子要素に 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)は、自動調整されたビューにも適用されます。詳細については、カメラビューと境界を制限するをご覧ください。

次のステップ