Maps JavaScript API の Routes ライブラリには、Route クラスと RouteMatrix クラスが含まれています。これらは、以前の DirectionsService オブジェクトと DistanceMatrixService オブジェクトに代わるものです。google.maps.importLibrary("routes") を使用して、ウェブ アプリケーションにライブラリを読み込みます(ブラウザ アプリケーションが https://routes.googleapis.com ウェブサービスを直接呼び出すのではなく、このライブラリを使用する必要がある理由については、クライアントサイド SDK を使用するをご覧ください)。
Route クラス
Route クラスには、2 つの場所間の最適なルートを返す computeRoutes() メソッドが用意されています。複数の地点間の移動について、交通機関や自転車、車、原動機付自転車、徒歩でのルートをリアルタイムの交通情報とともに示します。
RouteMatrix クラス
RouteMatrix クラスは、複数の出発地と目的地間のルートの距離と移動時間を返します。複数の目的地について、最大 625 個のルート要素を踏まえて移動時間と距離を算出します。
3D ルート
routes ライブラリには、<gmp-map-3d> 要素にルートをレンダリングするための Route3DElement ウェブ コンポーネントと、Route クラスの 3D ヘルパー メソッド(create3DPolylines、createWaypointMarkers、createPopover)が用意されています。詳細については、3D 地図にルートを表示するをご覧ください。
ユースケースに適したクラスを選択する
- 複数の経由地を含むルート計画:
Route.computeRoutes()を使用します。中間地点、経由地の最適化、代替ルート、通行料金の見積もりをサポートしています。2D 地図にルートを描画するには、createPolylines()とcreateWaypointAdvancedMarkers()を呼び出します。3D 地図にルートをレンダリングするには、Route3DElement(<gmp-route-3d>)ウェブ コンポーネントを使用するか、create3DPolylines()、createPopover()、createWaypointMarkers()を呼び出します。 - 配車と最寄りの場所のマッチング:
RouteMatrix.computeRouteMatrix()を使用して、複数の出発地と目的地(最大 625 個のルート要素)の移動時間と距離を比較します。たとえば、集荷場所に最も近いドライバーを割り当てたり、配送に最も近い倉庫を選択したりします。