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
メソッドは、次を含む HTTP POST リクエストを受け入れます。
リクエストの詳細を含む JSON リクエスト本文。必須であるのは origin、
destination、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'
その後、サービスはリクエストされたルートを計算し、 渡されます。
ComputeRouteMatrix
Routes API の ComputeRouteMatrix
は、次を含む HTTP POST リクエストを受け入れます。
リクエストの詳細を含む JSON リクエスト本文。少なくとも 1 つ入力してください
origin、2 つ以上の destination、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 で使用可能なクライアント ライブラリのリストについては、以下をご覧ください。 クライアント ライブラリ。