ルート マトリックスを計算する

このプロダクトまたは機能は、pre-GA（一般提供前）のプレビュー版です。pre-GA のプロダクトや機能では、サポートが限定されることがあります。また、pre-GA のプロダクトや機能を変更すると、他の pre-GA バージョンに対応しなくなる場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳しくは、リリース ステージの説明をご覧ください。

1 つのルートの距離と所要時間を計算できます。 ComputeRouteMatrix メソッドを使用した出発地と目的地 Routes Preferred API を使用していますComputeRouteMatrix がサポート REST HTTP 呼び出しの両方をサポートしています

出発地と目的地のペアのリストが指定された場合、ComputeRouteMatrix 各出発地点を起点とするルートの距離と所要時間を計算します 各デスティネーションで終わりますストリームの各要素は対応する 単一のルートの情報のみを表示できます

ComputeRouteMatrix メソッドには、 距離行列サービス:

• ストリーミングでは、行列全体の前に要素を返すことができる レイテンシが短縮されました。
• ComputeRouteMatrix には、トラフィック計算のきめ細かいオプションが用意されています。 品質とレイテンシのトレードオフを 決定できます
• リクエストは Google のインフラストラクチャ内で高優先度で実行されるため、 可用性が向上します
• 方角（進行方向）と道路側を指定できます 表示できるようになります。
• 通行料金の情報と併せて返却するようリクエストできます。 ルート距離と到着予定時刻が表示されます

ComputeRouteMatrix メソッドを有効にする

コードで ComputeRouteMatrix メソッドを使用する前に、次のことを行う必要があります。 有効にする必要があります。Routes Preferred API の有効化の詳細 スタートガイドをご覧ください。

重要: Routes Preferred API の割り当て上限を確認してください。 あります。割り当て上限を増やす必要がある場合は、 Google Maps Platform のサポートページ Google Cloud コンソールで、または Google Cloud サポート ホットライン

ComputeRouteMatrix メソッドを使用する

ComputeRouteMatrix メソッドは、Routes Preferred を通じて利用できます。 v1 エンドポイント。

詳細については、次のドキュメントをご覧ください。

gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

次の一般的な手順では、gRPC を使用して呼び出しを行う ComputeRouteMatrix メソッドを使用します。

1. googleapis リポジトリから必要なプロトコル バッファを確認します。

   https://github.com/googleapis/googleapis/tree/master/google/maps/routes

   Go などの一部のビルドシステムでは、この処理が自動的に行われる場合があります。

2. 任意の言語とビルドツールのセットを使用して、関連するコードを 格納されます。

3. リクエストを生成します。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. 不要なフィールドを無効にすると、レイテンシを短縮できます。 これらのフィールドではさらに計算が必要になる場合があります。レイテンシは変わらない 必要なフィールドと新しいフィールドを 後で追加の計算が行われます。

4. routespreferred.googleapis.com:443 にリクエストを送信します。 通信できます。

ComputeRouteMatrix メソッドの使用例については、以下をご覧ください。 ルート マトリックス（ベータ版）の例の計算

ComputeRouteMatrix メソッドの特徴として、 ストリーム全体または個々のエラーについて あります。たとえば、リクエストを受信したときに、ストリーム接続でエラーが返されます。 （オリジンがゼロなど）エラーや ストリームのごく一部の要素だけを抽出できます（たとえば、無効な場所 ID を の場合）は、エラーの影響を受けた要素にのみエラーコードが含まれます。

ストリームによって返される要素は、必ずしも返されるとは限りません。 順序は問いません。このため、各要素には origin_index が含まれます。 destination_index があります。指定した出発地と目的地 ルートのオリジンは origins[origin_index] と同等です。 ルートのデスティネーションとルートのデスティネーションが 宛先: destinations[destination_index]これらの配列にはゼロのインデックスが付加されます。これは、 出発地と目的地のリストの順序を保存することが重要です。

通行料金の計算

通行料金の計算については、以下をご覧ください。 通行料金の計算

通行料金の計算例については、以下をご覧ください。 ルート マトリックスの計算例