Package google.maps.routes.v1

索引

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_modeDRIVE または 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

(省略可)表示フィールドの測定単位を指定します。これには、NavigationInstructioninstruction フィールドが含まれます。ルート、区間、ステップ距離、所要時間に使用される測定単位は、この値の影響を受けません。この値を指定しない場合、表示単位はリクエストの場所から推測されます。

ComputeCustomRoutesResponse

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

フィールド
routes[]

CustomRoute

入力ルートの目的に最適な「最適」ルート。

fastest_route

CustomRoute

最速の基準ルートです。

shortest_route

CustomRoute

最短の基準ルート。

fallback_info

FallbackInfo

カスタムルートのフォールバック情報。

FallbackInfo

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

  1. お客様からリクエストされた route_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_modeDRIVE または TWO_WHEELER の場合にのみ指定できます。それ以外の場合は、リクエストが失敗します。

departure_time

Timestamp

(省略可)出発時刻。この値を指定しない場合、デフォルトはリクエストを行った時刻になります。この値を、すでに発生した時刻に設定すると、リクエストは失敗します。

ComputeRoutesRequest

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

フィールド
origin

Waypoint

必須。出発地の地点。

destination

Waypoint

必須。目的地の地点。

intermediates[]

Waypoint

(省略可)経路上の一連の地点(終点は除く)。停車場所または通過地点です。最大 25 個の中間地点がサポートされています。

travel_mode

RouteTravelMode

(省略可)移動手段を指定します。

routing_preference

RoutingPreference

(省略可)ルートの計算方法を指定します。サーバーは、選択されたルーティング設定を使用してルートを計算します。ルーティング設定によりエラーまたは余分なレイテンシが発生した場合は、エラーが返されます。将来的には、推奨されるオプションでは有効な結果が得られない場合に別のオプションを使用するフォールバック メカニズムが実装される可能性があります。このオプションは、travel_modeDRIVE または 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

(省略可)表示フィールドの測定単位を指定します。これには、NavigationInstructioninstruction フィールドが含まれます。ルート、区間、ステップ距離、所要時間に使用される測定単位は、この値の影響を受けません。この値を指定しない場合、表示単位はリクエストの場所から推測されます。

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

NavSDK に渡すことができるウェブセーフな Base64 エンコードのルート トークン。これにより、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 は東方向などを指定します。このフィールドは、DRIVETWO_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 ロータリーを右を向いてください。
フィールド
maneuver

Maneuver

現在のステップのナビゲーション手順(左を向く、結合、直線など)をカプセル化します。このフィールドにより、表示するアイコンが決まります。

instructions

string

このステップの操作手順。

ポリライン

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

フィールド
共用体フィールド polyline_type。ポリラインのタイプをカプセル化します。デフォルトは encoded_polyline です。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 オプションを使用する場合よりもリクエスト レイテンシが低くなります。

Route

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

フィールド
legs[]

RouteLeg

ルートを構成する区間(地点間の経路セグメント)の集まり。各区間は、via でない 2 つのウェイポイント間のルートに対応します。たとえば、中間地点のないルートは 1 区間のみです。via 以外の中間地点が 1 つ含まれているルートには、2 つの区間があります。via の中間地点が 1 つあるルートには 1 つの区間があります。区間の順序は、originintermediatesdestination のウェイポイントの順序と同じです。

distance_meters

int32

ルートの移動距離(メートル単位)。

duration

Duration

ルートの移動に必要な時間の長さ。routing_preferenceTRAFFIC_UNAWARE に設定した場合、この値は static_duration と同じになります。routing_preferenceTRAFFIC_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 に設定されている場合、このフィールドには中間地点の最適化された順序が含まれます。それ以外の場合、このフィールドは空です。たとえば、出発地が LA、中間地域がダラス、バンゴー、フェニックス、目的地がニューヨーク、最適化された中間地点の順序がフェニックス、ダラス、バンガーであるとします。このフィールドには値 [2, 0, 1] が含まれます。最初の中間地点のインデックスは 0 から始まります。

RouteLeg

via でない地点間のセグメントをカプセル化します。

フィールド
distance_meters

int32

ルート区間の移動距離(メートル単位)。

duration

Duration

区間をナビゲートするのに必要な時間の長さ。route_preferenceTRAFFIC_UNAWARE に設定されている場合、この値は static_duration と同じです。route_preferenceTRAFFIC_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_AWARETRAFFIC_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 に有料道路がある場合にのみ入力されます。このフィールドが設定されていて、estimated_price サブフィールドに値が設定されていない場合、道路には通行料金が含まれていると想定されますが、見積もり料金は不明です。このフィールドが存在しない場合、RouteLeg には有料道路がありません。

speed_reading_intervals[]

SpeedReadingInterval

トラフィック密度の詳細を示す速度読み取り間隔。ルーティング設定が TRAFFIC_AWARETRAFFIC_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 の出発地と目的地のペアに対して計算されたルート情報をカプセル化します。このプロトコルはクライアントにストリーミングできます。

フィールド
origin_index

int32

リクエストのオリジンのゼロベースのインデックス。

destination_index

int32

リクエスト内の宛先のゼロベースのインデックス。

status

Status

この要素のエラー ステータス コード。

condition

RouteMatrixElementCondition

ルートが見つかったかどうかを示します。ステータスとは無関係。

distance_meters

int32

ルートの移動距離(メートル単位)。

duration

Duration

ルートの移動に必要な時間の長さ。routing_preferenceTRAFFIC_UNAWARE に設定した場合、この値は static_duration と同じになります。routing_preferenceTRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定した場合、この値は交通状況を考慮して計算されます。

static_duration

Duration

交通状況を考慮しないルートの移動時間。

travel_advisory

RouteTravelAdvisory

ルートに関する追加情報です。例: 制限情報や通行料金情報

fallback_info

FallbackInfo

サーバーが、この特定の出発地/目的地のペアに指定された設定に基づいてルートを計算できない場合、別の計算モードを使用するようフォールバックされる場合があります。フォールバック モードが使用されている場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合、このフィールドは設定されません。

RouteMatrixElementCondition

返されるルートの条件。

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

RouteMatrixOrigin

ComputeRouteMatrixRequest の単一の送信元

フィールド
waypoint

Waypoint

必須。出発地の地点

route_modifiers

RouteModifiers

(省略可)これをオリジンとするすべてのルートの修飾子

RouteModifiers

ルートの計算時に満たす、オプションの条件のセットをカプセル化します。

フィールド
avoid_tolls

bool

妥当な場合に有料道路を回避するかどうかを指定します。有料道路を含まないルートが優先されます。DRIVETWO_WHEELER の移動手段にのみ適用されます。

avoid_highways

bool

妥当な場合に高速道路を回避するかどうかを指定します。高速道路を含まないルートが優先されます。DRIVETWO_WHEELER の移動手段にのみ適用されます。

avoid_ferries

bool

妥当な場合にフェリーを回避するかどうかを指定します。フェリーによる移動を含まないルートが優先されます。DRIVETWO_WHEELER の移動手段にのみ適用されます。

avoid_indoor

bool

妥当な場合に屋内での移動を避けるかどうかを指定します。屋内案内が含まれないルートが優先されます。WALK の移動手段にのみ適用されます。

vehicle_info

VehicleInfo

車両情報を指定します。

toll_passes[]

TollPass

有料パスに関する情報をカプセル化します。通行料金パスを指定すると、API はパス料金を返そうとします。通行券が指定されていない場合、API は通行券を不明として扱い、現金料金を返そうとします。DRIVE モードと TWO_WHEELER 交通手段にのみ適用されます。

RouteObjective

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

フィールド
rate_card

RateCard

RateCard 目標。

RateCard

RateCard ルート目標をカプセル化します。

フィールド
cost_per_minute

MonetaryCost

(省略可)1 分あたりの費用。

cost_per_km

MonetaryCost

(省略可)1 キロメートルあたりの費用。

include_tolls

bool

(省略可)通行料金を総費用に含めるかどうかを指定します。

MonetaryCost

レート表で使用される費用がカプセル化されます。

フィールド
value

double

必須。リクエストから推測される現地通貨での費用値。

RouteTravelAdvisory

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

フィールド
toll_info

TollInfo

ルート上の有料道路の情報をカプセル化します。このフィールドは、ルート上に有料道路が存在することが想定される場合にのみ入力されます。このフィールドが設定されていて、estimated_price サブフィールドに値が設定されていない場合、道路には通行料金が含まれていると想定されますが、見積もり料金は不明です。このフィールドが設定されていない場合、ルート上に有料道路はないと想定されます。

speed_reading_intervals[]

SpeedReadingInterval

トラフィック密度の詳細を示す速度読み取り間隔。ルーティング設定が TRAFFIC_AWARETRAFFIC_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 モードは試験運用中の機能です。お客様がタクシー車線データが利用できない都市で 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 シドニーの通行券販売会社のうちの 1 つです。https://www.myetoll.com.au
AU_EWAY_TAG シドニーの通行券販売会社のうちの 1 つです。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 カードはすべて同じように請求されるため、必要な列挙値は 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 が発行するクリーンエア ビークル(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_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 NH、米国
US_NJ_DOWNBEACH_EXPRESS_PASS (米国ニュージャージー州)
US_NJ_EZPASSNJ (米国ニュージャージー州)
US_NY_EXPRESSPASS (米国ニューヨーク州)
US_NY_EZPASSNY (米国ニューヨーク州)
US_OH_EZPASSOH (米国オハイオ州)
US_PA_EZPASSPA (米国ペンシルバニア州)
US_RI_EZPASSRI RI, USA
US_SC_PALPASS サウスカロライナ州、米国カリフォルニア州、
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 (米国バージニア州)。
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 以外のウェイポイントは計算されたルートに含まれません。このオプションは、DRIVETWO_WHEELER の交通手段で、かつ location_typelocation の場合にのみ機能します。

side_of_road

bool

このウェイポイントの場所は、車両が道路の特定の側に停車することを優先することを示します。この値を設定すると、ルートは場所を通るようになります。これにより、車両は、位置が道路の中心から偏っている道路脇で停止できるようになります。このオプションは、交通手段が「DRIVE」と「TWO_WHEELER」で、location_type が「location」に設定されている場合にのみ機能します。

共用体フィールド location_type。ビジネス拠点を表すさまざまな方法。location_type は次のいずれかになります。
location

Location

地理座標を使用して指定された地点と方角。

place_id

string

地点に関連付けられているスポットのプレイス ID。