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

Google は、ワイルドカード(*)レスポンス フィールド マスクの使用や、トップレベル(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 をフィールド マスクに含めることが重要です。そうしないと、すべてのメッセージが OK と表示されます。Google は、ワイルドカード(*)レスポンス フィールド マスクの使用を推奨していません。理由は次のとおりです。

  • 必要なフィールドのみを選択すると、サーバーの計算サイクルを節約できるため、レイテンシを抑えて結果を返すことができます。
  • 本番環境ジョブで必要なフィールドのみを選択すると、レイテンシのパフォーマンスが安定します。今後、レスポンス フィールドが追加される可能性があり、その新しいフィールドでは追加の計算時間が必要になる場合があります。すべてのフィールドを選択した場合、または最上位レベルですべてのフィールドを選択した場合、新しいフィールドが追加されるたびにレスポンスに自動的に含まれるため、パフォーマンスが低下する可能性があります。
  • 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットが向上します。
認可スコープ

次の 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

Google は、ワイルドカード(*)レスポンス フィールド マスクの使用や、トップレベル(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 と「TWO_WHEELER」のみがサポートされています。

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 言語コード。詳しくは、Unicode ロケール識別子をご覧ください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合、表示言語はルート リクエストの場所から推測されます。

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 以下にする必要があります。
  • routing_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 言語コード。詳しくは、Unicode ロケール識別子をご覧ください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合、表示言語はルート リクエストの場所から推測されます。

units

Units

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

optimize_waypoint_order

bool

optimizeWaypointOrder が true に設定されている場合、指定された中間経由地を並べ替えて、ルートの全体的な費用を最小限に抑えようとします。中間地点のいずれかが経由地点の場合、リクエストは失敗します。ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index を使用して新しい順序を見つけます。X-Goog-FieldMask ヘッダーで routes.optimized_intermediate_waypoint_index がリクエストされていない場合、リクエストは失敗します。optimize_waypoint_order が 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 は真東の見出しなどを指定します。このフィールドは、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 ロータリーで右折します。
DEPART 初期操作。
NAME_CHANGE 道路名の変更を示すために使用されます。
DESTINATION 目的地への到着を示すために使用されます。
フィールド
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 オプションを使用するよりもリクエスト レイテンシが短くなります。

ルーティング

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

フィールド
legs[]

RouteLeg

ルートを構成する区間(地点間のパスセグメント)のコレクション。各区間は、2 つの via 以外の地点間の移動に対応します。たとえば、中間地点のないルートには 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 に設定されている場合、このフィールドには中間地点の最適化された順序が含まれます。それ以外の場合、このフィールドは空です。たとえば、出発地がロサンゼルス、中間地点がダラス、バンガー、フェニックス、目的地がニューヨークで、最適化された中間地点の順序がフェニックス、ダラス、バンガーであるとします。このフィールドには値 [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

注: このフィールドは現在使用されていません。

RouteLegTravelAdvisory

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

フィールド
toll_info

TollInfo

特定の RouteLeg の通行料金に関する情報をカプセル化します。このフィールドは、RouteLeg に有料道路があると思われる場合にのみ入力されます。このフィールドが設定されているが、estimated_price サブフィールドが入力されていない場合、道路に有料道路が含まれていることは想定されますが、推定料金は不明です。このフィールドが存在しない場合、RouteLeg に料金はかかりません。

speed_reading_intervals[]

SpeedReadingInterval

交通密度の詳細を示す速読間隔。TRAFFIC_AWARE と TRAFFIC_AWARE_OPTIMAL のルーティング設定の場合に適用されます。間隔は、重複することなく RouteLeg のポリライン全体をカバーします。指定された間隔の開始ポイントは、前の間隔の終了ポイントと同じです。

例:

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

リクエスト内のオリジンの 0 から始まるインデックス。

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

true に設定すると、有料道路を含まないルートを優先して、可能な限り有料道路を避けます。DRIVE と TWO_WHEELER の移動手段にのみ適用されます。

avoid_highways

bool

true に設定すると、高速道路を含まないルートを優先して、可能な限り高速道路を回避します。DRIVE と TWO_WHEELER の移動手段にのみ適用されます。

avoid_ferries

bool

true に設定すると、フェリーを回避できる場合はフェリーを回避し、フェリーを含まないルートを優先します。DRIVE と TWO_WHEELER の移動手段にのみ適用されます。

avoid_indoor

bool

true に設定すると、屋内ナビゲーションを含まないルートを優先して、可能な限り屋内ナビゲーションを回避します。WALK の移動手段にのみ適用されます。

vehicle_info

VehicleInfo

車両情報を指定します。

toll_passes[]

TollPass

通行券に関する情報をカプセル化します。有料道路の通行券が提供されている場合、API は通行券の料金を返そうとします。通行券が指定されていない場合、API は通行券を不明として扱い、現金価格を返そうとします。DRIVE と TWO_WHEELER の移動手段にのみ適用されます。

RouteObjective

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

フィールド
共用体フィールド objective。ルートの目標。objective は次のいずれかになります。
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_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 モードは試験運用版の機能です。タクシー専用レーンのデータがない都市でタクシー ルートがリクエストされた場合は、ドライブ ルートが返されます。

RoutingPreference

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

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

SpeedReadingInterval

ポリラインまたはパスの連続したセグメントの交通密度インジケーター。ポイント P_0、P_1、...、P_N(ゼロベースのインデックス)を含むパスが指定されている場合、SpeedReadingInterval は間隔を定義し、次のカテゴリを使用してトラフィックを記述します。

フィールド
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 インドネシア。複数の銀行が提供する電子カードを使用して通行料金を支払う。銀行経由のすべての電子カードには同じ料金が請求されるため、必要な列挙値は 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 州のナンバー プレートの免除。
JP_ETC 日本の ETC。有料道路の料金を徴収する電子ワイヤレス システム。https://www.go-etc.jp/
JP_ETC2 日本 ETC2.0。ETC の新バージョン。割引が拡大され、車両のデバイスと道路のアンテナ間の双方向通信が可能になります。https://www.go-etc.jp/etc2/index.html
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 メキシコの有料道路通行券会社。メキシコシティで営業している多くの店舗の一つです。詳しくは、https://www.televia.com.mx をご覧ください。
MX_TELEVIA メキシコの有料道路通行券会社。メキシコシティで運営されている多くの企業の 1 つ。https://www.televia.com.mx
MX_VIAPASS メキシコの通行券。詳しくは、https://www.viapass.com.mx/viapass/web_home.aspx をご覧ください。
US_AL_FREEDOM_PASS AL, USA。
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS アラスカ州(米国)。
US_CA_FASTRAK CA、米国。
US_CA_FASTRAK_CAV_STICKER 運転者が DMV 発行のクリーン エア ビークル(CAV)ステッカーに加えて FasTrak パスを所持しているかどうかを示します。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO、米国。
US_CO_GO_PASS CO、米国。
US_DE_EZPASSDE DE、USA。
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL、米国。
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL、米国。
US_FL_EPASS FL、米国。
US_FL_GIBA_TOLL_PASS FL、米国。
US_FL_LEEWAY FL、米国。
US_FL_SUNPASS FL、米国。
US_FL_SUNPASS_PRO FL、米国。
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, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA、米国。
US_MD_EZPASSMD MD、米国。
US_ME_EZPASSME ME、米国。
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD 米国ミシガン州。
US_MI_BCPASS 米国ミシガン州。
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG 米国ミシガン州。
US_MI_IQ_PROX_CARD

米国ミシガン州。このパスタイプは存在しなくなったため、非推奨になりました。

US_MI_IQ_TAG 米国ミシガン州。
US_MI_MACKINAC_BRIDGE_MAC_PASS 米国ミシガン州。
US_MI_NEXPRESS_TOLL 米国ミシガン州。
US_MN_EZPASSMN MN、米国。
US_NC_EZPASSNC NC、米国。
US_NC_PEACH_PASS NC、米国。
US_NC_QUICK_PASS NC、米国。
US_NH_EZPASSNH NH、米国。
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, USA.
US_NJ_EZPASSNJ NJ, USA.
US_NY_EXPRESSPASS ニューヨーク州ニューヨーク(米国)
US_NY_EZPASSNY ニューヨーク州ニューヨーク(米国)
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA 米国ペンシルバニア州。
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC、米国。
US_TX_AVI_TAG テキサス州(米国)。
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_FUEGO_TAG テキサス州(米国)。
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, USA.
US_WA_BREEZEBY WA、米国。
US_WA_GOOD_TO_GO WA、米国。
US_WV_EZPASSWV ウェストバージニア州(米国)。
US_WV_MEMORIAL_BRIDGE_TICKETS ウェストバージニア州(米国)。
US_WV_MOV_PASS ウェストバージニア州(米国)
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 RouteTravelMode にのみ適用されます。

ウェイポイント

経由地をカプセル化します。ウェイポイントは、ルートの始点と終点の両方をマークし、ルートに沿った中間地点を含みます。

フィールド
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_type は次のいずれかになります。
location

Location

地理座標を使用して指定されたポイント。オプションの見出しを含む。

place_id

string

経由地に関連付けられている POI プレイス ID。