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 をフィールド マスクに含めることが重要です。ワイルドカード レスポンス フィールド マスクの使用はおすすめしません。理由は次のとおりです。*

  • 必要なフィールドのみを選択することで、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)でのフィールド マスクの指定をおすすめしません。理由は次のとおりです。

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

ComputeRouteMatrixRequest

ComputeRouteMatrix リクエスト メッセージ

フィールド
origins[]

RouteMatrixOrigin

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

  • 出発地の数 + place_id または address として指定された目的地の数の合計は、50 以下にする必要があります。
  • 出発地の数 × 目的地の数の積は 625 以下にする必要があります。
  • route_preference が TRAFFIC_AWARE_OPTIMAL に設定されている場合、出発地の数 × 目的地の数の積が 100 以下である必要があります。
  • travel_mode が TRANSIT に設定されている場合、出発地の数 x 目的地の数の積は 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 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語のサポートをご覧ください。この値を指定しない場合、表示言語は最初のオリジンの場所から推定されます。

region_code

string

(省略可)地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値で指定します。詳しくは、https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains をご覧ください。

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

(省略可)所要時間を計算する上での仮定条件を指定します。この設定は、RouteMatrixElement の duration フィールドに返される値に影響します。過去の平均値に基づいて予測されるトラフィックの時間が含まれます。RoutingPreferenceTRAFFIC_AWARE_OPTIMALRouteTravelModeDRIVEトラフィックがリクエストされ、TrafficModel が指定されていない場合、デフォルトは BEST_GUESS になります。

transit_preferences

TransitPreferences

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

外計算

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

列挙型
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 を指定できます。

arrival_time

Timestamp

(省略可)到着時刻。注: RouteTravelModeTRANSIT に設定されている場合にのみ設定できます。departure_time または arrival_time のいずれかを指定できます。両方を指定することはできません。

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

(省略可)ルートの計算方法に影響する一連の条件。

language_code

string

(省略可)「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語のサポートをご覧ください。この値を指定しない場合、ルート リクエストの位置から表示言語が推測されます。

region_code

string

(省略可)地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値で指定します。詳しくは、https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains をご覧ください。

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 の duration フィールドに返される値(過去の平均に基づくトラフィックの予測時間を含む)に影響します。TrafficModel は、RoutingPreferenceTRAFFIC_AWARE_OPTIMAL に、RouteTravelModeDRIVE に設定したリクエストでのみ使用できます。トラフィックがリクエストされ、TrafficModel が指定されていない場合、デフォルトは BEST_GUESS になります。

transit_preferences

TransitPreferences

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

外計算

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

列挙型
EXTRA_COMPUTATION_UNSPECIFIED 使用されません。 この値を含むリクエストは失敗します。
TOLLS ルートの料金情報。
FUEL_CONSUMPTION ルートの推定燃料消費量。
TRAFFIC_ON_POLYLINE ルートの交通状況を認識するポリライン
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS ナビゲーション手順は、書式設定された HTML テキスト文字列で表されます。このコンテンツはそのまま読み取られます。これは表示専用です。プログラムで解析しないでください。

ReferenceRoute

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

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

ComputeRoutesResponse

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

フィールド
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

代替情報

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

フィールド
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

フォールバックの理由

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

列挙型
FALLBACK_REASON_UNSPECIFIED 代替理由が指定されていません。
SERVER_ERROR 優先ルーティング モードでルートを計算中にサーバーエラーが発生しましたが、代替モードで計算された結果を返すことができました。
LATENCY_EXCEEDED ご希望の経路モードを使用した計算を予定どおりに完了できませんでしたが、代替モードによって計算された結果を返すことができました。

代替ルーティング モード

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

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

ジオコーディングされた地点

地点として使用する場所についての詳細住所の地点にのみ入力されます。住所がジオコーディングされた地域を特定するためのジオコーディング結果の詳細が含まれます。

フィールド
geocoder_status

Status

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

type[]

string

結果の型(ゼロ以上のタイプタグの形式)。サポートされているタイプ: https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types

partial_match

bool

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

place_id

string

この結果のプレイス ID。

intermediate_waypoint_request_index

int32

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

ジオコーディングの結果

出発地、目的地、中間地点の GeocodedWaypoints が含まれます。住所の地点にのみ入力されます。

フィールド
origin

GeocodedWaypoint

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

destination

GeocodedWaypoint

ジオコーディングされた地点。

intermediates[]

GeocodedWaypoint

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

ローカライズされた時刻

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

フィールド
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 左に左折します。
TURN_LEFT 左折します。
TURN_SLIGHT_RIGHT 少し右に曲がります。
TURN_SHARP_RIGHT 右左折します。
UTURN_RIGHT 右左折します。
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_type は次のいずれかになります。
encoded_polyline

string

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

geo_json_linestring

Struct

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

ポリラインのエンコード

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

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

ポリラインの質

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

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

経路

ルートには、一連の始点、終点、中間点を結ぶ一連の道路セグメントが含まれています。

フィールド
route_labels[]

RouteLabel

Route のラベル。ルートの特定のプロパティを特定して他のプロパティと比較する際に便利です。

legs[]

RouteLeg

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

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

運賃はテキスト形式で表記されます。

ルートラベル

Route のラベル。ルートの特定のプロパティを特定して他のプロパティと比較する際に便利です。

列挙型
ROUTE_LABEL_UNSPECIFIED デフォルト - 未使用
DEFAULT_ROUTE ルート計算で返されるデフォルトの「最適な」ルート。
DEFAULT_ROUTE_ALTERNATE デフォルトの「最適」ルートに代わるものです。compute_alternative_routes を指定すると、このようなルートが返されます。
FUEL_EFFICIENT 燃費効率が良いルートこの値のラベルが付いたルートは、燃料消費量などのエコ パラメータ向けに最適化されています。

ルートレッグ

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

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

手順の概要

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

フィールド
multi_modal_segments[]

MultiModalSegment

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

マルチモーダル セグメント

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

フィールド
navigation_instruction

NavigationInstruction

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

travel_mode

RouteTravelMode

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

step_start_index

int32

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

step_end_index

int32

マルチモーダル セグメントの終わりである対応する 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

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

RouteLegStepLocalizedValue

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

フィールド
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 にカリフォルニア州サンノゼを出発する、カリフォルニア州サクラメント行きのアムトラックの 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

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

ルート区間の運行情報

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

フィールド
speed_reading_intervals[]

SpeedReadingInterval

注: 現在、このフィールドには入力されていません。

ルート区間の移動に関するアドバイス

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

フィールド
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 で出発地と目的地のペアに対して計算されたルート情報が含まれます。この 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

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

ローカライズされた値

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

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

(省略可)これを原点とするすべてのルートの修飾子

RouteModifier

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

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

ルートトラベルアドバイザリ

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

フィールド
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 リクエストと、すべての交通機関ステップで運賃情報が取得できる場合にのみ返されます。

ルートの移動モード

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

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

ルーティング設定

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

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

SpeedReadingInterval(速度の読み取り間隔)

ポリラインまたはパスの隣接するセグメントのトラフィック密度インジケーター。SpeedReadingInterval は、ポイント P_0、P_1、...、P_N(ゼロベース インデックス)を持つパスの場合、間隔を定義し、そのトラフィックを次のカテゴリを使用して記述します。

フィールド
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

共用体フィールド speed_type

speed_type は次のいずれかになります。

speed

Speed

この間隔のトラフィック速度。

スピード

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

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

通行料金情報

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

フィールド
estimated_price[]

Money

対応する Route または RouteLeg の通行料金。このリストには、有料道路の請求額が想定されている各通貨の金額が記載されています。通常、このリストには、1 つの通貨で通行料金が含まれるルートのアイテムが 1 つだけ含まれます。海外旅行の場合、このリストには通行証料金が異なる複数の通貨で記載される場合があります。

通行証

Google がサポートする世界中の通行証一覧。

列挙型
TOLL_PASS_UNSPECIFIED 使用されません。 この値が使用されていると、リクエストは失敗します。
AU_ETOLL_TAG シドニーの通行証。詳しくは、https://www.myetoll.com.au をご覧ください。
AU_EWAY_TAG シドニーの通行証。詳しくは、https://www.tollpay.com.au をご覧ください。
AU_LINKT オーストラリア全土の通行券詳しくは、https://www.linkt.com.au/ をご覧ください。
AR_TELEPASE アルゼンチンの通行証。詳しくは、https://telepase.com.ar をご覧ください。
BR_AUTO_EXPRESO ブラジルの通行証。詳しくは、https://www.autoexpreso.com をご覧ください。
BR_CONECTCAR ブラジルの通行証。詳しくは、https://conectcar.com をご覧ください。
BR_MOVE_MAIS ブラジルの通行証。詳しくは、https://movemais.com をご参照ください。
BR_PASSA_RAPIDO ブラジルの通行証。詳しくは、https://pasorapido.gob.do/ をご覧ください。
BR_SEM_PARAR ブラジルの通行証。詳しくは、https://www.semparar.com.br をご覧ください。
BR_TAGGY ブラジルの通行証。詳しくは、https://taggy.com.br をご覧ください。
BR_VELOE ブラジルの通行証。詳しくは、https://veloe.com.br/site/onde-usar をご覧ください。
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD カナダと米国間の境界線。
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD カナダと米国間の境界線。
CA_US_BLUE_WATER_EDGE_PASS カナダのオンタリオ州からミシガン州への、米国との国境横断
CA_US_CONNEXION カナダのオンタリオ州からミシガン州への、米国との国境横断
CA_US_NEXUS_CARD カナダと米国間の境界線。
ID_E_TOLL インドネシア通行料金の支払いに複数の銀行が提供する電子カード銀行の電子カードはすべて同じように請求されるため、必要な列挙値は 1 つのみです。例: Bank Mandirihttps://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 インド、本社の州のプレートの免除。
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 AL、米国。
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS 米国、
US_CA_FASTRAK 米国カリフォルニア州。
US_CA_FASTRAK_CAV_STICKER DMV が発行する Clean Air Vehicle(CAV)ステッカーに加えて、運転手に FasTrak パスがあることを示します。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO、米国。
US_CO_GO_PASS CO、米国。
US_DE_EZPASSDE ドイツ、米国。
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS フロリダ州(米国)
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD フロリダ州(米国)
US_FL_EPASS フロリダ州(米国)
US_FL_GIBA_TOLL_PASS フロリダ州(米国)
US_FL_LEEWAY フロリダ州(米国)
US_FL_SUNPASS フロリダ州(米国)
US_FL_SUNPASS_PRO フロリダ州(米国)
US_IL_EZPASSIL イリノイ州(米国)。
US_IL_IPASS イリノイ州(米国)。
US_IN_EZPASSIN (インド、米国)
US_KS_BESTPASS_HORIZON KS、米国。
US_KS_KTAG KS、米国。
US_KS_NATIONALPASS KS、米国。
US_KS_PREPASS_ELITEPASS KS、米国。
US_LA_GEAUXPASS ロサンゼルス(米国)
US_LA_TOLL_TAG ロサンゼルス(米国)
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 ミネソタ州アメリカ。
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 PA(米国)
US_RI_EZPASSRI RI(米国)。
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、米国。
US_WA_BREEZEBY ワシントン、アメリカ。
US_WA_GOOD_TO_GO ワシントン、アメリカ。
US_WV_EZPASSWV ウェストバージニア州、米国。
US_WV_MEMORIAL_BRIDGE_TICKETS ウェストバージニア州、米国。
US_WV_NEWELL_TOLL_BRIDGE_TICKET ウェストバージニア州、米国。

トラフィック モデル

所要時間を計算する上での仮定条件を指定します。この設定はレスポンスの duration フィールドで返される値に影響します。過去の平均値に基づいて予測されたトラフィックの時間が含まれます。

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

交通機関

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

フィールド
name

string

この交通機関の名前。

phone_number

string

交通機関のロケール固有の形式の電話番号。

uri

string

交通機関の URI。

路線

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

フィールド
agencies[]

TransitAgency

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

name

string

この交通機関の路線の正式名称。例: 「東京都港区六本木 6 丁目 1 号線」。

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 ルートに影響します。

交通機関のルーティング設定

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

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

交通機関の移動手段

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

列挙型
TRANSIT_TRAVEL_MODE_UNSPECIFIED 移動手段が指定されていません。
BUS バスでの移動
SUBWAY 地下鉄で移動する。
TRAIN 電車で移動する。
LIGHT_RAIL ライトレールか路面電車を利用する。
RAIL 電車を使う。これは、SUBWAYTRAINLIGHT_RAIL の組み合わせと同等です。

交通機関の停止

交通機関に関する情報。

フィールド
name

string

停車地の名前。

location

Location

緯度と経度の座標で表される停車地の位置。

車両

交通機関の車両で使用されている車両に関する情報。

フィールド
name

LocalizedText

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

type

TransitVehicleType

使用された車両のタイプ。

icon_uri

string

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

local_icon_uri

string

地域の交通標識に基づく、この車両タイプに関連付けられたアイコンの URI。

交通機関の車両タイプ

交通機関の車両の種類。

列挙型
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 ヤード・ポンド単位(英語)。

車両排出量タイプ

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

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

車両情報

車両排出量など車両情報が含まれています。

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

ウェイポイントの位置が、車両の特定の側に停車することを優先することを示します。この値を設定すると、ルートはその場所を通るので、道路の中心から偏った位置で車両が停まります。このオプションは、「DRIVE」と「TWO_WHEELER」RouteTravelMode でのみ機能します。

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

Location

地理座標を使用して指定された地点(省略可の見出しを含む)。

place_id

string

地点に関連付けられたスポット ID。

address

string

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