Routes API の概要

Routes API は、HTTPS リクエストを受け取り、 は、2 地点間の理想ルート、または距離と移動距離を返します。 時間間隔を求めることができます。

注: Directions API または Directions API から Distance Matrix API: Routes API に移行する理由

Routes API を使用する理由

Routes API を使用すると、交通機関の詳細、最新の交通状況と道路状況、ルート設定を使用して、正確なルートやルート情報を取得できます。

• さまざまな交通機関の種類と機能

• 車両が向かっている方角

• 乗車または降車する道路の側

• 交通状況と通行止め

• 危険な地域を避ける、安全な集荷場所を指定するなど、安全に関する懸念事項

• 通行料やルートのメタデータ（時間、距離、燃費など）などのオプション機能を使用して、ルーティングのニーズに応じてレイテンシ、品質、費用のバランスを取る

配車のスケジュールとして最も効率的なルート（ 例:

• 一連のパッケージを受け取るワーカーを割り当てる最善の方法

• 最終目的地に荷物を配送するのに最適な倉庫を特定する

Routes API でできること

Routes API では、主に 2 つのルーティング カテゴリを利用できます。 含まれます

• ロケーションから 1 つまたは複数の宛先へのルート

• 多数の出発地と目的地を結ぶ可能なルートのマトリックス。

1 つまたは複数の宛先のルートを取得する

Routes API の Compute Routes メソッドを使用すると、地点間の次のことを計算できます。

• さまざまな移動手段の経路を検索する: 単一または複数の経路について destination:

  • 交通手段（交通機関、車、二輪車、 徒歩や自転車に乗ります

  • 一連のウェイポイント。最も効率的な順序で移動するように最適化できます。

• 出発地、目的地、地点を指定する複数の方法:

  • テキスト文字列。例: 「シカゴ、イリノイ州」、「ダーウィン、NT、オーストラリア」 「1800 Amphitheatre Parkway, Mountain View, CA 94043」または「CWF6+FWX Mountain」 カリフォルニア州のビュー」

  • プレイス ID

  • 緯度と経度の座標（車両の向きを任意で指定可能）

• ニーズと目標に基づいてルート オプションを微調整します。

  • お使いの車両のエンジンの種類に応じて、燃料効率が良いルートまたはエネルギー効率の高いルートを選択してください。 ディーゼル、電気、ハイブリッド、ガス。詳細については、次をご覧ください: 環境に優しいルートを検索する。

  • トラフィック計算のきめ細かいオプションを設定して、 レイテンシのトレードオフを決定します。詳細については、トラフィック データを含める方法と含めるかどうかを指定しますをご覧ください。

  • 車両の向き（進行方向）と道路脇の情報を設定: 到着予定時刻の精度を高めます詳しくは、車両の進行方向と道路の側面を指定するをご覧ください。

  • パススルーとターミナルの場所、および安全な経由地を指定します。詳しくは、ルート上の停留所を設定するとルートの通過ポイントを設定するをご覧ください。

  • 通行料金の情報や、ルートの距離、到着予定時刻をリクエストすることができます。詳しくは ルートの通行料金を計算するをご覧ください。

• レイテンシと品質を管理するために、 フィールド マスクを使用すると、不要な処理時間や 課金レートを指定できます詳しくは、返す情報を選択するをご覧ください。

可能なルートのマトリックスを取得する

Routes API の Compute Route Matrix メソッドを使用すると、 複数の出発地から目的地までの推奨ルートの情報のマトリックス 距離や到着予定時刻などの情報がまとめられています。 目的地と目的地の候補が リストされます 対応できます。リクエストできる距離データの種類は次のとおりです。

• 選択した移動手段の距離

• 距離（キロメートルまたはマイル）

• 推定移動時間

距離データを使えば、最も効率的なルートと 乗客、荷物、労働者を、複数の配達先 構成できます

行列全体が計算される前にレスポンスの要素をストリーミングすることで、レスポンスのレイテンシを短縮できます。

サーバーサイド リクエストごとに複数の送信元と宛先を指定できます。 出発地の数 × 目的地の数（最大 625 個）。

Routes API の仕組み

Routes API には、ComputeRoutes と 2 つのメソッドがあります。 ComputeRouteMatrix。

ComputeRoutes

Routes API の ComputeRoutes メソッドは、リクエストの詳細を含む JSON リクエスト本文を含む HTTP POST リクエストを受け入れます。必須項目は、出発地、目的地、旅行モード、返すフィールドを指定するフィールド マスクです。

例

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

その後、サービスはリクエストされたルートを計算し、 渡されます。

ComputeRouteMatrix

Routes API ComputeRouteMatrix は、リクエストの詳細を含む JSON リクエスト本文を含む HTTP POST リクエストを受け入れます。少なくとも 1 つの出発地、2 つ以上の目的地、travelMode、返すフィールドを指定するフィールド マスクが必要です。

例

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

レスポンスには、すべての送信元の組み合わせで可能なルートが含まれます。 示されています

リソース

次の表に、Routes API で使用可能なリソースと、返されるデータを示します。

データリソース	返されたデータ	戻り値の形式
ComputeRoutes	ルート、区間、ステップを返します。リクエストに応じて、代替ルートも返します。	JSON
ComputeRouteMatrix	1 つの出発地ウェイポイントから 1 つの目的地ウェイポイントまでのルートの配列を返します。

Routes API の使用方法

1	セットアップする	Google Cloud プロジェクトをセットアップするから始めます。 以下の設定手順を完了します。
2	ルートを計算してレスポンスを確認する	詳細については、ルートを取得するとルート レスポンスを確認するをご覧ください。
3	ルートのマトリックスを計算してレスポンスを確認する	詳細については、ルート マトリックスを取得するをご覧ください。 およびルート マトリックスのレスポンスを確認するをご覧ください。

利用可能なクライアント ライブラリ

Routes API で使用可能なクライアント ライブラリの一覧については、クライアント ライブラリをご覧ください。

次のステップ

• 利用可能なルート オプション
• 返す情報を選択する
• Directions API または Distance Matrix API から移行する
• Routes API のプレビュー版から一般提供への移行