Compute Routes の概要

はじめに

Compute Routes は、HTTPS リクエストを受け取り、2 つの地点間の最適なルートを返す Routes API サービスのメソッドです。複数の地点間の移動について、交通機関や自転車、車、原動機付自転車、徒歩でのルートをリアルタイムの交通情報とともに示します。

ルート マトリックスが必要ですか？ルート マトリックスについては、Compute Route Matrix の概要をご覧ください。

移行しますか？Distance Matrix API（以前のバージョン）から移行する場合は、Routes API に移行する理由から始まる移行手順をご覧ください。

Compute Routes を使用する理由

Compute Routes では、さまざまなルートの詳細を使用して、費用と品質を最適化しながら、好みに応じて車両や荷物をルート設定できます。

Compute Routes でできること

Routes API の Compute Routes メソッドを使用すると、次のことができます。

• さまざまな移動手段のルートや、1 つまたは複数の目的地までのルートを取得します。

  • 移動手段: 公共交通機関、車、二輪車、徒歩、自転車。

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

• 出発地、目的地、経由地を指定する複数の方法を使用する:

  • テキスト文字列。例: 「Chicago, IL」、「Darwin, NT, Australia」、「1800 Amphitheatre Parkway, Mountain View, CA 94043」、「CWF6+FWX Mountain View, California」

  • プレイス ID

  • 緯度と経度の座標（車両の向きを含むことも可能）

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

  • 車両のエンジンの種類（ディーゼル、電気、ハイブリッド、ガソリン）に合わせて、燃料またはエネルギー効率が良いルートを選択できます。詳しくは、環境に優しいルートを取得するをご覧ください。

  • 交通量の計算に関する詳細なオプションを設定して、品質とレイテンシのトレードオフを決定できます。詳しくは、交通データを含める方法と含めるかどうかを指定するをご覧ください。

  • ウェイポイントの車両の向き（進行方向）と道路の通行側の情報を設定して、ETA の精度を高めます。詳しくは、車両の向きと道路の側を指定するをご覧ください。

  • 通過地点と終点、安全な乗り換え地点を指定します。詳しくは、ルートに経由地を設定するとルートの通過地点を設定するをご覧ください。

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

• レイテンシと品質を制御するには、フィールド マスクを使用して必要なデータのみをリクエストします。これにより、不要な処理時間とリクエストの請求率の上昇を回避できます。詳しくは、返す情報の選択をご覧ください。

Compute Routes の仕組み

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

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'

サービスはリクエストされたルートを計算し、リクエストされたフィールドを返します。

リソース

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

Compute Routes の使用方法

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

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

次のステップ

• ルートを取得する
• 利用可能なルート オプション
• 返す情報を選択する
• Directions API（以前のバージョン）から移行する
• Routes API のプレビュー版から一般提供版に移行する