1 つのルートの距離と所要時間を計算できます。
ComputeRouteMatrix メソッドを使用した出発地と目的地
Routes Preferred API を使用していますComputeRouteMatrix がサポート
REST HTTP 呼び出しの両方をサポートしています
出発地と目的地のペアのリストが指定された場合、ComputeRouteMatrix
各出発地点を起点とするルートの距離と所要時間を計算します
各デスティネーションで終わりますストリームの各要素は対応する
単一のルートの情報のみを表示できます
ComputeRouteMatrix メソッドには、
距離行列サービス:
- ストリーミングでは、行列全体の前に要素を返すことができる レイテンシが短縮されました。
ComputeRouteMatrixには、トラフィック計算のきめ細かいオプションが用意されています。 品質とレイテンシのトレードオフを 決定できます- リクエストは Google のインフラストラクチャ内で高優先度で実行されるため、 可用性が向上します
- 方角（進行方向）と道路側を指定できます 表示できるようになります。
- 通行料金の情報と併せて返却するようリクエストできます。 ルート距離と到着予定時刻が表示されます
ComputeRouteMatrix メソッドを有効にする
コードで ComputeRouteMatrix メソッドを使用する前に、次のことを行う必要があります。
有効にする必要があります。Routes Preferred API の有効化の詳細
スタートガイドをご覧ください。
ComputeRouteMatrix メソッドを使用する
ComputeRouteMatrix メソッドは、Routes Preferred を通じて利用できます。
v1 エンドポイント。
詳細については、次のドキュメントをご覧ください。
次の一般的な手順では、gRPC を使用して呼び出しを行う
ComputeRouteMatrix メソッドを使用します。
googleapis リポジトリから必要なプロトコル バッファを確認します。
https://github.com/googleapis/googleapis/tree/master/google/maps/routes
Go などの一部のビルドシステムでは、この処理が自動的に行われる場合があります。
任意の言語とビルドツールのセットを使用して、関連するコードを 格納されます。
リクエストを生成します。2 つの必須メタデータを送信する必要がある 必要があります。
- X-Goog-Api-Key に API キーを設定する必要があります。
X-Goog-Fieldmask には、フィールドのカンマ区切りリストを設定する必要があります。 レスポンスから抽出できます。たとえば X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status ワイルドカード文字（*）を使用してすべてのフィールドを示すことができますが、 推奨されません。ワイルドカード文字を使用して、 必要なフィールドを明示的にフィールド マスクで列挙する 確認できます。
フィールド マスク文字列の作成方法の詳細については、以下をご覧ください。 https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto. 不要なフィールドを無効にすると、レイテンシを短縮できます。 これらのフィールドではさらに計算が必要になる場合があります。レイテンシは変わらない 必要なフィールドと新しいフィールドを 後で追加の計算が行われます。
routespreferred.googleapis.com:443にリクエストを送信します。 通信できます。
ComputeRouteMatrix メソッドの使用例については、以下をご覧ください。
ルート マトリックス（ベータ版）の例の計算
ComputeRouteMatrix メソッドの特徴として、
ストリーム全体または個々のエラーについて
あります。たとえば、リクエストを受信したときに、ストリーム接続でエラーが返されます。
（オリジンがゼロなど）エラーや
ストリームのごく一部の要素だけを抽出できます（たとえば、無効な場所 ID を
の場合）は、エラーの影響を受けた要素にのみエラーコードが含まれます。
ストリームによって返される要素は、必ずしも返されるとは限りません。
順序は問いません。このため、各要素には origin_index が含まれます。
destination_index があります。指定した出発地と目的地
ルートのオリジンは origins[origin_index] と同等です。
ルートのデスティネーションとルートのデスティネーションが
宛先: destinations[destination_index]これらの配列にはゼロのインデックスが付加されます。これは、
出発地と目的地のリストの順序を保存することが重要です。
通行料金の計算
通行料金の計算については、以下をご覧ください。 通行料金の計算
通行料金の計算例については、以下をご覧ください。 ルート マトリックスの計算例