Package google.maps.routing.v2

インデックス

ルート

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

  • 必要なフィールドのみを選択すると、サーバーの計算サイクルを節約できるため、レイテンシを短縮して結果を返すことができます。
  • 本番環境ジョブで必要なフィールドのみを選択すると、レイテンシ パフォーマンスが安定します。今後、レスポンス フィールドが追加される可能性があり、その場合、新しいフィールドで追加の計算時間が必要になることがあります。すべてのフィールドを選択した場合、または最上位レベルですべてのフィールドを選択した場合、新しいフィールドがレスポンスに自動的に含まれるため、パフォーマンスが低下する可能性があります。
  • 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットが向上します。
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)でのフィールド マスクの指定を推奨していません。理由は次のとおりです。

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

ComputeRouteMatrixRequest

ComputeRouteMatrix リクエスト メッセージ

フィールド
origins[]

RouteMatrixOrigin

必須。レスポンス マトリックスの行を決定するオリジンの配列。出発地と目的地のカーディナリティには、いくつかのサイズ制限が適用されます。

  • place_id または address として指定された出発地の数と目的地の数の合計は 50 以下にする必要があります。
  • 出発地の数と目的地の数の積は、いずれの場合も 625 以下にする必要があります。
  • routing_preference が TRAFFIC_AWARE_OPTIMAL に設定されている場合、出発地の数と目的地の数の積は 100 以下にする必要があります。
  • travel_mode が TRANSIT に設定されている場合、出発地の数と目的地の数の積は 100 以下でなければなりません。
destinations[]

RouteMatrixDestination

必須。宛先の配列。レスポンス マトリックスの列を決定します。

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

省略可。ルートの計算方法を指定します。サーバーは、選択されたルーティング設定を使用してルートを計算しようとします。ルーティング設定でエラーが発生した場合や、レイテンシが非常に長い場合は、エラーが返されます。このオプションは、travel_modeDRIVE または TWO_WHEELER の場合にのみ指定できます。それ以外の場合、リクエストは失敗します。

departure_time

Timestamp

省略可。出発時刻。この値を設定しない場合、この値はデフォルトでリクエストを行った時刻になります。注: RouteTravelModeTRANSIT に設定されている場合にのみ、過去の departure_time を指定できます。

arrival_time

Timestamp

省略可。到着時刻。注: RouteTravelModeTRANSIT に設定されている場合にのみ設定できます。departure_time または arrival_time のどちらか一方だけ指定できます。

language_code

string

省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、Unicode ロケール識別子をご覧ください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合、表示言語は最初のオリジンの場所から推測されます。

region_code

string

省略可。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定される地域コード。詳しくは、国コード トップレベル ドメインをご覧ください。

units

Units

省略可。表示フィールドの測定単位を指定します。

extra_computations[]

ExtraComputation

省略可。リクエストの完了に使用できる追加の計算のリスト。注: これらの追加計算により、レスポンスに追加のフィールドが返されることがあります。これらの追加フィールドは、レスポンスで返されるフィールド マスクでも指定する必要があります。

traffic_model

TrafficModel

省略可。交通状況での所要時間を計算するときに使用する仮定を指定します。この設定に応じて、RouteMatrixElement の所要時間フィールドに返される値が変わります。この値は、過去の平均データに基づく予測所要時間となります。TrafficModel は、RoutingPreferenceTRAFFIC_AWARE_OPTIMAL に、RouteTravelModeDRIVE に設定したリクエストでのみ使用できます。交通状況がリクエストされ、TrafficModel が指定されていない場合、デフォルトは BEST_GUESS です。

transit_preferences

TransitPreferences

省略可。TRANSIT ルートで返されるルートに影響する設定を指定します。注: transit_preferences は、RouteTravelModeTRANSIT に設定されている場合にのみ指定できます。

ExtraComputation

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

列挙型
EXTRA_COMPUTATION_UNSPECIFIED 使用されません。この値を含むリクエストは失敗します。
TOLLS マトリックス要素の通行料金情報。

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

省略可。出発時刻。この値を設定しない場合、この値はデフォルトでリクエストを行った時刻になります。注: RouteTravelModeTRANSIT に設定されている場合にのみ、過去の departure_time を指定できます。公共交通機関のルートは、過去 7 日間または未来 100 日間まで利用できます。

arrival_time

Timestamp

省略可。到着時刻。注: リクエストで TRANSIT 以外の RouteTravelMode が指定されている場合、このフィールドは無視されます。departure_time または arrival_time のどちらか一方を指定できますが、両方は指定できません。公共交通機関のルートは、過去 7 日間または未来 100 日間まで利用できます。

compute_alternative_routes

bool

省略可。ルートに加えて代替ルートを計算するかどうかを指定します。中間地点があるリクエストに対して代替ルートは返されません。

route_modifiers

RouteModifiers

省略可。ルートの計算方法に影響する条件のセット。

language_code

string

省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、Unicode ロケール識別子をご覧ください。サポートされている言語の一覧については、言語サポートをご覧ください。この値を指定しない場合、表示言語はルート リクエストの場所から推測されます。

region_code

string

省略可。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定される地域コード。詳しくは、国コード トップレベル ドメインをご覧ください。

units

Units

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

optimize_waypoint_order

bool

省略可。true に設定すると、サービスは指定された中間経由地を並べ替えて、ルートの全体的な費用を最小限に抑えようとします。中間地点のいずれかが via 地点の場合、リクエストは失敗します。ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index を使用して新しい順序を見つけます。X-Goog-FieldMask ヘッダーで ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index がリクエストされていない場合、リクエストは失敗します。optimize_waypoint_order が false に設定されている場合、ComputeRoutesResponse.optimized_intermediate_waypoint_index は空になります。

requested_reference_routes[]

ReferenceRoute

省略可。デフォルトのルートに加えて、リクエストの一部として計算する参照ルートを指定します。参照ルートは、デフォルト ルートとは異なるルート計算目標を持つルートです。たとえば、FUEL_EFFICIENT 基準ルートの計算では、最適な燃費効率のルートを生成するさまざまなパラメータが考慮されます。この機能を使用する場合は、結果のルートに route_labels が表示されていることを確認してください。

extra_computations[]

ExtraComputation

省略可。リクエストの完了に使用できる追加の計算のリスト。注: これらの追加計算により、レスポンスに追加のフィールドが返されることがあります。これらの追加フィールドは、レスポンスで返されるフィールド マスクでも指定する必要があります。

traffic_model

TrafficModel

省略可。交通状況での所要時間を計算するときに使用する仮定を指定します。この設定に応じて、RouteRouteLeg の所要時間フィールドに返される値が変わります。この値は、過去の平均データに基づく予測所要時間となります。TrafficModel は、RoutingPreferenceTRAFFIC_AWARE_OPTIMAL に、RouteTravelModeDRIVE に設定したリクエストでのみ使用できます。交通状況がリクエストされ、TrafficModel が指定されていない場合、デフォルトは BEST_GUESS です。

transit_preferences

TransitPreferences

省略可。TRANSIT ルートで返されるルートに影響する設定を指定します。注: transit_preferences は、RouteTravelModeTRANSIT に設定されている場合にのみ指定できます。

ExtraComputation

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

列挙型
EXTRA_COMPUTATION_UNSPECIFIED 使用されません。この値を含むリクエストは失敗します。
TOLLS ルートの有料道路情報。
FUEL_CONSUMPTION ルートの推定燃料消費量。
TRAFFIC_ON_POLYLINE ルートの交通状況を考慮したポリライン。
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions は、書式設定された HTML テキスト文字列として表示されます。このコンテンツはそのまま読み取られます。このコンテンツは表示専用です。プログラムで解析しないでください。
FLYOVER_INFO_ON_POLYLINE ルートのフライオーバー情報。この情報を返すには、routes.polyline_details.flyover_info フィールド マスクを指定する必要があります。現在、このデータはインドの一部の都市圏でのみ入力されます。この機能は試験運用版であり、SKU と料金は変更される可能性があります。
NARROW_ROAD_INFO_ON_POLYLINE ルートの狭い道路の情報。この情報を返すには、routes.polyline_details.narrow_road_info フィールド マスクを指定する必要があります。現在、このデータはインドの一部の都市圏でのみ入力されます。この機能は試験運用版であり、SKU と料金は変更される可能性があります。

ReferenceRoute

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

列挙型
REFERENCE_ROUTE_UNSPECIFIED 使用されません。この値を含むリクエストは失敗します。
FUEL_EFFICIENT 燃料効率が良いルート。
SHORTER_DISTANCE

移動距離が短いルート。この機能は試験運用中です。

DRIVE リクエストの場合、この機能は運転の快適さよりも距離の短さを優先します。たとえば、高速道路ではなく一般道路を優先したり、未舗装道路を通ったり、駐車場を横切ったりします。この機能では、Google マップで違法と認識されている操作は返されません。

BICYCLE リクエストと TWO_WHEELER リクエストの場合、この機能は requested_reference_routes を指定しない場合に返されるルートと同様のルートを返します。

この機能は、他の移動手段、中間地点、optimize_waypoint_order と互換性がありません。このようなリクエストは失敗します。ただし、任意の routing_preference と併用できます。

ComputeRoutesResponse

ComputeRoutes のレスポンス メッセージ。

フィールド
routes[]

Route

compute_alternatives_routes を指定した場合は、計算されたルートの配列(最大 3 つ)が含まれます。指定しなかった場合は、1 つのルートのみが含まれます。この配列に複数のエントリが含まれている場合、最初のエントリが最もおすすめのルートです。配列が空の場合、ルートが見つからなかったことを意味します。

fallback_info

FallbackInfo

サーバーがすべての入力設定を使用してルート結果を計算できない場合、別の計算方法にフォールバックすることがあります。フォールバック モードが使用されている場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合、このフィールドは設定されません。

geocoding_results

GeocodingResults

住所として指定された地点のジオコーディング レスポンス情報が含まれます。

FallbackInfo

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

フィールド
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

元のレスポンスの代わりにフォールバック レスポンスが使用された理由。このフィールドにデータが入力されるのは、フォールバック モードがトリガーされ、フォールバック レスポンスが返された場合のみです。

FallbackReason

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

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

FallbackRoutingMode

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

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

GeocodedWaypoint

経由地として使用される場所に関する詳細。住所の経由地の場合のみ、値が入力されます。住所がジオコーディングされた対象を特定するためのジオコーディング結果の詳細が含まれます。

フィールド
geocoder_status

Status

ジオコーディングの処理結果を示すステータス コード。

type[]

string

結果のタイプ(0 個以上のタイプタグの形式)。サポートされているタイプ: 住所のタイプと住所コンポーネントのタイプ

partial_match

bool

ジオコーダによって、元のリクエストに完全一致する住所は見つからなかったものの、部分一致する住所は見つかったことを示します。元のリクエストで住所の表記が間違っていたり、不完全である可能性があります。

place_id

string

この結果のプレイス ID。

intermediate_waypoint_request_index

int32

リクエスト内の対応する中間経由地のインデックス。対応する経由地が中間経由地の場合にのみ入力されます。

GeocodingResults

出発地、目的地、中間地点の GeocodedWaypoints が含まれます。住所の経由地の場合のみ、値が入力されます。

フィールド
origin

GeocodedWaypoint

出発地のジオコーディングされた経由地点。

destination

GeocodedWaypoint

目的地のジオコーディングされた経由地点。

intermediates[]

GeocodedWaypoint

中間ジオコード地点のリスト。各地点には、リクエストで指定された順序での地点の 0 から始まる位置に対応するインデックス フィールドが含まれています。

LocalizedTime

時間のローカライズされた説明。

フィールド
time

LocalizedText

指定されたタイムゾーンで文字列として指定された時刻。

time_zone

string

タイムゾーンが含まれます。この値は、IANA タイムゾーン データベースで定義されたタイムゾーンの名前です(例: America/New_York)。

場所

位置情報(地理的なポイントと、オプションの向き)をカプセル化します。

フィールド
lat_lng

LatLng

経由地の地理座標。

heading

Int32Value

交通の流れの方向に関連付けられたコンパス方位。この値は、乗車と降車の道路の側を指定します。見出しの値は 0 ~ 360 で、0 は真北、90 は真東などを指定します。このフィールドは、DRIVETWO_WHEELER RouteTravelMode でのみ使用できます。

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 道路名の変更を示すために使用されます。

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

フィールド
maneuver

Maneuver

現在のステップのナビゲーション手順(左折、合流、直進など)をカプセル化します。このフィールドは、表示するアイコンを決定します。

instructions

string

このステップをナビゲートする手順。

ポリライン

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

フィールド
共用体フィールド polyline_type。ポリラインのタイプをカプセル化します。デフォルトは encoded_polyline です。polyline_type は次のいずれかになります。
encoded_polyline

string

ポリライン エンコード アルゴリズムを使用したポリラインの文字列エンコード

geo_json_linestring

Struct

GeoJSON LineString 形式を使用してポリラインを指定します。

PolylineDetails

ポリラインの特定のインデックスまたは連続するセグメントに対応する詳細。ポイント P_0、P_1、...、P_N(ゼロベースのインデックス)を含むポリラインが指定されている場合、PolylineDetails は間隔と関連するメタデータを定義します。

フィールド
flyover_info[]

FlyoverInfo

ポリラインに沿った高架の詳細。

narrow_road_info[]

NarrowRoadInfo

ポリラインに沿った狭い道路の詳細。

FlyoverInfo

ポリラインに沿ったフライオーバーに関する情報をカプセル化します。

フィールド
flyover_presence

RoadFeatureState

出力専用。ポリラインの特定の区間にフライオーバーが存在するかどうかを示します。

polyline_point_index

PolylinePointIndex

ポリラインに沿った高架関連情報の位置。

NarrowRoadInfo

ポリラインに沿った狭い道路に関する情報をカプセル化します。

フィールド
narrow_road_presence

RoadFeatureState

出力専用。ポリラインの特定の区間に狭い道路が存在するかどうかを示します。

polyline_point_index

PolylinePointIndex

ポリラインに沿った狭い道路関連情報の場所。

PolylinePointIndex

ポリラインの詳細の開始インデックスと終了インデックスをカプセル化します。データが単一のポイントに対応するインスタンスの場合、start_indexend_index は等しくなります。

フィールド
start_index

int32

ポリライン内のこの詳細の開始インデックス。

end_index

int32

ポリライン内のこの詳細の終了インデックス。

RoadFeatureState

ポリラインの区間に沿った道路フィーチャーの状態をカプセル化します。

列挙型
ROAD_FEATURE_STATE_UNSPECIFIED 道路の特徴の状態が計算されませんでした(デフォルト値)。
EXISTS 道路フィーチャーが存在する。
DOES_NOT_EXIST 道路の地物が存在しません。

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_labels[]

RouteLabel

他のルートと比較する際に、ルートの特定のプロパティを識別するのに役立つ Route のラベル。

legs[]

RouteLeg

ルートを構成する区間(経由地間の経路セグメント)のコレクション。各レグは、2 つの非 via Waypoints 間の旅行に対応します。たとえば、中間地点のないルートには 1 つのレッグしかありません。via 以外の 1 つの中間地点を含むルートには 2 つの区間があります。1 つの via 中間地点を含むルートには 1 つの区間があります。ルートの順序は、origin から intermediatesdestination への経由地の順序と一致します。

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

optimize_waypoint_order を true に設定すると、このフィールドには中間経由地の最適化された順序が含まれます。それ以外の場合、このフィールドは空です。たとえば、出発地: ロサンゼルス、中間地点: ダラス、バンガー、フェニックス、目的地: ニューヨークという入力があり、最適化された中間地点の順序がフェニックス、ダラス、バンガーの場合、このフィールドには値 [2, 0, 1] が含まれます。インデックスは、入力で指定された最初の中間経由地に対して 0 から始まります。

localized_values

RouteLocalizedValues

Route のプロパティのテキスト表現。

route_token

string

ナビゲーション中にルートを再構築し、ルートが作成されたときにリルートが発生した場合に元の意図を尊重するために Navigation SDK に渡すことができる不透明なトークン。このトークンは不透明な blob として扱います。サービスがまったく同じルートを返した場合でも、値が変更される可能性があるため、リクエスト間で値を比較しないでください。

注: Route.route_token は、ComputeRoutesRequest.routing_preferenceTRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定したリクエストでのみ使用できます。Route.route_token は、経由地を含むリクエストではサポートされていません。

polyline_details

PolylineDetails

ポリラインに沿った詳細情報が含まれます。

RouteLocalizedValues

特定のプロパティのテキスト表現。

フィールド
distance

LocalizedText

移動距離をテキスト形式で表します。

duration

LocalizedText

期間。テキスト形式で表され、クエリの地域にローカライズされます。交通状況を考慮します。注: 交通情報をリクエストしていない場合、この値は static_duration と同じ値になります。

static_duration

LocalizedText

交通状況を考慮しない所要時間(テキスト形式)。

transit_fare

LocalizedText

交通機関の運賃をテキスト形式で表します。

RouteLabel

他のルートと比較する際に、ルートの特定のプロパティを識別するのに役立つ Route のラベル。

列挙型
ROUTE_LABEL_UNSPECIFIED デフォルト - 使用されません。
DEFAULT_ROUTE ルート計算で返されるデフォルトの「最適」ルート。
DEFAULT_ROUTE_ALTERNATE デフォルトの「最適」なルートの代替ルート。このようなルートは、compute_alternative_routes が指定されている場合に返されます。
FUEL_EFFICIENT 燃料効率が良いルート。この値でラベル付けされたルートは、燃料消費量などのエコ パラメータに最適化されていると判断されます。
SHORTER_DISTANCE 移動距離が短いルート。この機能は試験運用中です。

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

ルート区間における交通規制の可能性など、ユーザーに通知する必要がある追加情報が含まれます。

localized_values

RouteLegLocalizedValues

RouteLeg のプロパティのテキスト表現。

steps_overview

StepsOverview

この RouteLeg のステップに関する概要情報。このフィールドは、TRANSIT ルートの場合にのみ入力されます。

RouteLegLocalizedValues

特定のプロパティのテキスト表現。

フィールド
distance

LocalizedText

移動距離をテキスト形式で表します。

duration

LocalizedText

期間。テキスト形式で表され、クエリの地域にローカライズされます。交通状況を考慮します。注: 交通情報をリクエストしていない場合、この値は static_duration と同じ値になります。

static_duration

LocalizedText

交通状況を考慮しない所要時間(テキスト形式)。

StepsOverview

RouteLegStep のリストに関する概要情報を提供します。

フィールド
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps のさまざまなマルチモーダル セグメントに関する要約情報。RouteLeg のステップにマルチモーダル セグメントが含まれていない場合、このフィールドは入力されません。

MultiModalSegment

RouteLeg.steps のさまざまなマルチモーダル セグメントに関する要約情報を提供します。マルチモーダル セグメントは、同じ RouteTravelMode を持つ 1 つ以上の連続した RouteLegStep として定義されます。RouteLeg のステップにマルチモーダル セグメントが含まれていない場合、このフィールドは入力されません。

フィールド
navigation_instruction

NavigationInstruction

マルチモーダル セグメントの NavigationInstruction。

travel_mode

RouteTravelMode

マルチモーダル セグメントの移動手段。

step_start_index

int32

マルチモーダル セグメントの開始位置に対応する RouteLegStep インデックス。

step_end_index

int32

マルチモーダル セグメントの末尾にある対応する RouteLegStep インデックス。

RouteLegStep

RouteLeg のセグメントが含まれます。ステップは 1 つのナビゲーション手順に対応します。ルートの区間はステップで構成されます。

フィールド
distance_meters

int32

このステップの移動距離(メートル単位)。状況によっては、このフィールドに値がない場合があります。

static_duration

Duration

交通状況を考慮せずにこのステップを通過する所要時間。状況によっては、このフィールドに値がない場合があります。

polyline

Polyline

このステップに関連付けられたポリライン。

start_location

Location

このステップの開始位置。

end_location

Location

このステップの終了位置。

navigation_instruction

NavigationInstruction

ナビゲーションの指示。

travel_advisory

RouteLegStepTravelAdvisory

区間ステップで、考えられる交通ゾーンの制限など、ユーザーに通知する必要がある追加情報が含まれます。

localized_values

RouteLegStepLocalizedValues

RouteLegStep のプロパティのテキスト表現。

transit_details

RouteLegStepTransitDetails

移動手段が TRANSIT の場合、このステップに関する詳細。

travel_mode

RouteTravelMode

このステップで使用される移動手段。

RouteLegStepLocalizedValues

特定のプロパティのテキスト表現。

フィールド
distance

LocalizedText

移動距離をテキスト形式で表します。

static_duration

LocalizedText

交通状況を考慮しない所要時間(テキスト形式)。

RouteLegStepTransitDetails

TRANSIT ルートに関連する RouteLegStep の追加情報。

フィールド
stop_details

TransitStopDetails

ステップの到着停車地と出発停車地に関する情報。

localized_values

TransitDetailsLocalizedValues

RouteLegStepTransitDetails のプロパティのテキスト表現。

headsign

string

車両または出発駅に示されている、この路線を進む方向を指定します。多くの場合、この行先は終点に相当します。

headway

Duration

同じ場所における現時点での推定出発間隔を指定します。たとえば、headway seconds 値が 600 の場合、バスを逃すと 10 分待つことになると予想されます。

transit_line

TransitLine

このステップで使用される交通機関の路線に関する情報。

stop_count

int32

出発地から到着地までの停車地の数。このカウントには到着停車地が含まれますが、出発停車地は含まれません。たとえば、停車地 A から出発して、停車地 B と C を経由し、停車地 D に到着するルートの場合、

stop_count

3 を返します。

trip_short_text

string

乗客が公共交通機関の旅程を識別できるよう時刻表と行先表示に使用されるテキスト。このテキストは、運行日の特定の旅程を一意に識別できるような値である必要があります。たとえば、「538」は、平日の 15 時 10 分にカリフォルニア州サンノゼを出発し、カリフォルニア州サクラメントに向かうアムトラックの列車の trip_short_text です。

TransitDetailsLocalizedValues

RouteTransitDetails の値のローカライズされた説明。

フィールド
arrival_time

LocalizedTime

対応するタイムゾーンを含む、フォーマットされたテキスト表現の時刻。

departure_time

LocalizedTime

対応するタイムゾーンを含む、フォーマットされたテキスト表現の時刻。

TransitStopDetails

RouteLegStep の交通機関の停留所に関する詳細。

フィールド
arrival_stop

TransitStop

ステップの到着停留所に関する情報。

arrival_time

Timestamp

ステップの到着予定時刻。

departure_stop

TransitStop

ステップの出発停留所に関する情報。

departure_time

Timestamp

ステップの出発予定時刻。

RouteLegStepTravelAdvisory

ユーザーに通知する必要がある追加情報(ルートのステップで考えられる交通ゾーンの制限など)が含まれます。

フィールド
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

交通規制の可能性など、ユーザーに伝えるべき区間ステップに関する追加情報が含まれます。

フィールド
toll_info

TollInfo

特定の RouteLeg の通行料金に関する情報が含まれています。このフィールドは、RouteLeg に有料道路があり、リクエストの ComputeRoutesRequest.extra_computationsTOLLS が含まれている場合にのみ入力されます。このフィールドが設定されていても estimated_price サブフィールドが入力されていない場合、道路には通行料金が含まれているが、推定価格は不明であると想定されます。toll_info が存在しない場合、RouteLeg に料金は発生しません。

speed_reading_intervals[]

SpeedReadingInterval

トラフィック密度を示す高速道路の区間。このフィールドは、リクエストに TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMALComputeRoutesRequest.routing_preference 値があり、TRAFFIC_ON_POLYLINEComputeRoutesRequest.extra_computations に含まれている場合にのみ、リクエストに入力されます。間隔は、重複することなく 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 はクライアントにストリーミングできます。

フィールド
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

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

localized_values

LocalizedValues

RouteMatrixElement のプロパティのテキスト表現。

origin_index

int32

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

destination_index

int32

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

LocalizedValues

特定のプロパティのテキスト表現。

フィールド
distance

LocalizedText

移動距離をテキスト形式で表します。

duration

LocalizedText

交通状況を考慮した所要時間をテキスト形式で表します。注: 交通情報がリクエストされていない場合、この値は static_duration と同じ値になります。

static_duration

LocalizedText

交通状況を考慮せずにテキスト形式で表された所要時間。

transit_fare

LocalizedText

交通機関の運賃をテキスト形式で表します。

RouteMatrixElementCondition

返されるルートの状態。

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

RouteMatrixOrigin

ComputeRouteMatrixRequest の単一の出発地

フィールド
waypoint

Waypoint

必須。出発地点

route_modifiers

RouteModifiers

省略可。これを起点とするすべてのルートの修飾子

RouteModifiers

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

フィールド
avoid_tolls

bool

true に設定すると、有料道路を避けることが可能な場合は、有料道路を含まないルートを優先します。DRIVETWO_WHEELER RouteTravelMode にのみ適用されます。

avoid_highways

bool

true に設定すると、高速道路を回避できる場合は回避し、高速道路を含まないルートを優先します。DRIVETWO_WHEELER RouteTravelMode にのみ適用されます。

avoid_ferries

bool

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

avoid_indoor

bool

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

vehicle_info

VehicleInfo

車両情報を指定します。

toll_passes[]

TollPass

有料道路パスに関する情報をカプセル化します。有料道路のパスが提供されている場合、API はパスの料金を返そうとします。有料道路パスが指定されていない場合、API は有料道路パスを不明として扱い、現金価格を返そうとします。DRIVETWO_WHEELER RouteTravelMode にのみ適用されます。

RouteTravelAdvisory

交通規制の可能性など、ユーザーに通知する必要がある追加情報が含まれます。

フィールド
toll_info

TollInfo

ルートの有料道路に関する情報が含まれます。このフィールドは、ルートに有料道路が含まれており、リクエストの ComputeRoutesRequest.extra_computationsTOLLS が含まれている場合にのみ入力されます。このフィールドが設定されていても、estimatedPrice サブフィールドが入力されていない場合、ルートには有料道路が含まれますが、推定料金は不明です。toll_info が設定されていない場合、ルートに通行料金は発生しません。

speed_reading_intervals[]

SpeedReadingInterval

トラフィック密度を示す高速道路の区間。このフィールドは、リクエストに TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMALComputeRoutesRequest.routing_preference 値があり、TRAFFIC_ON_POLYLINEComputeRoutesRequest.extra_computations に含まれている場合にのみ、リクエストに入力されます。間隔は、重複することなくルートのポリライン全体をカバーします。指定された間隔の開始ポイントは、前の間隔の終了ポイントと同じです。

例:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

予測された燃料消費量(マイクロリットル単位)。このフィールドは、リクエストの ComputeRoutesRequest.extra_computationsFUEL_CONSUMPTION が含まれている場合にのみ入力されます。

route_restrictions_partially_ignored

bool

返されたルートには、リクエストされた移動手段やルート修飾子に適さない制限が含まれている可能性があります。

transit_fare

Money

このルートの合計運賃または切符の合計金額が含まれます。このプロパティは、TRANSIT リクエストにおいて、すべての交通機関のステップで運賃情報が取得できる場合にのみ返されます。

RouteTravelMode

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

列挙型
TRAVEL_MODE_UNSPECIFIED 移動手段が指定されていません。デフォルトは DRIVE です。
DRIVE 乗用車で移動します。
BICYCLE 自転車で移動します。
WALK 徒歩で移動します。
TWO_WHEELER 二輪の原動機付自転車。(オートバイなど)。これは、人力モードを対象とする BICYCLE 交通手段とは異なります。
TRANSIT 公共交通機関のルートを利用できる場合は、そのルートで移動します。

RoutingPreference

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

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

SpeedReadingInterval

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

フィールド
start_polyline_point_index

int32

ポリライン内のこの間隔の開始インデックス。

end_polyline_point_index

int32

ポリライン内のこの間隔の終了インデックス。

共用体フィールド speed_type。このインターバルの速度のタイプ。speed_type は次のいずれかになります。
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 シドニーの ETC カード。詳しくは、https://www.myetoll.com.au をご覧ください。
AU_EWAY_TAG シドニーの ETC カード。詳しくは、https://www.tollpay.com.au をご覧ください。
AU_LINKT オーストラリア全土で利用できる ETC カード。詳しくは、https://www.linkt.com.au/ をご覧ください。
AR_TELEPASE アルゼンチンの ETC。詳しくは、https://telepase.com.ar をご覧ください。
BR_AUTO_EXPRESO ブラジルの ETC。詳しくは、https://www.autoexpreso.com をご覧ください。
BR_CONECTCAR ブラジルの ETC。詳しくは、https://conectcar.com をご覧ください。
BR_MOVE_MAIS ブラジルの ETC。詳しくは、https://movemais.com をご覧ください。
BR_PASSA_RAPIDO ブラジルの ETC。詳しくは、https://pasorapido.gob.do/ をご覧ください。
BR_SEM_PARAR ブラジルの ETC。詳しくは、https://www.semparar.com.br をご覧ください。
BR_TAGGY ブラジルの ETC。詳しくは、https://taggy.com.br をご覧ください。
BR_VELOE ブラジルの ETC。詳しくは、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 メキシコの ETC 会社。メキシコシティで営業している多くの企業の 1 つです。詳しくは、https://www.televia.com.mx をご覧ください。
MX_TELEVIA メキシコの ETC 会社。メキシコシティで運営されている多くの企業の 1 つ。https://www.televia.com.mx
MX_VIAPASS メキシコの ETC カード。詳しくは、https://www.viapass.com.mx/viapass/web_home.aspx をご覧ください。
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
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, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN、USA。
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, USA.
US_ME_EZPASSME ME、米国。
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. このパスタイプは存在しなくなったため、非推奨になりました。

US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
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 NJ, USA.
US_NJ_EZPASSNJ NJ, USA.
US_NY_EXPRESSPASS ニューヨーク州(米国)。
US_NY_EZPASSNY ニューヨーク州(米国)。
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
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 ワシントン州(米国)。
US_WA_GOOD_TO_GO ワシントン州(米国)。
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS ウェストバージニア州(米国)
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

このフィールドでは、交通状況での移動時間を計算する際に使用する次のいずれかの仮定を指定します。以下の列挙型で示されています。選択した列挙型に応じて、TrafficModel レスポンスの duration フィールドが異なります。この値は、過去の平均データに基づく予測所要時間となります。TrafficModel は、RoutingPreferenceTRAFFIC_AWARE_OPTIMAL に、RouteTravelModeDRIVE に設定したリクエストでのみ使用できます。

列挙型
TRAFFIC_MODEL_UNSPECIFIED 未使用。指定した場合、デフォルトで BEST_GUESS になります。
BEST_GUESS 過去と現在の交通状況のデータを基に見積もった最適な移動時間を、duration で返すよう指定します。departure_time が現在時刻に近いほど、現在の交通状況が重視されます。
PESSIMISTIC 普段の実際の移動時間よりも大きい値を返すよう指定します。ただし、交通状況が極端に悪い場合は、この値よりも長い時間を要する可能性があります。
OPTIMISTIC 普段の実際の移動時間よりも小さい値を返すよう指定します。ただし、交通状況が非常に良い場合は、この値よりも短時間で到着する可能性があります。

TransitAgency

交通機関の路線を運営する交通機関。

フィールド
name

string

この交通機関の名前。

phone_number

string

交通機関の言語 / 地域固有の形式の電話番号。

uri

string

交通機関の URI。

TransitLine

このステップで使用される交通機関の路線に関する情報が含まれます。

フィールド
agencies[]

TransitAgency

この交通機関の路線を運行する交通機関。

name

string

この路線の正式名称(例: 「8 Avenue Local」)。

uri

string

交通機関運営者が提供している、この交通機関の路線の URI。

color

string

この路線の表記に一般的に使用される色。16 進数で表されます。

icon_uri

string

この路線に関連付けられたアイコンの URI。

name_short

string

この路線の略称。通常、この名前は「M7」や「355」などの路線番号になります。

text_color

string

この路線の表記に通常使用されるテキストの色。16 進数で表されます。

vehicle

TransitVehicle

この交通機関の路線で運行されている車両のタイプ。

TransitPreferences

返されるルートに影響する TRANSIT ベースのルートの設定。

フィールド
allowed_travel_modes[]

TransitTravelMode

TRANSIT ルートを取得するときに使用する移動手段のセット。デフォルトでは、サポートされているすべての移動手段が対象となります。

routing_preference

TransitRoutingPreference

指定すると、返される TRANSIT ルートに影響するルート設定。

TransitRoutingPreference

交通機関のルートのルート設定を指定します。

列挙型
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED 設定が指定されていません。
LESS_WALKING 歩行距離に制限を付けてルートを計算するよう指定します。
FEWER_TRANSFERS 乗り換え回数に制限を付けてルートを計算するよう指定します。

TransitTravelMode

交通手段のモードを指定するために使用される値のセット。

列挙型
TRANSIT_TRAVEL_MODE_UNSPECIFIED 公共交通機関の移動手段が指定されていません。
BUS バスで移動します。
SUBWAY 地下鉄で移動します。
TRAIN 電車で移動します。
LIGHT_RAIL ライトレールまたは路面電車で移動します。
RAIL 鉄道での移動。これは、SUBWAYTRAINLIGHT_RAIL の組み合わせと同じです。

TransitStop

交通機関の停留所に関する情報。

フィールド
name

string

交通機関の停留所の名前。

location

Location

停留所の位置を緯度と経度の座標で表します。

TransitVehicle

交通機関のルートで使用される車両に関する情報。

フィールド
name

LocalizedText

この車両の名前(大文字)。

type

TransitVehicleType

使用された車両の種類。

icon_uri

string

この車両タイプに関連付けられたアイコンの URI。

local_icon_uri

string

地域の交通標識に基づき、乗り物の種別に関連付けられたアイコンの URI。

TransitVehicleType

公共交通機関のルートの車両の種類。

列挙型
TRANSIT_VEHICLE_TYPE_UNSPECIFIED 未使用。
BUS バス。
CABLE_CAR ケーブルによって、通常は地上を走る車両。空中ケーブルカーは、タイプ GONDOLA_LIFT に入ることもあります。
COMMUTER_TRAIN 通勤列車。
FERRY フェリー。
FUNICULAR 険しい斜面をケーブルで引っ張る乗り物。ケーブルカーは一般的に 2 両編成で、車両は互いに重量のバランスを取ります。
GONDOLA_LIFT 空中ケーブルカー。
HEAVY_RAIL ヘビーレール。
HIGH_SPEED_TRAIN 高速列車。
INTERCITY_BUS 長距離バス。
LONG_DISTANCE_TRAIN 長距離列車。
METRO_RAIL ライトレール トランジット。
MONORAIL モノレール。
OTHER その他のすべての車両。
RAIL 鉄道。
SHARE_TAXI 乗合タクシーは、ルート上のどこでも乗客が乗り降りできるバスの一種です。
SUBWAY 地下を走るライトレール。
TRAM 地上を走るライトレール。
TROLLEYBUS トロリーバス。

単位

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

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

VehicleEmissionType

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

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

VehicleInfo

車両の排出タイプなど、車両に関する情報が含まれます。

フィールド
emission_type

VehicleEmissionType

車両の排出タイプを表します。DRIVE RouteTravelMode にのみ適用されます。

ウェイポイント

経由地をカプセル化します。ウェイポイントは、ルートの始点と終点の両方をマークし、ルート上の途中停車地点を含みます。

フィールド
via

bool

このウェイポイントを停車地点ではなくマイルストーンとしてマークします。リクエスト内の経由地以外の各経由地について、レスポンスは legs 配列にエントリを追加して、ルートのその区間の乗り換えの詳細を提供します。ルートがこの経由地を通過して停止しないようにする場合は、この値を true に設定します。経由地点を指定しても、legs 配列にエントリは追加されませんが、経由地点を通るルートが設定されます。この値は、中間地点である経由地でのみ設定できます。このフィールドを終点に設定すると、リクエストは失敗します。ComputeRoutesRequest.optimize_waypoint_order が true に設定されている場合、このフィールドを true に設定することはできません。設定すると、リクエストは失敗します。

vehicle_stopover

bool

ウェイポイントが車両の停車を目的としており、乗車または降車を目的としていることを示します。この値を設定すると、計算されたルートには、乗車と降車に適さない道路上の via 以外のウェイポイントは含まれません。このオプションは、DRIVETWO_WHEELER の移動手段で、location_typeLocation の場合にのみ機能します。

side_of_road

bool

このウェイポイントの位置で、車両を優先的に道路の特定の側に停車することを指示します。この値を設定すると、ルートは位置情報を通過し、車両は道路の中央から位置情報が偏っている側の道路脇に停車できるようになります。このオプションは、DRIVETWO_WHEELER RouteTravelMode でのみ機能します。

共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
location

Location

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

place_id

string

経由地に関連付けられた POI のプレイス ID。

address

string

人が読める形式の住所または Plus Code。詳しくは https://plus.codes をご覧ください。