<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を固定します。