Package google.maps.routing.v2

索引

• Routes（インターフェース）
• ComputeRouteMatrixRequest（メッセージ）
• ComputeRouteMatrixRequest.ExtraComputation（列挙型）
• ComputeRoutesRequest（メッセージ）
• ComputeRoutesRequest.ExtraComputation（列挙型）
• ComputeRoutesRequest.ReferenceRoute（列挙型）
• ComputeRoutesResponse（メッセージ）
• FallbackInfo（メッセージ）
• FallbackReason（列挙型）
• FallbackRoutingMode（列挙型）
• GeocodedWaypoint（メッセージ）
• GeocodingResults（メッセージ）
• Location（メッセージ）
• Maneuver（列挙型）
• NavigationInstruction（メッセージ）
• Polyline（メッセージ）
• PolylineEncoding（列挙型）
• PolylineQuality（列挙型）
• Route（メッセージ）
• RouteLabel（列挙型）
• RouteLeg（メッセージ）
• RouteLegStep（メッセージ）
• RouteLegStepTravelAdvisory（メッセージ）
• RouteLegTravelAdvisory（メッセージ）
• RouteMatrixDestination（メッセージ）
• RouteMatrixElement（メッセージ）
• RouteMatrixElementCondition（列挙型）
• RouteMatrixOrigin（メッセージ）
• RouteModifiers（メッセージ）
• RouteTravelAdvisory（メッセージ）
• RouteTravelMode（列挙型）
• RoutingPreference（列挙型）
• SpeedReadingInterval（メッセージ）
• SpeedReadingInterval.Speed（列挙型）
• TollInfo（メッセージ）
• TollPass（列挙型）
• Units（列挙型）
• VehicleEmissionType（列挙型）
• VehicleInfo（メッセージ）
• Waypoint（メッセージ）

ルート

Routes API。

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement) 出発地と目的地のリストを受け取り、出発地と目的地の組み合わせごとのルート情報を含むストリームを返します。 注: このメソッドでは、入力にレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクを指定するには、URL パラメータ $fields または fields を使用するか、HTTP/gRPC ヘッダー X-Goog-FieldMask を使用します（使用可能な URL パラメータとヘッダーをご覧ください）。値はカンマ区切りのフィールド フィールドのリストです。詳しくは、フィールドパスの作成方法をご覧ください。 たとえば、次のメソッドを使用します。 使用可能なすべてのフィールドのフィールド マスク（手動検査用）: X-Goog-FieldMask: * ルート期間、距離、要素のステータス、状態、要素インデックスのフィールド マスク（本番環境設定の例）: X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration フィールド マスクに status を含めることが重要です。そうしないと、すべてのメッセージが問題ないように見えます。ワイルドカード（*）レスポンス フィールド マスクの使用はおすすめしません。理由は次のとおりです。 必要なフィールドのみを選択して計算サイクルを短縮することで、より短いレイテンシで結果を返すことができます。 本番環境ジョブに必要なフィールドのみを選択すると、安定したレイテンシのパフォーマンスが確保されます。今後、レスポンス フィールドがさらに追加される可能性があります。また、これらの新しいフィールドでは、追加の計算時間が必要になることがあります。すべてのフィールドを選択するか、トップレベルですべてのフィールドを選択すると、追加された新しいフィールドが自動的にレスポンスに含まれるため、パフォーマンスの低下が発生することがあります。 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットも高くなります。

ComputeRoute

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse) ターミナルと中間地点のセットを指定すると、プライマリ ルートとオプションの代替ルートを返します。 注: このメソッドでは、入力にレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクを指定するには、URL パラメータ $fields または fields を使用するか、HTTP/gRPC ヘッダー X-Goog-FieldMask を使用します（使用可能な URL パラメータとヘッダーをご覧ください）。値はカンマ区切りのフィールド フィールドのリストです。詳しくは、フィールドパスの作成方法に関するドキュメントをご覧ください。 たとえば、次のメソッドを使用します。 使用可能なすべてのフィールドのフィールド マスク（手動検査用）: X-Goog-FieldMask: * ルートレベルの所要時間、距離、ポリラインのフィールド マスク（本番環境設定の例）: X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline ワイルドカード（*）レスポンスのフィールド マスクを使用したり、トップレベル（routes）でフィールド マスクを指定したりしないことをおすすめします。理由は次のとおりです。 必要なフィールドのみを選択して計算サイクルを短縮することで、より短いレイテンシで結果を返すことができます。 本番環境ジョブに必要なフィールドのみを選択すると、安定したレイテンシのパフォーマンスが確保されます。今後、レスポンス フィールドがさらに追加される可能性があります。また、これらの新しいフィールドでは、追加の計算時間が必要になることがあります。すべてのフィールドを選択するか、トップレベルですべてのフィールドを選択すると、追加された新しいフィールドが自動的にレスポンスに含まれるため、パフォーマンスの低下が発生することがあります。 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットも高くなります。

ComputeRouteMatrixRequest

ComputeRouteMatrix リクエスト メッセージ

フィールド
origins[]	RouteMatrixOrigin 必須。レスポンス行の行を決定する終了元の配列。出発地と目的地のカーディナリティには、いくつかのサイズ制限が適用されます。 要素（出発地 / 目的地）の数は 625 以下にする必要があります。 ルーティング_preference が TRAFFIC_AWARE_OPTIMAL に設定されている場合、要素（出発地 / 目的地）の数は 100 以下にする必要があります。 place_id で指定した地点（出発地 + 目的地）の数は 50 以下にする必要があります。
destinations[]	RouteMatrixDestination 必須。デスティネーションの配列。レスポンス マトリックスの列を決定します。
travel_mode	RouteTravelMode （省略可）移動手段を指定します。
routing_preference	RoutingPreference （省略可）ルートの計算方法を指定します。サーバーは選択したルーティング設定を使用してルートを計算します。ルーティングの設定が原因でエラーが発生した場合や、レイテンシが極端に長い場合は、エラーが返されます。このオプションを指定できるのは、travel_mode が DRIVE または TWO_WHEELER の場合に限られます。それ以外の場合、リクエストは失敗します。
departure_time	Timestamp （省略可）出発時刻。この値を設定しなかった場合、デフォルトでリクエストを行った時刻になります。この値を、すでに発生している時間に設定すると、リクエストは失敗します。
language_code	string （省略可）「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合は、最初のオリジンの場所から表示言語が推測されます。
region_code	string （省略可）ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定される地域コード詳しくは、https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains をご覧ください。
extra_computations[]	ExtraComputation （省略可）リクエストを完了するために使用できる追加の計算のリスト。注: これらの追加の計算は、レスポンスで追加のフィールドを返す場合があります。これらの追加フィールドは、レスポンスで返されるフィールド マスクで指定する必要があります。

外算出

リクエストの完了時に実行する追加の計算。

列挙型
EXTRA_COMPUTATION_UNSPECIFIED	不使用。この値を含むリクエストは失敗します。
TOLLS	行列要素の通行情報。

ComputeRoutesRequest

ComputeRoutes リクエスト メッセージ。

フィールド
origin	Waypoint 必須。出発地の地点。
destination	Waypoint 必須。目的地の地点。
intermediates[]	Waypoint （省略可）経路上の地点のセット（到着駅または停留所）。最大 25 の中間地点がサポートされます。
travel_mode	RouteTravelMode （省略可）移動手段を指定します。
routing_preference	RoutingPreference （省略可）ルートの計算方法を指定します。サーバーは選択したルーティング設定を使用してルートを計算します。ルーティングの設定がエラーや非常に長いレイテンシになると、エラーが返されます。このオプションを指定できるのは、travel_mode が DRIVE または TWO_WHEELER の場合に限られます。それ以外の場合、リクエストは失敗します。
polyline_quality	PolylineQuality （省略可）ポリラインの品質の設定を指定します。
polyline_encoding	PolylineEncoding （省略可）ポリラインに優先するエンコードを指定します。
departure_time	Timestamp （省略可）出発時刻。この値を設定しなかった場合、デフォルトでリクエストを行った時刻が設定されます。この値をすでに発生している時間に設定すると、リクエストは失敗します。
compute_alternative_routes	bool （省略可）ルートに加え、代替ルートを計算するかどうかを指定します。中間地点を持つリクエストに対して代替ルートは返されません。
route_modifiers	RouteModifiers （省略可）ルートの計算方法に影響する一連の条件。
language_code	string （省略可）「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合は、経路リクエストの場所から表示言語が推測されます。
region_code	string （省略可）ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定される地域コード詳しくは、https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains をご覧ください。
units	Units （省略可）表示フィールドの測定単位を指定します。これには、NavigationInstruction の instruction フィールドが含まれます。ルート、区間、歩数距離、所要時間の測定単位は、この値の影響を受けません。この値を指定しない場合、表示ユニットはリクエストの場所から推測されます。
requested_reference_routes[]	ReferenceRoute （省略可）デフォルト ルートに加えて、リクエストの一部として計算する参照ルートを指定します。参照ルートは、デフォルト ルートとは異なるルートの計算目標を持つルートです。たとえば、FUEL_EFFICIENT 参照ルートの計算では、最適な燃料効率の高いルートを生成するさまざまなパラメータが考慮されます。
extra_computations[]	ExtraComputation （省略可）リクエストを完了するために使用できる追加の計算のリスト。注: これらの追加の計算は、レスポンスで追加のフィールドを返す場合があります。これらの追加フィールドは、レスポンスで返されるフィールド マスクで指定する必要があります。

外算出

リクエストの完了時に実行する追加の計算。

列挙型
EXTRA_COMPUTATION_UNSPECIFIED	不使用。この値を含むリクエストは失敗します。
TOLLS	有料道路の情報。
FUEL_CONSUMPTION	そのルートの推定燃料消費量。
TRAFFIC_ON_POLYLINE	経路の交通認識のポリライン。

ReferenceRoute

ComputeRoutesRequest でサポートされている参照ルート。

列挙型
REFERENCE_ROUTE_UNSPECIFIED	不使用。この値を含むリクエストは失敗します。
FUEL_EFFICIENT	燃料効率が良いルートこの値のラベルが付いたルートは、燃料消費量などのパラメータに最適化されていると判断されます。

ComputeRoutesResponse

レスポンス メッセージを ComputeRoute します。

フィールド
routes[]	Route compute_alternatives_routes を指定すると、計算されたルートの配列（最大 3 つ）が含まれ、指定しない場合のルートは 1 つのみが含まれます。この配列に複数のエントリが含まれている場合、最初のルートが最も推奨されます。配列が空の場合は、ルートが見つからなかったことを示します。
fallback_info	FallbackInfo 入力された設定内容をすべて考慮してもサーバーでルート結果を計算できない場合は、別の計算方法が使用されることがあります。フォールバック モードが使用されている場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合はこのフィールドが設定されていません。
geocoding_results	GeocodingResults 住所として指定された地点のジオコーディング レスポンス情報が含まれます。

フォールバック情報

フォールバックの結果が使用された理由と理由に関する情報。このフィールドを設定した場合、サーバーは優先モードとは異なるルーティング モードをフォールバックとして使用します。

フィールド
routing_mode	FallbackRoutingMode レスポンスに使用されるルーティング モード。フォールバックがトリガーされた場合は、元のクライアント リクエストで設定されたルーティング設定とは異なるモードになる場合があります。
reason	FallbackReason 元のレスポンスではなくフォールバック レスポンスが使用された理由。このフィールドは、フォールバック モードがトリガーされ、フォールバック レスポンスが返された場合にのみ入力されます。

フォールバックの理由

フォールバック レスポンスを使用する理由。

列挙型
FALLBACK_REASON_UNSPECIFIED	フォールバックの理由は指定されていません。
SERVER_ERROR	優先ルーティング モードでルートを計算する際にサーバーエラーが発生しましたが、代替モードで計算された結果を返すことができました。
LATENCY_EXCEEDED	ご希望のルーティング モードで期限内に計算を完了できませんでしたが、代替モードによって計算された結果を返すことができました。

FallbackRouting モード

返されるフォールバック レスポンスに使用される実際のルーティング モード。

列挙型
FALLBACK_ROUTING_MODE_UNSPECIFIED	使用されません。
FALLBACK_TRAFFIC_UNAWARE	TRAFFIC_UNAWARE google.maps.routing.v2.RoutingPreference がレスポンスの計算に使用されたことを示します。
FALLBACK_TRAFFIC_AWARE	TRAFFIC_AWARE RoutingPreference がレスポンスの計算に使用されたことを示します。

ジオコーディングされた地点

地点として使用される場所の詳細。住所の地点にのみデータが入力されます。住所がジオコーディングされた住所を特定するためのジオコーディング結果の詳細を含めます。

フィールド
geocoder_status	Status ジオコーディングの処理結果を示すステータス コードを示します。
type[]	string 結果の型（ゼロ個以上のタイプタグの形式）。サポートされるタイプ: https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types
partial_match	bool ジオコーダによって、元のリクエストに完全一致する住所は見つからなかったものの、部分一致する住所は見つかったことを示します。元のリクエストで住所の表記が間違っていたり、不完全である可能性があります。
place_id	string この結果の場所 ID。
intermediate_waypoint_request_index	int32 リクエスト内の対応する中間地点のインデックス。対応する地点が中間地点である場合にのみ入力されます。

ジオコーディングの結果

出発地、目的地、中間の地点の GeocodedWaypoints が含まれます。住所の地点にのみデータが入力されます。

フィールド
origin	GeocodedWaypoint ジオコーディングされた出発地。
destination	GeocodedWaypoint ジオコーディングされた地点。
intermediates[]	GeocodedWaypoint ジオコーディングされた中間地点のリスト。各地点は、リクエストで指定された地点のゼロベースの地点に対応するインデックス フィールドで構成されます。

場所

位置（地理的位置、任意の見出し）をカプセル化します。

フィールド
lat_lng	LatLng 地点の地理座標。
heading	Int32Value 交通の流れの方向に関連付けられたコンパスの見出し。この値は、ピックアップと降車に使用する道路の側を指定するために使用されます。方角の値は 0 ～ 360 で、0 は真北の見出しを指定し、90 は東の方向を指定します。このフィールドは、DRIVE と TWO_WHEELER RouteTravelMode でのみ使用できます。

Maneuver

現在のステップで行うナビゲーション アクションを指定する値のセット（左左折、マージ、ストレートなど）。

列挙型
MANEUVER_UNSPECIFIED	使用されません。
TURN_SLIGHT_LEFT	少し左に回します。
TURN_SHARP_LEFT	左に鋭角に曲がります。
UTURN_LEFT	左折します。
TURN_LEFT	左折します。
TURN_SLIGHT_RIGHT	少し右に曲がります。
TURN_SHARP_RIGHT	右に鋭角に曲がります。
UTURN_RIGHT	右左折します。
TURN_RIGHT	左折します。
STRAIGHT	まっすぐ
RAMP_LEFT	左のランプに入ります。
RAMP_RIGHT	適切なランプに進む。
MERGE	トラフィックに統合します。
FORK_LEFT	左のフォークを行く。
FORK_RIGHT	適切なフォークを。
FERRY	フェリーを利用します。
FERRY_TRAIN	電車に乗ってフェリーに乗ります。
ROUNDABOUT_LEFT	ロータリーを左折します。
ROUNDABOUT_RIGHT	環状交差点で右に曲がります。

Navigation の手順

RouteLegStep のナビゲーション手順をカプセル化します。

フィールド
maneuver	Maneuver 現在のステップ（右左折、合流、直線走行など）のナビゲーション手順をカプセル化します。このフィールドにより、表示するアイコンが決まります。
instructions	string この手順を説明する手順です。

Polyline

エンコードされたポリラインをカプセル化します。

フィールド
共用体フィールド polyline_type。ポリラインのタイプをカプセル化します。デフォルトは encoded_ポリラインです。polyline_type は次のいずれかになります。
encoded_polyline	string ポリライン エンコード アルゴリズムを使用したポリラインの文字列エンコード
geo_json_linestring	Struct GeoJSON LineString 形式でポリラインを指定します。

ポリラインのエンコード

返されるポリラインの優先タイプを指定します。

列挙型
POLYLINE_ENCODING_UNSPECIFIED	ポリラインのタイプ設定が指定されていません。デフォルトは ENCODED_POLYLINE です。
ENCODED_POLYLINE	ポリライン エンコード アルゴリズムを使用してエンコードされたポリラインを指定します。
GEO_JSON_LINESTRING	GeoJSON LineString 形式でポリラインを指定します。

ポリラインの画質

ポリラインの品質を指定する値のセット。

列挙型
POLYLINE_QUALITY_UNSPECIFIED	ポリラインの品質設定が指定されていません。デフォルトは OVERVIEW です。
HIGH_QUALITY	高品質のポリラインを指定します。これは OVERVIEW を超えるポイントで構成されますが、レスポンス サイズが大きくなります。精度を高めるために、この値を使用します。
OVERVIEW	少数のポリラインで構成される概要ポリラインを指定します。この値は、ルートの概要を表示する場合に使用します。このオプションを使用すると、HIGH_QUALITY オプションを使用する場合よりもリクエストのレイテンシが低くなります。

ルーティング

ルートは、開始地点、終了地点、中間地点をつなぐ一連の接続済み道路セグメントで構成されます。

フィールド
route_labels[]	RouteLabel Route のラベル。ルートの他のプロパティと比較する際に役立ちます。
legs[]	RouteLeg ルートを構成する区間（地点間のセグメント）です。各区間は、via 以外の 2 つの Waypoints 間のルートに対応しています。たとえば、中間地点がないルートには一方の区間しかありません。via 以外の中間地点を 1 つ含むルートには、2 つの区間があります。1 つの中間地点 via を含むルートには、1 つの区間があります。区間の順序は、地点 origin から intermediates から destination までの地点の順序と一致します。
distance_meters	int32 ルートの移動距離（メートル単位）。
duration	Duration ルートの移動に必要な時間。routing_preference を TRAFFIC_UNAWARE に設定する場合、この値は static_duration と同じです。routing_preference を TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定すると、交通状況を考慮してこの値が計算されます。
static_duration	Duration 交通状況を考慮せずにルートを走行した時間。
polyline	Polyline ルート全体のポリライン。このポリラインは、すべての legs を合わせたポリラインになります。
description	string 経路の説明。
warnings[]	string ルートを表示するときに表示する警告の配列。
viewport	Viewport ポリラインのビューポート境界ボックス。
travel_advisory	RouteTravelAdvisory 経路に関する追加情報。
route_token	string NavigationSDK に渡せるウェブセーフの base64 エンコードのルートトークン。これにより、Navigation SDK はナビゲーション中にルートを再構築できます。また、再ルーティングが発生した場合は、RoutesComputeRoutes が呼び出されたときに元のインテントを尊重します。お客様はこのトークンを不透明な blob として扱う必要があります。注: Route.route_token は、ComputeRoutesRequest.routing_preference を TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定しているリクエストでのみ使用できます。Route.route_token は、地点を使うリクエストではサポートされていません。

ルートラベル

Route のラベル。ルートの他のプロパティと比較する際に役立ちます。

列挙型
ROUTE_LABEL_UNSPECIFIED	デフォルト - 使用されません。
DEFAULT_ROUTE	ルートの計算で返されるデフォルトの「最適」ルート。
DEFAULT_ROUTE_ALTERNATE	デフォルトの「最適な」ルートの代替。compute_alternative_routes を指定すると、このようなルートが返されます。
FUEL_EFFICIENT	燃料効率が良いルートこの値のラベルが付いたルートは、燃料消費量などのエコ パラメータに合わせて最適化されています。

ルートレッグ

via 以外の地点間のセグメントをカプセル化します。

フィールド
distance_meters	int32 経路の区間の移動距離（メートル単位）。
duration	Duration 脚の移動に必要な時間。route_preference が TRAFFIC_UNAWARE に設定されている場合、この値は static_duration と同じです。route_preference が TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL の場合、この値は交通状況に基づいて計算されます。
static_duration	Duration 交通状況を考慮せずに計算された、区間内の所要時間。
polyline	Polyline この区間の全体的なポリライン。これには各 step のポリラインも含まれます。
start_location	Location この区間の始点の場所。指定された origin と異なる場合があります。たとえば、指定した origin が道路の近くにない場合、これは道路上の地点です。
end_location	Location この区間の終点。指定された destination と異なる場合があります。たとえば、指定した destination が道路の近くにない場合、これは道路上の地点です。
steps[]	RouteLegStep この区間のセグメントを示すステップの配列。各ステップは 1 つのナビゲーション命令を表します。
travel_advisory	RouteLegTravelAdvisory ルートの区間で考えられる交通ゾーンの制限など、ユーザーに通知する必要のある追加情報をカプセル化します。

ルートレッグステップ

RouteLeg のセグメントをカプセル化します。ステップは 1 つのナビゲーション命令に対応します。ルート区間は複数のステップで構成されます。

フィールド
distance_meters	int32 このステップの移動距離（メートル単位）。状況によっては、このフィールドに値が表示されないことがあります。
static_duration	Duration 交通状況を考慮しない、このステップの移動時間。状況によっては、このフィールドに値が表示されないことがあります。
polyline	Polyline このステップに関連付けられたポリライン。
start_location	Location このステップの始点の場所。
end_location	Location このステップの終了位置。
navigation_instruction	NavigationInstruction ナビゲーション手順。
travel_advisory	RouteLegStepTravelAdvisory レッグステップのトラフィック ゾーン制限など、ユーザーに通知する必要のある追加情報がカプセル化されています。

ルートレッグトラベルアドバイザリ

レッグステップのトラフィック ゾーン制限など、ユーザーに通知する必要のある追加情報がカプセル化されています。

フィールド
speed_reading_intervals[]	SpeedReadingInterval 注: 現在、このフィールドにはデータが入力されていません。

ルート区間の移動案内

ルートの区間で考えられる交通ゾーンの制限など、ユーザーに通知する必要のある追加情報をカプセル化します。

フィールド
toll_info	TollInfo 特定の RouteLegs の有料道路に関する情報をカプセル化します。このフィールドは、RouteLegs で有料道路が予想される場合にのみ入力されます。このフィールドが設定されていても、estimated_price サブフィールドには値が入力されていない場合、道路には有料道路が含まれることが想定されますが、推定料金はわかりません。このフィールドが存在しない場合、RouteLeg には有料道路がありません。
speed_reading_intervals[]	SpeedReadingInterval トラフィック密度の詳細を示す読み取り間隔。TRAFFIC_AWARE と TRAFFIC_AWARE_OPTIMAL のルーティング設定を適用する場合に適用されます。間隔は、RouteLg のポリライン全体を重複なしでカバーします。指定した間隔の始点は、前の間隔の終点と同じです。 例: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).

ルート マトリックスの目的地

ComputeRouteMatrixRequest の単一の宛先

フィールド
waypoint	Waypoint 必須。目的地の地点

ルート マトリックス要素

ComputeRouteMatrix API で出発地と目的地のペアについて計算されたルート情報をカプセル化します。この proto は、クライアントにストリーミングできます。

フィールド
status	Status この要素のエラー ステータス コード。
condition	RouteMatrixElementCondition ルートが見つかったかどうかを示します。ステータスとは無関係です。
distance_meters	int32 ルートの移動距離（メートル単位）。
duration	Duration ルートの移動に必要な時間。routing_preference を TRAFFIC_UNAWARE に設定する場合、この値は static_duration と同じです。routing_preference を TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定すると、交通状況を考慮してこの値が計算されます。
static_duration	Duration 交通状況を考慮せずにルートを走行した時間。
travel_advisory	RouteTravelAdvisory 経路に関する追加情報。（制限情報や通行証情報など）。
fallback_info	FallbackInfo サーバーが、この特定の出発地/目的地のペアで指定された設定を使ってルートを計算できない場合、別の計算モードの使用にフォールバックすることがあります。フォールバック モードを使用する場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合はこのフィールドが設定されていません。
origin_index	int32 リクエスト内のオリジンのゼロベースのインデックス。
destination_index	int32 リクエスト内の宛先のゼロベースのインデックス。

RouteMatrixElementCondition

返されるルートの条件。

列挙型
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED	要素の status が OK でない場合にのみ使用されます。
ROUTE_EXISTS	ルートが検出され、要素の対応する情報が入力されました。
ROUTE_NOT_FOUND	経路は見つかりませんでした。distance_meters や duration などのルート情報を含むフィールドは、要素に入力されません。

ルート マトリックスの起点

ComputeRouteMatrixRequest の単一の送信元

フィールド
waypoint	Waypoint 必須。出発地点
route_modifiers	RouteModifiers （省略可）これを出発地とするすべてのルートの修飾子

ルート修飾子

ルートの計算時に満たすことができる一連の条件をカプセル化します。

フィールド
avoid_tolls	bool 有料道路を妥当な範囲で回避するかどうかを指定します。有料道路を含まないルートが優先されます。DRIVE と TWO_WHEELER RouteTravelMode にのみ適用されます。
avoid_highways	bool 高速道路を合理的に回避するかどうかを指定します。幹線道路を含まないルートが優先されます。DRIVE と TWO_WHEELER RouteTravelMode にのみ適用されます。
avoid_ferries	bool フェリーを合理的に回避するかどうかを指定します。フェリーでの移動を含まない経路が優先されます。DRIVE と TWO_WHEELER RouteTravelMode にのみ適用されます。
avoid_indoor	bool 妥当な場合に屋内への移動を避けるかどうかを指定します。屋内移動を含まない経路が優先されます。WALK RouteTravelMode にのみ適用されます。
vehicle_info	VehicleInfo 車両情報を指定します。
toll_passes[]	TollPass 通行券に関する情報をカプセル化します。通行料金が指定されている場合、API はパス料金の返却を試みます。通行証が提供されない場合、API は通行証を不明として扱い、現金料金の返却を試みます。DRIVE と TWO_WHEELER RouteTravelMode にのみ適用されます。

ルート旅行アドバイザリ

トラフィック ゾーンの制限など、ユーザーに通知する必要のある追加情報をカプセル化します。

フィールド
toll_info	TollInfo ルートの有料道路に関する情報をカプセル化します。このフィールドは、ルートで有料道路が予想される場合にのみ入力されます。このフィールドが設定されていても、estimated_price サブフィールドには値が入力されていない場合、道路には有料道路が含まれることが想定されますが、推定料金はわかりません。このフィールドが設定されていない場合は、ルート上には有料道路が含まれません。
speed_reading_intervals[]	SpeedReadingInterval トラフィック密度の詳細を示す読み取り間隔。TRAFFIC_AWARE と TRAFFIC_AWARE_OPTIMAL のルーティング設定を適用する場合に適用されます。間隔は、ルートのポリライン全体を重複なしでカバーします。指定した間隔の始点は、前の間隔の終点と同じです。 例: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters	int64 マイクロリットルでの燃料消費量の予測。

ルート移動モード

移動手段を指定するために使用される値のセット。注: WALK、BICYCLE、TWO_WHEELER のルートはベータ版のため、明確な歩道、歩行者専用道路、自転車専用道路がないことがある場合があります。この警告は、アプリに表示するすべての徒歩、自転車、オートバイのルートについて、ユーザーに表示する必要があります。

列挙型
TRAVEL_MODE_UNSPECIFIED	移動手段が指定されていません。デフォルトは DRIVE です。
DRIVE	乗用車で移動する。
BICYCLE	自転車で移動。
WALK	徒歩での旅行。
TWO_WHEELER	二輪車例: オートバイこれは、人間が運転するモードに対応する移動手段 BICYCLE とは異なります。

ルーティング設定

ルートを計算する際に考慮する要素を指定する値のセット。

列挙型
ROUTING_PREFERENCE_UNSPECIFIED	ルーティング設定が指定されていません。デフォルトは TRAFFIC_UNAWARE です。
TRAFFIC_UNAWARE	リアルタイムの交通状況は考慮せずにルートを計算します。交通状況があまり重要でない、または適用できない場合に適している。この値を使用すると、レイテンシを最小限に抑えることができます。注: RouteTravelMode の DRIVE と TWO_WHEELER について、経路と所要時間は道路網と平均的な交通状況（時間的な要素を考慮に入れない）に基づいて選択されます。リクエストの結果は、道路網の変化、平均交通条件の更新、サービスの分散性などによって、時間とともに変化する可能性があります。また、結果は、ほぼ同等のルートでも、時刻やリクエストの頻度によって異なる場合があります。
TRAFFIC_AWARE	実際の交通状況を加味したルートを計算します。TRAFFIC_AWARE_OPTIMAL とは対照的に、一部の最適化ではレイテンシが大幅に短縮されます。
TRAFFIC_AWARE_OPTIMAL	パフォーマンスを最適化することなく、実際の交通状況を加味したルートを計算します。この値を使用すると、レイテンシが最も高くなります。

速読間隔

ポリラインまたはパスの隣接するセグメントのトラフィック密度インジケーター速度読み取り間隔では、点 P_0、P_1、...、P_N（ゼロベースのインデックス）に基づいて間隔が定義され、以下のカテゴリを使用してトラフィックが記述されます。

フィールド
start_polyline_point_index	int32 ポリラインにおけるこの間隔の開始インデックス。
end_polyline_point_index	int32 ポリラインにおけるこの間隔の終了インデックス。
共用体フィールド speed_type。 speed_type は次のいずれかになります。
speed	Speed この間隔のトラフィック速度。

スピード

トラフィック データに基づくポリライン速度の分類。

列挙型
SPEED_UNSPECIFIED	デフォルト値。この値は使用されません。
NORMAL	通常の速度で速度低下が検出されない。
SLOW	速度低下は検出されましたが、渋滞は発生していません。
TRAFFIC_JAM	渋滞が検出されました。

通行料金

Route または RouteLeg の通行情報をカプセル化します。

フィールド
estimated_price[]	Money 対応する Route または RouteLeg の通行料金。このリストには、有料区間で請求される予定の通貨ごとの金額が記載されています。通常、このリストには、1 つの通貨で通行証を表示するルートのアイテムが 1 つだけ含まれています。海外旅行の場合、通行料金が異なる通貨を含む複数の項目がこのリストに含まれることがあります。

通行証

Google がサポートしている世界中の有料道路のリスト。

列挙型
TOLL_PASS_UNSPECIFIED	不使用。この値が使用されていると、リクエストは失敗します。
AU_ETOLL_TAG	シドニーの有料道路。詳しくは、https://www.myetoll.com.au をご覧ください。
AU_EWAY_TAG	シドニーの有料道路。詳しくは https://www.tollpay.com.au をご覧ください。
AU_LINKT	オーストラリア全土の通行証。詳しくは、https://www.linkt.com.au/ をご覧ください。
AR_TELEPASE	アルゼンチンの有料道路。詳しくは、https://telepase.com.ar をご覧ください。
BR_AUTO_EXPRESO	ブラジルの通行証。詳しくは、https://www.autoexpreso.com をご覧ください。
BR_CONECTCAR	ブラジルの通行証。詳しくは、https://conectcar.com をご覧ください。
BR_MOVE_MAIS	ブラジルの通行証。詳しくは、https://movemais.com をご参照ください。
BR_PASSA_RAPIDO	ブラジルの通行証。詳しくは、https://pasorapido.gob.do/ をご覧ください
BR_SEM_PARAR	ブラジルの通行証。詳しくは、https://www.semparar.com.br をご覧ください。
BR_TAGGY	ブラジルの通行証。詳しくは、https://taggy.com.br をご覧ください。
BR_VELOE	ブラジルの通行証。詳しくは、https://veloe.com.br/site/onde-usar をご覧ください。
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD	カナダと米国間の国境を行き来しています。
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD	カナダと米国間の国境を行き来しています。
CA_US_BLUE_WATER_EDGE_PASS	オンタリオ州（カナダ、ミシガン州、米国国境）
CA_US_CONNEXION	オンタリオ州（カナダ、ミシガン州、米国国境）
CA_US_NEXUS_CARD	カナダと米国間の国境を行き来しています。
ID_E_TOLL	インドネシア。通行料金の支払いに複数の銀行が提供する電子カード。カード発行会社の電子カードはすべて同じように請求されるため、必要な列挙値は 1 つだけです。例 - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG	（インド）。
IN_LOCAL_HP_PLATE_EXEMPT	インド、HP 州プレート免除。
MX_IAVE	メキシコの通行証。https://iave.capufe.gob.mx/#/
MX_PASE	メキシコ https://www.pase.com.mx
MX_QUICKPASS	メキシコ https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE	メキシコ
MX_TAG_TELEVIA	メキシコの通行証券会社。メキシコシティで事業を展開している企業の 1 つです。詳しくは、https://www.televia.com.mx をご覧ください。
MX_TELEVIA	メキシコの通行証券会社。メキシコシティで多くの事業を展開しています。https://www.televia.com.mx
MX_VIAPASS	メキシコの通行証。詳しくは、https://www.viapass.com.mx/viapass/web_home.aspx をご覧ください。
US_AL_FREEDOM_PASS	AL、米国。
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS	AK、米国。
US_CA_FASTRAK	米国、カナダ。
US_CA_FASTRAK_CAV_STICKER	DMV が発行した Clean Air Vehicle（CAV）ステッカーに加えて FasTrak パスを保有していることを示します。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL	CO、米国。
US_CO_GO_PASS	CO、米国。
US_DE_EZPASSDE	ドイツ、米国。
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS	フロリダ州（米国）
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD	フロリダ州（米国）
US_FL_EPASS	フロリダ州（米国）
US_FL_GIBA_TOLL_PASS	フロリダ州（米国）
US_FL_LEEWAY	フロリダ州（米国）
US_FL_SUNPASS	フロリダ州（米国）
US_FL_SUNPASS_PRO	フロリダ州（米国）
US_IL_EZPASSIL	米国イリノイ州
US_IL_IPASS	米国イリノイ州
US_IN_EZPASSIN	インド、米国。
US_KS_BESTPASS_HORIZON	KS、米国。
US_KS_KTAG	KS、米国。
US_KS_NATIONALPASS	KS、米国。
US_KS_PREPASS_ELITEPASS	KS、米国。
US_KY_RIVERLINK	ケンタッキー州アメリカ。
US_LA_GEAUXPASS	LA（米国）
US_LA_TOLL_TAG	LA（米国）
US_MA_EZPASSMA	MA、USA
US_MD_EZPASSMD	医学博士、米国
US_ME_EZPASSME	ME、USA。
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	米国ミシガン州
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	米国ミシガン州
US_MI_IQ_PROX_CARD	米国ミシガン州
US_MI_MACKINAC_BRIDGE_MAC_PASS	米国ミシガン州
US_MI_NEXPRESS_TOLL	米国ミシガン州
US_MN_EZPASSMN	米国ミネソタ州
US_NC_EZPASSNC	NC、米国。
US_NC_PEACH_PASS	NC、米国。
US_NC_QUICK_PASS	NC、米国。
US_NH_EZPASSNH	NH、米国。
US_NJ_DOWNBEACH_EXPRESS_PASS	米国ニュージャージー州。
US_NJ_EZPASSNJ	米国ニュージャージー州。
US_NY_EXPRESSPASS	ニューヨーク州（米国）。
US_NY_EZPASSNY	ニューヨーク州（米国）。
US_OH_EZPASSOH	米国オハイオ州。
US_PA_EZPASSPA	PA（米国）
US_RI_EZPASSRI	RI、米国。
US_SC_PALPASS	SC、米国。
US_TX_BANCPASS	米国テキサス州
US_TX_DEL_RIO_PASS	米国テキサス州
US_TX_EFAST_PASS	米国テキサス州
US_TX_EAGLE_PASS_EXPRESS_CARD	米国テキサス州
US_TX_EPTOLL	米国テキサス州
US_TX_EZ_CROSS	米国テキサス州
US_TX_EZTAG	米国テキサス州
US_TX_LAREDO_TRADE_TAG	米国テキサス州
US_TX_PLUSPASS	米国テキサス州
US_TX_TOLLTAG	米国テキサス州
US_TX_TXTAG	米国テキサス州
US_TX_XPRESS_CARD	米国テキサス州
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD	米国ユタ州
US_VA_EZPASSVA	VA、米国。
US_WA_BREEZEBY	米国ワシントン州
US_WA_GOOD_TO_GO	米国ワシントン州
US_WV_EZPASSWV	WV、米国。
US_WV_MEMORIAL_BRIDGE_TICKETS	WV、米国。
US_WV_NEWELL_TOLL_BRIDGE_TICKET	WV、米国。

単位

ディスプレイで使用される測定単位を指定する値のセット。

列挙型
UNITS_UNSPECIFIED	測定単位が指定されていません。デフォルトは、リクエストから推定される測定単位です。
METRIC	指標の単位。
IMPERIAL	ヤード・ポンド法

車両排出量タイプ

車両の排出量タイプを説明する値のセット。DRIVE RouteTravelMode にのみ適用されます。

列挙型
VEHICLE_EMISSION_TYPE_UNSPECIFIED	排出タイプが指定されていません。デフォルトは GASOLINE です。
GASOLINE	ガソリン、ガソリン。
ELECTRIC	電気自動車
HYBRID	ハイブリッド燃料（ガソリン、電気など）。
DIESEL	ディーゼル燃料車。

車両情報

ナンバー プレートの最後の文字などの車両情報をカプセル化します。

フィールド
emission_type	VehicleEmissionType 車の排出量を表します。移動手段 DRIVE にのみ適用されます。

ウェイポイント

地点をカプセル化します。地点とは経路の始点と終点を示し、ルート上の中間地点を含みます。

フィールド
via	bool この地点は停止地点ではなくマイルストーンであるとマークします。レスポンスでは、リクエスト内の地点以外の各地点に対して、legs 配列にエントリを追加し、そのルート内で出発地と到着地となる経由地の詳細を指定します。停止地点を指定せずにルートがこの地点を通過するには、この値を true に設定します。地点を介してエントリが legs 配列に追加されることはありませんが、出発地点へのルートは渡されます。この値は中間地点にしか設定できません。このフィールドをターミナル ウェイポイントに設定すると、リクエストは失敗します。ComputeRoutesRequest.optimize_waypoint_order が true に設定されている場合、このフィールドを true に設定することはできません。そうでない場合、リクエストは失敗します。
vehicle_stopover	bool 地点は、停車地での乗車または降車を想定しています。この値を設定すると、ルートの乗り降りに適さない道路の via 以外の地点は計算ルートに含まれません。このオプションは、DRIVE および TWO_WHEELER の移動モード、および location_type が Location の場合にのみ機能します。
side_of_road	bool この地点は、車両が特定の道路の脇に停車することを優先することを示します。この値を設定すると、経路の中心が通過するため、道路の中心から偏った方向に車両が停車できます。このオプションは、「DRIVE」と「TWO_WHEELER」RouteTravelMode の場合にのみ機能します。
共用体フィールド location_type。場所を表すさまざまな方法です。location_type は次のいずれかになります。
location	Location 地理座標を使用して指定された地点（任意の見出しも含む）。
place_id	string 地点に関連付けられたスポット ID です。
address	string 人が読める形式の住所または plus code。詳しくは、https://plus.codes をご覧ください。