Package google.maps.routes.v1

インデックス

• RoutesPreferred（インターフェース）
• ComputeCustomRoutesRequest（メッセージ）
• ComputeCustomRoutesResponse（メッセージ）
• ComputeCustomRoutesResponse.FallbackInfo（メッセージ）
• ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective（列挙型）
• ComputeRouteMatrixRequest（メッセージ）
• ComputeRoutesRequest（メッセージ）
• ComputeRoutesResponse（メッセージ）
• CustomRoute（メッセージ）
• FallbackInfo（メッセージ）
• FallbackReason（列挙型）
• FallbackRoutingMode（列挙型）
• Location（メッセージ）
• Maneuver（列挙型）
• NavigationInstruction（メッセージ）
• Polyline（メッセージ）
• PolylineEncoding（列挙型）
• PolylineQuality（列挙型）
• Route（メッセージ）
• RouteLeg（メッセージ）
• RouteLegStep（メッセージ）
• RouteLegStepTravelAdvisory（メッセージ）
• RouteLegTravelAdvisory（メッセージ）
• RouteMatrixDestination（メッセージ）
• RouteMatrixElement（メッセージ）
• RouteMatrixElementCondition（列挙型）
• RouteMatrixOrigin（メッセージ）
• RouteModifiers（メッセージ）
• RouteObjective（メッセージ）
• RouteObjective.RateCard（メッセージ）
• RouteObjective.RateCard.MonetaryCost（メッセージ）
• RouteTravelAdvisory（メッセージ）
• RouteTravelMode（列挙型）
• RoutingPreference（列挙型）
• SpeedReadingInterval（メッセージ）
• SpeedReadingInterval.Speed（列挙型）
• TollInfo（メッセージ）
• TollPass（列挙型）
• Units（列挙型）
• VehicleEmissionType（列挙型）
• VehicleInfo（メッセージ）
• Waypoint（メッセージ）

RoutesPreferred

Routes Preferred API。

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse) 終点と中間地点のセット、経路の目的が与えられると、経路の目的に対する最適経路が計算されます。また、最速ルートと最短ルートを参照ルートとして返します。 注: このメソッドでは、入力でレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクは、URL パラメータ $fields または fields を使用するか、HTTP/gRPC ヘッダー X-Goog-FieldMask を使用して指定できます（使用可能な URL パラメータとヘッダーをご覧ください）。値はフィールドパスのカンマ区切りのリストです。詳しくは、フィールド パスの作成方法をご覧ください。 たとえば、このメソッドでは次のようになります。 使用可能なすべての項目のフィールド マスク（手動検査用）: X-Goog-FieldMask: * ルートの距離、所要時間、トークン、通行料金の情報のフィールド マスク: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo 以下の理由により、ワイルドカード（*）レスポンス フィールド マスクを使用したり、トップレベル（routes）でフィールド マスクを指定したりすることはおすすめしません。 必要なフィールドのみを選択することで、サーバーの計算サイクルが節約され、低レイテンシで結果を返すことができます。 本番環境のジョブに必要なフィールドのみを選択することで、安定したレイテンシ パフォーマンスを確保できます。今後、レスポンス フィールドがさらに追加される可能性があります。また、このような新しいフィールドでは計算時間が増加する可能性があります。すべてのフィールドを選択した場合や、トップレベルのすべてのフィールドを選択した場合、新しく追加したフィールドが自動的にレスポンスに含まれるため、パフォーマンスが低下する可能性があります。 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットが向上します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/maps-platform.routespreferred 詳しくは、OAuth 2.0 の概要をご覧ください。

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 を含めることが重要です。含めないと、すべてのメッセージが正しく機能するようになります。以下の理由により、ワイルドカード（*）レスポンス フィールド マスクの使用はおすすめしません。 必要なフィールドのみを選択することで、サーバーの計算サイクルが節約され、低レイテンシで結果を返すことができます。 本番環境のジョブに必要なフィールドのみを選択することで、安定したレイテンシ パフォーマンスを確保できます。今後、レスポンス フィールドがさらに追加される可能性があります。また、このような新しいフィールドでは計算時間が増加する可能性があります。すべてのフィールドを選択した場合や、トップレベルのすべてのフィールドを選択した場合、新しく追加したフィールドが自動的にレスポンスに含まれるため、パフォーマンスが低下する可能性があります。 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットが向上します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/maps-platform.routespreferred 詳しくは、OAuth 2.0 の概要をご覧ください。

ComputeRoutes

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）でフィールド マスクを指定したりすることはおすすめしません。 必要なフィールドのみを選択することで、サーバーの計算サイクルが節約され、低レイテンシで結果を返すことができます。 本番環境のジョブに必要なフィールドのみを選択することで、安定したレイテンシ パフォーマンスを確保できます。今後、レスポンス フィールドがさらに追加される可能性があります。また、このような新しいフィールドでは計算時間が増加する可能性があります。すべてのフィールドを選択した場合や、トップレベルのすべてのフィールドを選択した場合、新しく追加したフィールドが自動的にレスポンスに含まれるため、パフォーマンスが低下する可能性があります。 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットが向上します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/maps-platform.routespreferred 詳しくは、OAuth 2.0 の概要をご覧ください。

ComputeCustomRoutesRequest

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

フィールド
origin	Waypoint 必須。出発地の地点。
destination	Waypoint 必須。目的地の地点。
intermediates[]	Waypoint 省略可。ルート上のウェイポイントのセット（終点を除く）。停車地点または通過地点。最大 25 個の中間地点がサポートされます。
travel_mode	RouteTravelMode 省略可。移動手段を指定します。現在、DRIVE のみがサポートされています。
routing_preference	RoutingPreference 省略可。ルートの計算方法を指定します。サーバーは、選択されたルーティング設定を使用してルートの計算を試みます。ルーティング設定によってエラーや余分なレイテンシが発生した場合は、エラーが返されます。将来的には、優先されるオプションから有効な結果が得られない場合に別のオプションを使用するフォールバック メカニズムが実装される可能性があります。このオプションは、travel_mode が DRIVE または TWO_WHEELER の場合にのみ指定できます。それ以外の場合、リクエストは失敗します。
polyline_quality	PolylineQuality 省略可。ポリラインの品質に関する設定を指定します。
polyline_encoding	PolylineEncoding 省略可。ポリラインの優先エンコードを指定します。
departure_time	Timestamp 省略可。出発時刻。この値を設定しない場合、この値はデフォルトでリクエストを行った時刻になります。すでに発生している時刻に設定すると、リクエストは失敗します。
route_modifiers	RouteModifiers 省略可。ルートの計算方法に影響を与える条件のセット。
route_objective	RouteObjective 必須。最適化するルートの目標。
language_code	string 省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合、表示言語は経路リクエストの場所から推定されます。
units	Units 省略可。表示フィールドの測定単位を指定します。これには、NavigationInstruction の instruction フィールドが含まれます。ルート、区間、歩数、所要時間の測定単位はこの値の影響を受けません。この値を指定しない場合、表示単位はリクエストの位置から推測されます。

ComputeCustomRoutesResponse

ComputeCustomRoutes レスポンス メッセージ。

フィールド
routes[]	CustomRoute 入力ルート目標の「最適」ルート。
fastest_route	CustomRoute 最速の参照ルート。
shortest_route	CustomRoute 最短の基準ルート。
fallback_info	FallbackInfo カスタムルートのフォールバック情報。

FallbackInfo

ComputeCustomRoutes のフォールバック情報をカプセル化します。ComputeCustomRoutes は、次の 2 種類のフォールバックを実行します。

1. お客様からリクエストされた routing_preference を使用してルートを計算できない場合は、別のルーティング モードにフォールバックします。このケースでは、fallback_routing_mode と routing_mode_fallback_reason を使用して、使用された代替ルーティング モードとフォールバックの理由が伝えられます。

2. 「最も良い」計算ができない場合別の目標にフォールバックする場合があります。フォールバック ルートの目標を伝えるには、fallback_route_objective を使用します。

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

FallbackRouteObjective

レスポンスに使用される RouteObjective。

列挙型
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED	フォールバック ルートの目標が指定されていません。
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA	顧客が RateCard をリクエストし、include_tolls を true に設定しており、Google に当該ルートの通行料金データがない場合、API は通行料金を考慮せずに RateCard にフォールバックします。

ComputeRouteMatrixRequest

ComputeRouteMatrix リクエスト メッセージ

フィールド
origins[]	RouteMatrixOrigin 必須。レスポンス マトリックスの行を決定するオリジンの配列。出発地と目的地のカーディナリティには、いくつかのサイズ制限が適用されます。 要素の数（出発地 × 目的地）は、どのような場合でも 625 を超えないようにする必要があります。 route_preference が TRAFFIC_AWARE_OPTIMAL に設定されている場合、要素の数（出発地 × 目的地）は 100 以下にする必要があります。 place_id として指定する地点（出発地 + 目的地）の数は 50 以下にする必要があります。
destinations[]	RouteMatrixDestination 必須。レスポンス マトリックスの列を決定する宛先の配列。
travel_mode	RouteTravelMode 省略可。移動手段を指定します。
routing_preference	RoutingPreference 省略可。ルートの計算方法を指定します。サーバーは、選択されたルーティング設定を使用してルートの計算を試みます。ルーティング設定によってエラーや余分なレイテンシが発生した場合は、エラーが返されます。将来的には、優先されるオプションから有効な結果が得られない場合に別のオプションを使用するフォールバック メカニズムが実装される可能性があります。このオプションは、travel_mode が DRIVE または TWO_WHEELER の場合にのみ指定できます。それ以外の場合、リクエストは失敗します。
departure_time	Timestamp 省略可。出発時刻。この値を設定しない場合は、リクエストを行った時刻がデフォルトになります。発生済みの時刻をこの値に設定すると、リクエストは失敗します。

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 を参照してください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合、表示言語は経路リクエストの場所から推定されます。
units	Units 省略可。表示フィールドの測定単位を指定します。これには、NavigationInstruction の instruction フィールドが含まれます。ルート、区間、歩数、所要時間の測定単位はこの値の影響を受けません。この値を指定しない場合、表示単位はリクエストの位置から推測されます。
optimize_waypoint_order	bool OptimizeWaypointOrder が true に設定されている場合は、経路の総コストを最小限に抑えるために、指定された中間地点の並べ替えが試行されます。いずれかの中間地点が地点を経由する場合、リクエストは失敗します。ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index を使用して、新しい順序を見つけます。X-Goog-FieldMask ヘッダーで routes.optimized_intermediate_waypoint_index がリクエストされていない場合、リクエストは失敗します。OptimizeWaypointOrder が false に設定されている場合、ComputeRoutesResponse.optimized_intermediate_waypoint_index は空です。

ComputeRoutesResponse

ComputeRoutes でレスポンス メッセージをルーティングします。

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

CustomRoute

お客様が指定したルートの目的に基づいて計算されたカスタムルートをカプセル化します。CustomRoute には、ルートとルートトークンが含まれています。これらのトークンを NavSDK に渡して、ターンバイターン方式のナビゲーションのカスタムルートを再構築できます。

フィールド
route	Route 「最良」ルートルートの総称です。
token	string ウェブセーフの Base64 でエンコードされたルートトークン。NavSDK に渡すことができます。これにより、NavSDK はナビゲーション中にルートを再構築できます。再ルーティングの場合は、RoutesPreferred ComputeCustomRoutes が呼び出されたときに元の意図に従ってルートを再構築できます。お客様はこのトークンを不透明な blob として扱う必要があります。

FallbackInfo

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

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

FallbackReason

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

列挙型
FALLBACK_REASON_UNSPECIFIED	フォールバックの理由が指定されていません。
SERVER_ERROR	ご希望のルーティング モードでルートを計算中にサーバーエラーが発生しましたが、代替モードで計算した結果を返すことができました。
LATENCY_EXCEEDED	ご希望のルーティング モードで時間通りに計算を完了できませんでしたが、別のモードで計算した結果を返すことができました。

FallbackRoutingMode

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

列挙型
FALLBACK_ROUTING_MODE_UNSPECIFIED	使用されません。
FALLBACK_TRAFFIC_UNAWARE	"TRAFFIC_UNAWARE" を示しますレスポンスの計算にはルーティング モードが使用されました。
FALLBACK_TRAFFIC_AWARE	"TRAFFIC_AWARE" を示しますレスポンスの計算にはルーティング モードが使用されました。

場所

場所（地理的位置、および省略可能な方角）をカプセル化します。

フィールド
lat_lng	LatLng 地点の地理的座標。
heading	Int32Value 交通の流れの方向に関連付けられたコンパス方位。この値は、乗車場所と降車場所のどちら側かを指定するために使用されます。見出しの値の範囲は 0 ～ 360 で、0 は真北の見出し、90 は真東の見出し、というように指定します。このフィールドは、DRIVE と TWO_WHEELER の移動手段でのみ使用できます。

Maneuver

現在のステップで実行するナビゲーション アクション（左折、結合、直線など）を指定する値のセット。

列挙型
MANEUVER_UNSPECIFIED	使用されません。
TURN_SLIGHT_LEFT	斜め左に曲がってください。
TURN_SHARP_LEFT	左大きく曲がる。
UTURN_LEFT	左に U ターンします。
TURN_LEFT	左折します。
TURN_SLIGHT_RIGHT	斜め右へ向けます。
TURN_SHARP_RIGHT	右手前方向に曲がる。
UTURN_RIGHT	右に U ターンします。
TURN_RIGHT	右折します。
STRAIGHT	まっすぐ。
RAMP_LEFT	左のランプを進みます。
RAMP_RIGHT	右ランプを進みます。
MERGE	トラフィックにマージする。
FORK_LEFT	左のフォークを進みます。
FORK_RIGHT	右のフォークに乗ってください。
FERRY	フェリーに乗ります。
FERRY_TRAIN	フェリーに乗る電車に乗る。
ROUNDABOUT_LEFT	ロータリーを左折します。
ROUNDABOUT_RIGHT	ロータリーを右折します。

NavigationInstruction

フィールド
maneuver	Maneuver 現在のステップのナビゲーション手順（左折、結合、直進など）をカプセル化します。このフィールドによって、表示するアイコンが決まります。
instructions	string このステップの移動手順。

ポリライン

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

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

PolylineEncoding

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

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

PolylineQuality

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

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

ルート

始点、終点、中間地点を結ぶ、連結された一連の道路セグメントで構成されるルートをカプセル化します。

フィールド
legs[]	RouteLeg ルートを構成する区間（ウェイポイント間の経路セグメント）の集合。各区間は、via 以外の 2 つのウェイポイント間のルートに対応しています。たとえば、中間ウェイポイントがないルートでは、区間が 1 つしかありません。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 ルートに関する追加情報。
optimized_intermediate_waypoint_index[]	int32 ComputeRoutesRequest.optimize_waypoint_order が true に設定されている場合、このフィールドには中間ウェイポイントの最適化された順序が含まれます。それ以外の場合、このフィールドは空になります。たとえば、入力が Origin: LA であるとします。中級者: ダラス、バンゴー、フェニックス、目的地: ニューヨーク最適化された中間ウェイポイントの順序はフェニックス、ダラス、バンゴーです。このフィールドには値 [2, 0, 1] が含まれます。最初の中間地点のインデックスは 0 から始まります。

RouteLeg

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 ユーザーに通知する必要のある追加情報（ルート区間で考えられる交通区域の制限など）をカプセル化します。

RouteLegStep

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

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

RouteLegStepTravelAdvisory

ユーザーに通知する必要のある追加情報（区間の区間で交通区域制限の可能性など）をカプセル化します。

フィールド
speed_reading_intervals[]	SpeedReadingInterval 交通量密度の詳細を示す速度読み取り間隔。ルーティング設定が TRAFFIC_AWARE と TRAFFIC_AWARE_OPTIMAL の場合に適用されます。この区間は RouteLegStep のポリライン全体を覆い、重なりません。指定した区間の開始点は、前の区間の終了点と同じです。 例: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

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

フィールド
toll_info	TollInfo 特定の RouteLeg の通行料金に関する情報をカプセル化します。このフィールドは、RouteLeg で通行料金が発生すると想定される場合にのみ入力されます。このフィールドが設定されていても、estimates_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).

RouteMatrixDestination

ComputeRouteMatrixRequest の単一の宛先

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

RouteMatrixElement

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

フィールド
origin_index	int32 リクエストに含まれるオリジンのゼロベースのインデックス。
destination_index	int32 リクエスト内の宛先のゼロベースのインデックス。
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 サーバーがこの特定の出発地と目的地のペアに対して指定された設定でルートを計算できない場合、別の計算モードを使用するようにフォールバックすることがあります。フォールバック モードが使用されている場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合、このフィールドは設定されません。

RouteMatrixElementCondition

返されるルートの状態。

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

RouteMatrixOrigin

ComputeRouteMatrixRequest の単一の送信元

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

RouteModifiers

ルートの計算時に満たす必要がある一連のオプションの条件をカプセル化します。

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

RouteObjective

ComputeCustomRoutes による最適化の目標をカプセル化します。

フィールド
rate_card	RateCard レート表の目標。

RateCard

レート表ルートの目標をカプセル化します。

フィールド
cost_per_minute	MonetaryCost 省略可。1 分あたりの費用。
cost_per_km	MonetaryCost 省略可。キロメートルあたりのコスト。
include_tolls	bool 省略可。通行料金の合計に通行料金を含めるかどうか。

MonetaryCost

レート表で使用されている費用をカプセル化します。

フィールド
value	double 必須。リクエストから推定された費用の値（現地通貨）。

RouteTravelAdvisory

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

フィールド
toll_info	TollInfo ルートの有料道路に関する情報をカプセル化します。このフィールドは、ルートに有料道路があると思われる場合にのみ入力されます。このフィールドが設定されていても、estimates_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).

RouteTravelMode

交通手段の指定に使用する値のセット。

列挙型
TRAVEL_MODE_UNSPECIFIED	移動手段が指定されていません。デフォルトは DRIVE です。
DRIVE	乗用車で移動する。
BICYCLE	自転車で移動。
WALK	徒歩で移動する。
TWO_WHEELER	二輪車（原動機付自転車）。例: オートバイ。これは、人間が操作するモードである BICYCLE の移動手段とは異なります。
TAXI	免許を保有するタクシーで移動するため、地域によっては指定のタクシーレーンを走行できる場合があります。 タクシーモードは試験運用版の機能です。タクシーレーンデータが利用できない都市で TAXI ルートをリクエストした場合は、DRIVE ルートが返されます。

RoutingPreference

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

列挙型
ROUTING_PREFERENCE_UNSPECIFIED	ルーティング設定が指定されていません。デフォルトは TRAFFIC_AWARE です。
TRAFFIC_UNAWARE	交通状況を考慮せずにルートを計算します。交通状況が気にならない場合に適しています。この値を使用すると、レイテンシが最も低くなります。
TRAFFIC_AWARE	交通状況を考慮してルートを計算する。TRAFFIC_AWARE_OPTIMAL とは対照的に、一部の最適化はレイテンシを大幅に短縮するために適用されます。
TRAFFIC_AWARE_OPTIMAL	パフォーマンスの最適化をほとんど行わずに、交通状況を考慮してルートを計算します。この値を使用すると、レイテンシが最大になります。

SpeedReadingInterval

ポリラインまたは経路の連続セグメントに表示される交通密度インジケーター。SpeedReadingInterval は、点 P_0、P_1、...、P_N（ゼロベースのインデックス）を持つパスが与えられると、間隔を定義し、次のカテゴリを使用してトラフィックを記述します。

フィールド
start_polyline_point_index	int32 ポリライン内のこの区間の開始インデックス。JSON では、インデックスが 0 の場合、フィールドに値が入力されていないように見えます。
end_polyline_point_index	int32 ポリライン内のこの区間の終了インデックス。JSON では、インデックスが 0 の場合、フィールドに値が入力されていないように見えます。
speed	Speed この期間の交通状況。

速度

交通データに基づいたポリラインの速度分類。

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

TollInfo

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

フィールド
estimated_price[]	Money 対応する Route または RouteLeg の通行料金。このリストには、各通貨の通行料金の請求額が記載されます。通常、このリストには、通行料を 1 つの通貨で表示しているルートのアイテムが 1 つだけ含まれます。海外旅行の場合は、さまざまな通貨の通行料金を反映するために、このリストに複数の項目を含めることができます。

TollPass

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	インドネシア、通行料金の支払いに、複数の銀行から提供される e カード。銀行経由で発行されるすべての e カードには同じ料金が請求されるため、必要な列挙値は 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_TAG_IAVE	メキシコの通行証。
MX_TAG_TELEVIA	メキシコの通行証券会社。メキシコシティで事業を展開している企業のうちの 1 社です。詳しくは、https://www.televia.com.mx をご覧ください。
MX_VIAPASS	メキシコの通行証。詳しくは、https://www.viapass.com.mx/viapass/web_home.aspx をご覧ください。
US_AL_FREEDOM_PASS	アラバマ州、米国。
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS	アラスカ州、米国。
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	コロラド州、米国。
US_CO_GO_PASS	コロラド州、米国。
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	マサチューセッツ州、米国。
US_MD_EZPASSMD	医学博士、米国。
US_ME_EZPASSME	ME、米国。
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	ノースカロライナ州、米国。
US_NC_PEACH_PASS	ノースカロライナ州、米国。
US_NC_QUICK_PASS	ノースカロライナ州、米国。
US_NH_EZPASSNH	ニューハンプシャー州、米国。
US_NJ_DOWNBEACH_EXPRESS_PASS	ニュージャージー州、米国。
US_NJ_EZPASSNJ	ニュージャージー州、米国。
US_NY_EXPRESSPASS	米国ニューヨーク州。
US_NY_EZPASSNY	米国ニューヨーク州。
US_OH_EZPASSOH	オハイオ、米国。
US_PA_EZPASSPA	ペンシルバニア州、米国。
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	UT、米国。
US_VA_EZPASSVA	バージニア州、米国。
US_WA_BREEZEBY	ワシントン州、米国。
US_WA_GOOD_TO_GO	ワシントン州、米国。
US_WV_EZPASSWV	ウェストバージニア州、米国。
US_WV_MEMORIAL_BRIDGE_TICKETS	ウェストバージニア州、米国。
US_WV_NEWELL_TOLL_BRIDGE_TICKET	ウェストバージニア州、米国。

単位

表示に使用される測定単位を指定する値のセット。

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

VehicleEmissionType

車両の排出タイプを表す値のセット。DRIVE 移動手段にのみ適用されます。

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

VehicleInfo

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

フィールド
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」'location_type' 属性が使用可能な場合、値が「location」に設定されます。
共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
location	Location 地理座標を使用して指定された地点。オプションで見出しも含む。
place_id	string ウェイポイントに関連付けられているスポットのプレイス ID。