3D 地図上にルートを表示する

欧州経済領域(EEA)のデベロッパー

<gmp-map-3d> 要素でルートを計算してレンダリングするには、次の 2 つの方法があります。

  • Route3DElement(<gmp-route-3d>)を使用して宣言的に行う: Routes API からルートをリクエストし、3D ルート ポリライン、出発地と目的地のマーカー、ルート概要のポップオーバーをレンダリングするウェブ コンポーネントを追加します。
  • Route ヘルパー メソッドを使用してプログラムで作成する: Route.computeRoutes を呼び出し、中間ウェイポイント、カスタム フィールド マスク、カスタム ポリライン スタイルが必要な場合は、ルートを create3DPolylines、createWaypointMarkers、createPopover に渡します。

どちらの方法も、Maps JavaScript API の v=beta チャンネルで使用できます。Beta チャンネルを読み込む手順については、バージョニングをご覧ください。

前提条件と課金

3D ルートを表示する前に、Google Cloud プロジェクトを設定し、そのプロジェクトで Maps JavaScript API と Routes API の両方を有効にします。maps3d ライブラリと routes ライブラリの両方を読み込みます。

<gmp-map-3d> のレンダリングは、Dynamic 3D Maps(Immersive Maps Pro)で課金されます。<gmp-route-3d> または Route.computeRoutes によって行われた各ルート リクエストは、リクエストされた機能に基づいて、Routes API の Compute Routes SKU で課金されます。

構成 Routes SKU ティア
デフォルトのルート リクエスト(TRAFFIC_UNAWARE、または WALKING、BICYCLING、TRANSIT の移動手段で、交通状況のポリラインなし) Compute Routes Essentials
routing-preference が traffic-aware または traffic-aware-optimal に設定され、traffic-polylines-disabled が有効になっている Compute Routes Pro
routing-preference が traffic-aware または traffic-aware-optimal に設定され、交通状況に応じた色のポリラインが有効になっている(交通状況を考慮する設定が指定されている場合のデフォルト) Compute Routes Enterprise

SKU の詳細については、Maps JavaScript API の使用量と請求額をご覧ください。

HTML を使用して 3D ルートを追加する

最小限のコードで出発地と目的地の間のルートを表示するには、<gmp-route-3d> を <gmp-map-3d> 内にネストし、autofits-camera を追加して、地図がルートを自動的にフレームに収めるようにします。

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-route-3d
    origin="Space Needle, Seattle, WA"
    destination="Tacoma Dome, Tacoma, WA"
    travel-mode="driving"
    routing-preference="traffic-aware"
    autofits-camera>
  </gmp-route-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d,routes">
</script>

YOUR_API_KEY は、Google Maps Platform API キーに置き換えます。

Route3DElement は、ポリラインと概要ポップオーバーの色を、親 <gmp-map-3d> のライトまたはダークのカラーパターンに自動的に一致させます。また、次の属性とプロパティをサポートしています。

  • origin と destination: "lat,lng" 座標文字列、"places/ChIJ-bfVTh8VkFQRDZLQnmioK9s" などの場所リソース名、または住所文字列を受け入れます。JavaScript では、これらのプロパティは LatLng、LatLngLiteral、LatLngAltitude、LatLngAltitudeLiteral、Place オブジェクトも受け入れます。
  • travel-mode(travelMode): driving(デフォルト)、walking、bicycling、transit(マルチモーダルの徒歩と交通機関の路線セグメントをレンダリング)を指定できます。
  • routing-preference(routingPreference): traffic-unaware、traffic-aware、traffic-aware-optimal のいずれか。
  • traffic-polylines-disabled(trafficPolylinesDisabled): 交通状況を考慮したルートで、交通速度に応じたポリラインの色付けを無効にします。これにより、リクエストは Compute Routes Enterprise ではなく Compute Routes Pro で課金されます。
  • departure-time(departureTime): HTML の ISO 8601 タイムスタンプ文字列("2027-03-15T16:00:00Z" など)または JavaScript の Date オブジェクトを受け入れます。
  • autofits-camera(autofitsCamera): 読み込まれたルートを <gmp-map-3d> ビューポート内に収めます。

ルートイベントを処理し、ルートデータを読み取る

Route3DElement は、ルートのレンダリングが完了すると gmp-load をディスパッチし、ルートの計算が失敗するか、ルートが 0 個返された場合は gmp-error をディスパッチします。gmp-load が起動すると、計算された routes、fallbackInfo、geocodingResults プロパティを読み取ることができます。

const routeElement = document.querySelector('gmp-route-3d');

routeElement.addEventListener('gmp-load', () => {
  const primaryRoute = routeElement.routes?.[0];
  console.log('Distance (m):', primaryRoute?.distanceMeters);
  console.log('Duration:', primaryRoute?.localizedValues?.duration);
});

routeElement.addEventListener('gmp-error', () => {
  console.error('Failed to load the 3D route.');
});

gmp-route-3d の代わりにルート ヘルパー メソッドを使用する場合

<gmp-route-3d> は、デフォルトのマーカーとポリラインのスタイルを使用して、単一の origin と destination の間のメインルートをレンダリングします。中間ウェイポイント、代替ルートの選択、カスタム レスポンス フィールド マスク、カスタムのポリラインとマーカーのスタイルが必要な場合は、3D ヘルパー メソッドで Route.computeRoutes を使用します。

Route クラスを使用して 3D ルートのレンダリングをカスタマイズする

カスタム 3D ルート ワークフローの場合は、Route.computeRoutes を呼び出し、返された Route インスタンスを 3D ヘルパー メソッドを使用して <gmp-map-3d> にレンダリングします。

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const { Map3DElement, MapMode } =
      await google.maps.importLibrary('maps3d');
    const { Route } = await google.maps.importLibrary('routes');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
    });
    document.getElementById('map-container').append(map);

    const { routes } = await Route.computeRoutes({
      origin: '1800 Amphibious Blvd., Mountain View, CA 94045',
      destination: 'San Francisco Ferry Building, San Francisco, CA',
      travelMode: 'DRIVING',
      routingPreference: 'TRAFFIC_AWARE',
      extraComputations: ['TRAFFIC_ON_POLYLINE'],
      fields: ['path', 'speedPaths', 'localizedValues'],
    });

    const route = routes?.[0];
    if (!route) return;

    const [polylines, markers, popover] = await Promise.all([
      route.create3DPolylines({
        polylineOptions: {
          strokeWidth: 10,
          autofitsCamera: true,
        },
      }),
      route.createWaypointMarkers(),
      route.createPopover(),
    ]);

    map.append(...polylines, ...markers, popover);
  }
</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 キーに置き換えます。

呼び出すヘルパー メソッドごとに、ComputeRoutesRequest.fields の必須フィールドを含めます。

  • create3DPolylines: 標準ポリラインの場合は 'path' または 'legs'、travelMode が 'TRANSIT' の場合は 'path' と 'legs'、交通状況の色分けポリラインの場合は 'speedPaths' と extraComputations: ['TRAFFIC_ON_POLYLINE'] をリクエストします。RoutePolyline3DOptions を渡して polylineOptions をカスタマイズするか、trafficPolylinesDisabled を設定します。
  • createWaypointMarkers: fields で 'path' をリクエストします。出発地と目的地のマーカーを作成します(デフォルトでは Marker3DElement。CreateWaypointMarkersOptions で markerClass を指定した場合は MarkerElement、MarkerInteractiveElement、Marker3DInteractiveElement)。このメソッドでは、中間地点は生成されません。
  • createPopover: 'path' と 'localizedValues'(公共交通機関のルートの場合は 'legs' も)をリクエストして、ルートパスの中間に概要 PopoverElement を固定します。

次のステップ