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 を含めてください。そうしないと、すべてのメッセージに問題がないように見えます。ワイルドカード(*)レスポンス フィールド マスクの使用は、次の理由によりおすすめしません。

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

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

ComputeRouteMatrixRequest

ComputeRouteMatrix リクエスト メッセージ

フィールド
origins[]

RouteMatrixOrigin

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

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

RouteMatrixDestination

必須。デスティネーションの配列。レスポンス マトリックスの列を決定します。

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

departure_time

Timestamp

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

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 の duration フィールドに返される値に影響します。この値には、過去の平均値に基づく予測トラフィックの時間が含まれます。RoutingPreference から TRAFFIC_AWARE_OPTIMALRouteTravelMode から DRIVE に変更しました。トラフィックがリクエストされ、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

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

arrival_time

Timestamp

省略可。到着時刻。注: RouteTravelModeTRANSIT に設定されている場合にのみ設定できます。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 参照ルートの計算では、燃料効率が良いルートを生成するさまざまなパラメータが考慮されます。

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 テキスト文字列として表されます。このコンテンツはそのまま読み取られます。このコンテンツは表示専用です。プログラムで解析しないでください。

ReferenceRoute

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

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

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

結果の型。ゼロ個以上のタイプタグの形式で指定します。サポートされているタイプ: 住所タイプと住所コンポーネントのタイプ

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 形式を使用してポリラインを指定します。

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

ルートを構成する区間(地点間の経路セグメント)の集合。各区間は、via でない 2 つの Waypoints を結ぶルートに対応します。たとえば、中間地点がないルートは区間が 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

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

localized_values

RouteLocalizedValues

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

route_token

string

Navigation SDK に渡すことができるウェブセーフな Base64 エンコードのルートトークン。これにより、Navigation SDK がナビゲーション中にルートを再構築できるようになります。また、ルート変更の際は、ComputeRoutes を呼び出してルートを作成したときに元の意図を尊重できます。お客様はこのトークンを不透明な blob として扱う必要があります。読み取りや変更を目的としたものではありません。注: Route.route_token は、ComputeRoutesRequest.routing_preferenceTRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定されているリクエストでのみ使用できます。Route.route_token は、経由地のあるリクエストではサポートされていません。

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 燃費効率が良いルートです。この値のラベルが付いたルートは、燃料消費量などのエコ パラメータ向けに最適化されていると判断されます。

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

現時点で同じ停車地からの出発間隔を時間として指定します。たとえば、運行間隔の秒数の値を 600 にすると、バスに乗り遅れた場合に 10 分間の待ち時間が予想されます。

transit_line

TransitLine

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

stop_count

int32

出発地から到着駅までの停車地の数。この数には到着駅は含まれますが、出発駅は含まれません。たとえば、停車地 A を出発して停車地 B と C を通過し、停車地 D に到着するルートの場合、stop_count は 3 を返します。

trip_short_text

string

乗客が交通機関のルートを識別するために、時刻表や案内板に表示されるテキスト。このテキストでは、運行日内のルートを一意に識別できる必要があります。たとえば、「538」は、平日の 15:10 にカリフォルニア州サンノゼ発、カリフォルニア州サクラメント行きの Amtrak の 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

トラフィック ゾーンの制限など、1 区間のステップでユーザーに通知する必要がある追加情報が含まれます。

フィールド
toll_info

TollInfo

特定の RouteLeg の有料道路に関する情報が含まれています。このフィールドは、RouteLeg で有料道路が発生すると予想される場合にのみ入力されます。このフィールドが設定されていても、estimated_price サブフィールドにデータが入力されていない場合は、道路に通行料金が含まれていると想定されますが、見積もり料金は不明です。このフィールドが存在しない場合、RouteLeg には有料道路はありません。

speed_reading_intervals[]

SpeedReadingInterval

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

フィールド
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_WHEELERRouteTravelMode にのみ適用されます。

avoid_indoor

bool

true に設定すると、妥当な場合に屋内へのナビゲーションが回避され、屋内ナビゲーションを含まないルートが優先されます。WALK RouteTravelMode にのみ適用されます。

vehicle_info

VehicleInfo

車両情報を指定します。

toll_passes[]

TollPass

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

RouteTravelAdvisory

トラフィック ゾーンの制限など、ユーザーに知らせる必要がある追加情報が含まれます。

フィールド
toll_info

TollInfo

ルート上の有料道路に関する情報を含めます。このフィールドは、経路で有料道路が予想される場合にのみ入力されます。このフィールドが設定されていても、estimatedPrice サブフィールドに値が設定されていない場合、ルートには通行料金が含まれますが、見積もり料金は不明です。このフィールドが設定されていない場合、ルート上では通行料金は発生しません。

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).
fuel_consumption_microliters

int64

予測される燃料消費量(マイクロリットル単位)。

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 リアルタイムの交通状況を考慮せずにルートを計算します。交通状況が重要でない場合や、渋滞条件が該当しない場合に適しています。この値を使用すると、レイテンシが最も低くなります。注: RouteTravelMode DRIVETWO_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

サポートされている世界中の通行証のリスト。

列挙型
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 州のプレート除外。
JP_ETC Japan ETC。通行料金を集める電子無線システム。https://www.go-etc.jp/
JP_ETC2 Japan 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 メキシコの通行証会社メキシコシティで営業している多くの企業のうちの 1 つです。詳しくは、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 アラバマ州、米国
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS (米国、アラスカ州)
US_CA_FASTRAK
US_CA_FASTRAK_CAV_STICKER ドライバーが DMV 発行のクリーンエア ビークル(CAV)ステッカー(https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml)に加えて、FasTrak パスを持っていることを示します。
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 IN、米国
US_KS_BESTPASS_HORIZON KS、USA。
US_KS_KTAG KS、USA。
US_KS_NATIONALPASS KS、USA。
US_KS_PREPASS_ELITEPASS KS、USA。
US_LA_GEAUXPASS
US_LA_TOLL_TAG
US_MA_EZPASSMA 米国マサチューセッツ州、
US_MD_EZPASSMD 医学博士、米国。
US_ME_EZPASSME ME、USA
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 米国ミネソタ州、
US_NC_EZPASSNC
US_NC_PEACH_PASS
US_NC_QUICK_PASS
US_NH_EZPASSNH NH、USA。
US_NJ_DOWNBEACH_EXPRESS_PASS (米国ニュージャージー州)
US_NJ_EZPASSNJ (米国ニュージャージー州)
US_NY_EXPRESSPASS 米国ニューヨーク州
US_NY_EZPASSNY 米国ニューヨーク州
US_OH_EZPASSOH オハイオ州、米国
US_PA_EZPASSPA
US_RI_EZPASSRI
US_SC_PALPASS SC, USA.
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
US_WA_BREEZEBY
US_WA_GOOD_TO_GO
US_WV_EZPASSWV ウェストバージニア州、米国。
US_WV_MEMORIAL_BRIDGE_TICKETS ウェストバージニア州、米国。
US_WV_MOV_PASS ウェストバージニア州、米国
US_WV_NEWELL_TOLL_BRIDGE_TICKET ウェストバージニア州、米国。

TrafficModel

渋滞時間の計算に使用する前提条件を指定します。この設定は、レスポンスの duration フィールドに返される値に影響します。この値には、過去の平均値に基づいて予測されるトラフィック時間が含まれます。

列挙型
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 番街」)。

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

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

address

string

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