Compute Routes の概要

欧州経済領域（EEA）のデベロッパー

はじめに

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

    • 緯度と経度の座標（オプションで車両の進行方向も指定可能）

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

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

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 メソッドで使用できるリソースと、返されるデータの概要を示します。

データリソース 返されたデータ 戻り値の形式
ComputeRoutes リクエストに応じて、ルート、区間、ルートのステップ、代替ルートを返します。 JSON

Compute Routes の使用方法

1 セットアップする Google Cloud プロジェクトを設定するから始めて、以降の設定手順を完了します。
2 Routes API の課金方法について 詳細については、使用量と課金をご覧ください。
3 ルートを計算してレスポンスを確認する 詳細については、ルートを取得するとルート レスポンスを確認するをご覧ください。

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

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

次のステップ