Routes API は、2 つのメソッドを備えたウェブサービスです。Compute Routes は、2 つの場所間のルートを返します(オプションで中間地点を指定可能)。Compute Route Matrix は、出発地と目的地の組み合わせ(最大 625 個のルート マトリックス要素)の移動距離と時間を返します。
Routes API: 主な特長
- プロダクト: Routes API
- 別名: Routes API v2、Compute Routes、Compute ルート マトリックス
- カテゴリ: ルート
- プラットフォーム: ウェブサービス(REST)
- 実行場所: サーバー(バックエンド コード)
- リリース ステージ: GA
- ライフサイクル: アクティブ
- 概要: Routes API の概要
- 対象地域: グローバル。二輪車ルート、環境に優しいルート選択、通行料金の計算は、サポートされている国と都市に限定されます。独自の CLDR コードを持つ従属地域は、リストに記載されていない限りサポートされません。欧州経済領域(EEA)の請求先住所の場合、https://developers.google.com/maps/comms/eea/routes の EEA 規約により、ルートの説明やステップを地図で使用することは禁止されています。(カバレッジの詳細)
Routes API: 使用するタイミング
Routes API を使用する場合:
- 出発地と目的地の間のルート(オプションで中間ウェイポイントを含む)が必要な場合。移動手段は、車、徒歩、自転車、二輪車、公共交通機関です。
- 1 つのリクエストで、多数の出発地と目的地のペア(最大 625 要素)の移動距離と移動時間が必要な場合。
- 通行料金の見積もり(一部の都市)、環境に優しいルート(一部の地域)、交通状況を考慮したポリライン、大型車両のルート設定(利用制限あり)が必要な場合。
- 以前の Directions API または Distance Matrix API からサーバーアプリを移行する場合。
Routes API を使用すべきでない場合:
- 車両群全体の積載割り当てと配送順序を最適化する必要があります。代わりに Route Optimization API を使用してください。
- Android で、計算されたルートに沿ってアプリ内でターンバイターン方式のナビを行う必要があります。代わりに Navigation SDK for Android を使用してください。
- iOS で、計算されたルートに沿ったアプリ内ターンバイターン方式のナビゲーションが必要。代わりに Navigation SDK for iOS を使用してください。
Routes API: 設定
- 有効にするサービス:
routes.googleapis.com - 認証: API キー、OAuth 2.0、サービス アカウント
- 使ってみる: Routes API を設定する
- リファレンス: Routes API リファレンス
- 料金: Routes API の使用量と請求額
- ポリシー: Routes API のポリシー
- リリースノート: Routes API リリースノート
公式の Routes API パッケージ:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - Maven:
com.google.maps:google-maps-routing
Routes API: 関連商品
- 置き換え対象: Directions API、Distance Matrix API
- よく併用される API: Navigation SDK for Android、Navigation SDK for iOS、Route Optimization API、Geocoding API、Places API(新版)
Routes API: よくある間違い
- 問題: 返されるフィールドのデフォルト リストがありません。フィールド マスク(
X-Goog-FieldMaskヘッダーまたは$fieldsパラメータ)のないリクエストはエラーを返します。修正方法: 必要なレスポンス フィールドをリストしたフィールド マスクを常に送信します。/maps/documentation/routes/choose_fields をご覧ください。 - 問題: 本番環境でワイルドカード フィールド マスク(
*)を使用すると、費用とレイテンシが増加します。また、新しい上級者向け機能がレスポンスに追加されると、費用が予期せず増加する可能性があります。修正方法:*は開発時にのみ使用し、本番環境では必要なフィールドのみをリクエストします。/maps/documentation/routes/choose_fields をご覧ください。 - 問題: フィールド マスクに追加するだけでは、通行料金情報と燃料消費量が返されません。GA 以降、これらは明示的に有効にする必要があります。修正: フィールド マスクに加えて、
extraComputations配列(TOLLS、FUEL_CONSUMPTIONなど)をリクエストに追加します。/maps/documentation/routes/migrate-routes-preview をご覧ください。 - 問題: Compute Route Matrix では 625 個の要素を使用できますが、
routingPreferenceがTRAFFIC_AWARE_OPTIMALの場合は 100 個の要素しか使用できません。修正:TRAFFIC_AWARE_OPTIMALを使用する場合は、出発地 x 目的地を 100 以下に保つか、リクエストを分割します。/maps/documentation/routes/compute_route_matrix をご覧ください。
Routes API でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
- 2 つ以上の緯度と経度の座標間のルートを、ルート上の各ステップの一連の座標として返します。
- 2 つ以上の緯度と経度の座標セット間のルートを、ルート沿いのステップの操作説明として返します。
- 2 つ以上の緯度と経度の座標セット間のルートに沿って、各ステップ間の距離を返します。
- 2 つ以上の緯度と経度の座標セット間のルートに沿って、各ステップ間の移動時間を返します。
- 2 つ以上の緯度と経度の座標セット間のルートに沿って、各ステップ間のエンコードされたポリラインを返します。
- 2 つ以上の緯度と経度の座標セット間のルートの距離を返します。
- 2 つ以上の緯度と経度の座標セット間のルートの移動時間を返します。
- 2 つ以上の緯度と経度の座標セット間のルートのエンコードされたポリラインを返します。
- 2 つ以上の緯度と経度の座標セット間のルートの通行料金情報を返します。
- ルート リクエストの移動手段(車、公共交通機関、徒歩、バイク)を指定します。注: Routes API ウェブサービス(computeRoutes)では、RouteTravelMode(DRIVE、BICYCLE、TWO_WHEELER、WALK、TRANSIT、または routeModifiers.vehicleInfo を指定した TRUCK)を使用して、HTTP POST JSON 本文で travelMode を渡します。また、以前の GET モードのクエリ パラメータではなく、必須の X-Goog-FieldMask ヘッダーを含めます。Maps JavaScript API の Routes ライブラリでは、ComputeRoutesRequest で travelMode と fields を渡します。
- ルート リクエストの停車地点または通過地点を指定する。
- ルート リクエストで交通データを使用する方法を指定します。
- ルート リクエストで、高速道路や有料道路など、回避する対象を指定します。
- ルートに沿ってウェイポイントを設定する。
- ルート沿いの中間地点を設定する。
- ルートが通過するポイントを設定する。
- ルートの車両の進行方向と道路の通行側を指定する。
- ルート上の経由地の順序を最適化する。
- ルート リクエストに環境に優しいルート選択を指定する。プレビュー
- ルート リクエストで、より短い距離または代替ルートを指定します。注: Routes API では、より短い距離の参照ルート(SHORTER_DISTANCE)のリクエストは試験運用版ですが、代替ルートのリクエスト(computeAlternativeRoutes)は一般提供されています。
- 複数の出発地と目的地間のルート マトリックスの距離を返します。
- 複数の出発地と目的地間のルート マトリックスの移動時間を返します。
- 複数の出発地と目的地間のルート マトリックスの通行料金情報を返します。
- ルート マトリックス リクエストの移動手段(車、公共交通機関、徒歩、二輪車)を指定します。注: Routes API ウェブサービス(computeRouteMatrix)では、RouteTravelMode(DRIVE、TWO_WHEELER、WALK、TRANSIT、または origins[].routeModifiers.vehicleInfo を指定した TRUCK。ルート マトリックスでは BICYCLE はサポートされていません)を使用して、HTTP POST JSON 本文で travelMode を渡し、必要な X-Goog-FieldMask ヘッダーを含めます。Maps JavaScript API の Routes ライブラリでは、ComputeRouteMatrixRequest で travelMode と fields を渡します。