索引
Routes
(インターフェース)ComputeRouteMatrixRequest
(メッセージ)ComputeRouteMatrixRequest.ExtraComputation
(列挙型)ComputeRoutesRequest
(メッセージ)ComputeRoutesRequest.ExtraComputation
(列挙型)ComputeRoutesRequest.ReferenceRoute
(列挙型)ComputeRoutesResponse
(メッセージ)FallbackInfo
(メッセージ)FallbackReason
(列挙型)FallbackRoutingMode
(列挙型)GeocodedWaypoint
(メッセージ)GeocodingResults
(メッセージ)LocalizedTime
(メッセージ)Location
(メッセージ)Maneuver
(列挙型)NavigationInstruction
(メッセージ)Polyline
(メッセージ)PolylineEncoding
(列挙型)PolylineQuality
(列挙型)Route
(メッセージ)Route.RouteLocalizedValues
(メッセージ)RouteLabel
(列挙型)RouteLeg
(メッセージ)RouteLeg.RouteLegLocalizedValues
(メッセージ)RouteLeg.StepsOverview
(メッセージ)RouteLeg.StepsOverview.MultiModalSegment
(メッセージ)RouteLegStep
(メッセージ)RouteLegStep.RouteLegStepLocalizedValues
(メッセージ)RouteLegStepTransitDetails
(メッセージ)RouteLegStepTransitDetails.TransitDetailsLocalizedValues
(メッセージ)RouteLegStepTransitDetails.TransitStopDetails
(メッセージ)RouteLegStepTravelAdvisory
(メッセージ)RouteLegTravelAdvisory
(メッセージ)RouteMatrixDestination
(メッセージ)RouteMatrixElement
(メッセージ)RouteMatrixElement.LocalizedValues
(メッセージ)RouteMatrixElementCondition
(列挙型)RouteMatrixOrigin
(メッセージ)RouteModifiers
(メッセージ)RouteTravelAdvisory
(メッセージ)RouteTravelMode
(列挙型)RoutingPreference
(列挙型)SpeedReadingInterval
(メッセージ)SpeedReadingInterval.Speed
(列挙型)TollInfo
(メッセージ)TollPass
(列挙型)TrafficModel
(列挙型)TransitAgency
(メッセージ)TransitLine
(メッセージ)TransitPreferences
(メッセージ)TransitPreferences.TransitRoutingPreference
(列挙型)TransitPreferences.TransitTravelMode
(列挙型)TransitStop
(メッセージ)TransitVehicle
(メッセージ)TransitVehicle.TransitVehicleType
(列挙型)Units
(列挙型)VehicleEmissionType
(列挙型)VehicleInfo
(メッセージ)Waypoint
(メッセージ)
ルート
Routes API。
ComputeRouteMatrix |
---|
出発地と目的地のリストを受け取り、出発地と目的地の組み合わせごとのルート情報を含むストリームを返します。 注: このメソッドでは、入力にレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクを指定するには、URL パラメータ たとえば、次のように指定します。
すべてのメッセージで問題ないように見えるため、
|
ComputeRoutes |
---|
ターミナルと中間の地点のセットを指定すると、プライマリ ルートとオプションの代替ルートを返します。 注: このメソッドでは、入力にレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクを指定するには、URL パラメータ たとえば、次のように指定します。
Google では、ワイルドカード(
|
ComputeRouteMatrixRequest
ComputeRouteMatrix リクエスト メッセージ
フィールド | |
---|---|
origins[] |
必須。レスポンス マトリックスの行を決定するオリジンの配列。出発地と目的地のカーディナリティには、いくつかのサイズ制限が適用されます。
|
destinations[] |
必須。レスポンス行列の列を決定するデスティネーションの配列。 |
travel_mode |
(省略可)移動手段を指定します。 |
routing_preference |
(省略可)ルートの計算方法を指定します。サーバーは選択されたルーティング設定を使用してルートを計算しようとします。ルーティングの設定がエラーまたは長いレイテンシになると、エラーが返されます。このオプションを指定できるのは |
departure_time |
(省略可)出発時刻。この値を設定しなかった場合、リクエストを行った時刻がデフォルトになります。注: |
arrival_time |
(省略可)到着時刻。注: |
language_code |
(省略可)「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語のサポートをご覧ください。この値を指定しない場合、表示言語は最初のオリジンの場所から推定されます。 |
region_code |
(省略可)地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値で指定します。詳しくは、https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains をご覧ください。 |
extra_computations[] |
(省略可)リクエストを完了するために使用できる追加の計算のリスト。注: これらの計算を行うと、レスポンスに余分なフィールドが返されることがあります。これらの追加のフィールドは、レスポンスで返されるようにフィールド マスクで指定する必要があります。 |
traffic_model |
(省略可)所要時間を計算する上での仮定条件を指定します。この設定は、 |
transit_preferences |
(省略可) |
外計算
リクエストの完了時に実施する追加の計算。
列挙型 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
使用されません。 この値を含むリクエストは失敗します。 |
TOLLS |
マトリックス要素の有料道路情報。 |
ComputeRoutesRequest
ComputeRoutes リクエスト メッセージ。
フィールド | |
---|---|
origin |
必須。出発地点。 |
destination |
必須。目的地の地点。 |
intermediates[] |
(省略可)経路に沿った地点のセット(停車地点または停車地点を除く)。停車地点または停車地点。中間地点は最大 25 個サポートされています。 |
travel_mode |
(省略可)移動手段を指定します。 |
routing_preference |
(省略可)ルートの計算方法を指定します。サーバーは選択されたルーティング設定を使用してルートを計算しようとします。ルーティングの設定がエラーまたは長いレイテンシになると、エラーが返されます。このオプションを指定できるのは |
polyline_quality |
(省略可)ポリラインの品質の設定を指定します。 |
polyline_encoding |
(省略可)ポリラインに優先するエンコードを指定します。 |
departure_time |
(省略可)出発時刻。この値を設定しなかった場合、リクエストを行った時刻がデフォルトになります。注: |
arrival_time |
(省略可)到着時刻。注: |
compute_alternative_routes |
(省略可)ルートに加えて代替ルートを計算するかどうかを指定します。中間地点を含むリクエストでは代替ルートは返されません。 |
route_modifiers |
(省略可)ルートの計算方法に影響する一連の条件。 |
language_code |
(省略可)「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。サポートされている言語の一覧については、言語のサポートをご覧ください。この値を指定しない場合、ルート リクエストの位置から表示言語が推測されます。 |
region_code |
(省略可)地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値で指定します。詳しくは、https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains をご覧ください。 |
units |
(省略可)表示フィールドの測定単位を指定します。これらのフィールドには、 |
optimize_waypoint_order |
(省略可)true に設定すると、サービスは指定された中間地点の順序を変更することで、ルートの全体的な費用を最小限に抑えようとします。中間地点のいずれかが |
requested_reference_routes[] |
(省略可)デフォルト ルートに加えて、リクエストの一部として計算する参照ルートを指定します。参照ルートは、デフォルトのルートとは異なるルート計算目標を持つルートです。たとえば、 |
extra_computations[] |
(省略可)リクエストを完了するために使用できる追加の計算のリスト。注: これらの計算を行うと、レスポンスに余分なフィールドが返されることがあります。これらの追加のフィールドは、レスポンスで返されるようにフィールド マスクで指定する必要があります。 |
traffic_model |
(省略可)所要時間を計算する上での仮定条件を指定します。この設定は、 |
transit_preferences |
(省略可) |
外計算
リクエストの完了時に実施する追加の計算。
列挙型 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
使用されません。 この値を含むリクエストは失敗します。 |
TOLLS |
ルートの料金情報。 |
FUEL_CONSUMPTION |
ルートの推定燃料消費量。 |
TRAFFIC_ON_POLYLINE |
ルートの交通状況を認識するポリライン |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
ナビゲーション手順は、書式設定された HTML テキスト文字列で表されます。このコンテンツはそのまま読み取られます。これは表示専用です。プログラムで解析しないでください。 |
ReferenceRoute
ComputeRoutesRequest でサポートされている参照ルート。
列挙型 | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
使用されません。 この値を含むリクエストは失敗します。 |
FUEL_EFFICIENT |
燃費効率が良いルートこの値のラベルが付いたルートは、燃料消費量などのパラメータ向けに最適化されていると判断されます。 |
ComputeRoutesResponse
ComputeRoutes レスポンス メッセージ。
フィールド | |
---|---|
routes[] |
compute_alternatives_routes を指定すると、計算されたルートの配列(最大 3 つ)が含まれます。指定しない場合は 1 つのルートのみが含まれます。この配列に複数のエントリが含まれている場合は、最初のルートが推奨されます。配列が空の場合は、ルートが見つからなかったことを意味します。 |
fallback_info |
場合によっては、サーバーが入力されたすべての設定に基づいてルートの結果を計算できない場合は、別の計算方法にフォールバックすることがあります。フォールバック モードが使用されている場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合、このフィールドは未設定です。 |
geocoding_results |
住所として指定された地点のジオコーディング レスポンス情報が含まれます。 |
代替情報
代替結果が使用された方法と理由に関する情報。このフィールドが設定されている場合、サーバーは優先モードとは異なるルーティング モードをフォールバックとして使用しています。
フィールド | |
---|---|
routing_mode |
レスポンスに使用されるルーティング モード。フォールバックがトリガーされた場合は、元のクライアント リクエストで設定したルーティング設定とは異なるモードになっている可能性があります。 |
reason |
元のレスポンスの代わりにフォールバック レスポンスが使用された理由。このフィールドは、フォールバック モードがトリガーされ、フォールバック レスポンスが返される場合にのみ入力されます。 |
フォールバックの理由
フォールバック レスポンスを使用する理由。
列挙型 | |
---|---|
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 |
ジオコーディングの処理結果を示すステータス コードを示します。 |
type[] |
結果の型(ゼロ以上のタイプタグの形式)。サポートされているタイプ: https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types |
partial_match |
ジオコーダによって、元のリクエストに完全一致する住所は見つからなかったものの、部分一致する住所は見つかったことを示します。元のリクエストで住所の表記が間違っていたり、不完全である可能性があります。 |
place_id |
この結果のプレイス ID。 |
intermediate_waypoint_request_index |
リクエスト内の対応する中間地点のインデックス。対応する地点が中間地点の場合にのみ入力されます。 |
ジオコーディングの結果
出発地、目的地、中間地点の GeocodedWaypoints
が含まれます。住所の地点にのみ入力されます。
フィールド | |
---|---|
origin |
ジオコーディングされた出発地点。 |
destination |
ジオコーディングされた地点。 |
intermediates[] |
中間ジオコーディングの地点のリスト。それぞれに地点が 0 から始まる位置に対応するインデックス フィールド(リクエストで指定された順序)が含まれます。 |
ローカライズされた時刻
時刻のローカライズされた説明。
フィールド | |
---|---|
time |
特定のタイムゾーンで、文字列として指定された時刻。 |
time_zone |
タイムゾーンが含まれます。この値は、IANA タイムゾーン データベースで定義されたタイムゾーンの名前です(例: America/New_York)。 |
場所
場所(地理的位置、任意の角度)をカプセル化します。
フィールド | |
---|---|
lat_lng |
地点の地理座標。 |
heading |
交通の流れの方向に関連付けられたコンパスの向き。この値は、乗車地点と降車地点の道路の片側を示します。方位値は 0 ~ 360 の範囲で、0 は期限の北、90 は東の方向というように指定します。このフィールドは、 |
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 |
町名の変更を示すために使用されます。 |
ポリライン
エンコードされたポリラインをカプセル化します。
フィールド | |
---|---|
共用体フィールド polyline_type 。ポリラインのタイプをカプセル化します。デフォルトは encoded_ポリラインです。polyline_type は次のいずれかになります。 |
|
encoded_polyline |
ポリライン エンコード アルゴリズムを使用したポリラインの文字列エンコード |
geo_json_linestring |
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[] |
|
legs[] |
経路を構成する区間(地点間の経路セグメント)のコレクション。各区間は、2 つの |
distance_meters |
ルートの移動距離(メートル単位)。 |
duration |
ルートの移動にかかる時間です。 |
static_duration |
交通状況を考慮しないルートの移動時間。 |
polyline |
ルート全体のポリライン。このポリラインは、すべての |
description |
ルートの説明。 |
warnings[] |
ルートを表示する際に表示する警告の配列。 |
viewport |
ポリラインのビューポート境界ボックス。 |
travel_advisory |
ルートに関する追加情報。 |
optimized_intermediate_waypoint_index[] |
|
localized_values |
|
route_token |
Navigation SDK に渡せる、ウェブセーフな base64 でエンコードされたルートトークン。Navigation SDK はナビゲーション中にルートを再構成できます。再ルーティングが発生した場合は、ComputeRoutes を呼び出してルートを作成するときに元のインテントを使用します。お客様はこのトークンを不透明な blob として扱う必要があります。読み取りまたは変更用ではありません。注: |
RouteLocalizedValues
特定のプロパティのテキスト表現。
フィールド | |
---|---|
distance |
テキスト形式で表される移動距離。 |
duration |
交通状況を考慮した所要時間。テキスト形式で表示されます。注: 交通情報をリクエストしなかった場合、この値は static_duration と同じになります。 |
static_duration |
交通状況を考慮しない期間(テキスト形式)。 |
transit_fare |
運賃はテキスト形式で表記されます。 |
ルートラベル
Route
のラベル。ルートの特定のプロパティを特定して他のプロパティと比較する際に便利です。
列挙型 | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
デフォルト - 未使用 |
DEFAULT_ROUTE |
ルート計算で返されるデフォルトの「最適な」ルート。 |
DEFAULT_ROUTE_ALTERNATE |
デフォルトの「最適」ルートに代わるものです。compute_alternative_routes を指定すると、このようなルートが返されます。 |
FUEL_EFFICIENT |
燃費効率が良いルートこの値のラベルが付いたルートは、燃料消費量などのエコ パラメータ向けに最適化されています。 |
ルートレッグ
via
以外の地点間のセグメントが含まれます。
フィールド | |
---|---|
distance_meters |
ルート区間の移動距離(メートル単位)。 |
duration |
区間の移動に必要な時間。 |
static_duration |
交通状況を考慮しない区間での移動時間。 |
polyline |
|
start_location |
この区間の始点。このロケーションは、指定されている |
end_location |
この区間の終点。このロケーションは、指定されている |
steps[] |
この区間のセグメントを示すステップの配列。各ステップは 1 つのナビゲーション命令を表します。 |
travel_advisory |
ルート区間でのトラフィック ゾーン制限など、ユーザーに通知する必要がある追加情報が含まれています。 |
localized_values |
|
steps_overview |
この |
RouteLegLocalizedValues
特定のプロパティのテキスト表現。
フィールド | |
---|---|
distance |
テキスト形式で表される移動距離。 |
duration |
テキスト形式で表現される交通状況を考慮した時間。注: 交通情報をリクエストしなかった場合、この値は static_duration と同じになります。 |
static_duration |
交通状況を考慮しない期間(テキスト形式)。 |
手順の概要
RouteLegStep
のリストに関する概要情報を提供します。
フィールド | |
---|---|
multi_modal_segments[] |
|
マルチモーダル セグメント
RouteLeg.steps
のさまざまなマルチモーダル セグメントに関する要約情報を提供します。マルチモーダル セグメントは、同じ RouteTravelMode
を持つ 1 つ以上の連続した RouteLegStep
として定義されます。ステップでマルチモーダル セグメントが RouteLeg
に含まれていない場合、このフィールドは入力されません。
フィールド | |
---|---|
navigation_instruction |
マルチモーダル セグメントの NavigationInstruction |
travel_mode |
マルチモーダル セグメントの移動手段。 |
step_start_index |
マルチモーダル セグメントの開始である、対応する |
step_end_index |
マルチモーダル セグメントの終わりである対応する |
ルート区間
RouteLeg
のセグメントが含まれています。ステップは 1 つのナビゲーション命令に対応します。ルート区間は複数のステップで構成されます。
フィールド | |
---|---|
distance_meters |
このステップの移動距離(メートル単位)。状況によっては、このフィールドに値が表示されない場合があります。 |
static_duration |
交通状況を考慮しない状態でこのステップを通過する期間。状況によっては、このフィールドに値が表示されない場合があります。 |
polyline |
このステップに関連付けられたポリライン。 |
start_location |
このステップの始点。 |
end_location |
このステップの終点。 |
navigation_instruction |
操作手順 |
travel_advisory |
トラフィックのステップに関する潜在的な制限など、ユーザーに伝えなければならない追加情報が含まれています。 |
localized_values |
|
transit_details |
移動手段が |
travel_mode |
このステップで使用される移動手段。 |
RouteLegStepLocalizedValue
特定のプロパティのテキスト表現。
フィールド | |
---|---|
distance |
テキスト形式で表される移動距離。 |
static_duration |
交通状況を考慮しない期間(テキスト形式)。 |
RouteLegStepTransitDetails
TRANSIT
ルートに関連する RouteLegStep
の追加情報。
フィールド | |
---|---|
stop_details |
当該ステップの到着 / 出発に関する情報。 |
localized_values |
|
headsign |
車両または出発駅に示されている、この路線を進む方向を指定します。多くの場合、方向は終点です。 |
headway |
現時点で同じ駅または停留所からの出発間隔を予想時刻として指定します。たとえば、運転時隔の秒数が 600 の場合、バスを逃すと 10 分待つことになると予想されます。 |
transit_line |
このステップで使用される交通機関の路線に関する情報。 |
stop_count |
出発地から到着地までの経由地数。このカウントには出発停車地は含まれますが、出発停車地は含まれません。たとえば、停車地 A から出発して、停車地 B と C を通過し、停車地 D に到着した場合、stop_count は 3 を返します。 |
trip_short_text |
乗客への乗換案内を識別するために、時刻表や掲示板に表示されるテキスト。テキストでは、運行日の特定のルートを一意に識別する必要があります。たとえば「538」は、平日の 15:10 にカリフォルニア州サンノゼを出発する、カリフォルニア州サクラメント行きのアムトラックの |
TransitDetailsLocalizedValues
RouteTransitDetails の値のローカライズされた説明。
フィールド | |
---|---|
arrival_time |
書式付きテキスト表現での、対応するタイムゾーンでの時刻。 |
departure_time |
書式付きテキスト表現での、対応するタイムゾーンでの時刻。 |
TransitStopDetails
RouteLegStep
の交通機関の停車地の詳細
フィールド | |
---|---|
arrival_stop |
ステップの到着停車地に関する情報。 |
arrival_time |
ステップの到着予定時刻。 |
departure_stop |
このステップの出発駅に関する情報。 |
departure_time |
このステップの出発予定時刻。 |
ルート区間の運行情報
レッグステップでトラフィック ゾーンの制限など、ユーザーに通知する必要がある追加情報が含まれています。
フィールド | |
---|---|
speed_reading_intervals[] |
注: 現在、このフィールドには入力されていません。 |
ルート区間の移動に関するアドバイス
トラフィック ゾーンの制限など、レッグステップでユーザーに通知する必要がある追加情報が含まれています。
フィールド | |
---|---|
toll_info |
特定の |
speed_reading_intervals[] |
トラフィック密度の詳細速度。 例:
|
RouteMatrixDestination
ComputeRouteMatrixRequest の単一の宛先
フィールド | |
---|---|
waypoint |
必須。目的地の地点 |
RouteMatrixElement
ComputeRouteMatrix API で出発地と目的地のペアに対して計算されたルート情報が含まれます。この proto は、クライアントにストリーミングできます。
フィールド | |
---|---|
status |
この要素のエラー ステータス コードです。 |
condition |
ルートが見つかったかどうかを示します。ステータスとは無関係です。 |
distance_meters |
ルートの移動距離(メートル単位)。 |
duration |
ルートの移動にかかる時間です。 |
static_duration |
交通状況を考慮しないルートの移動時間。 |
travel_advisory |
ルートに関する追加情報。(制限情報や通行料金情報など) |
fallback_info |
場合によっては、サーバーがこの特定の出発地と目的地のペアについて、指定された設定を使用してルートを計算できない場合、別のコンピューティング モードを使用するようフォールバックすることがあります。代替モードが使用されている場合、このフィールドには代替レスポンスに関する詳細情報が含まれます。それ以外の場合、このフィールドは未設定です。 |
localized_values |
|
origin_index |
リクエスト内のオリジンのゼロベースのインデックス。 |
destination_index |
リクエスト内の宛先のゼロベースのインデックス。 |
ローカライズされた値
特定のプロパティのテキスト表現。
フィールド | |
---|---|
distance |
テキスト形式で表される移動距離。 |
duration |
交通状況を考慮したテキスト形式で示された所要時間。注: 交通情報がリクエストされなかった場合、この値は static_duration と同じになります。 |
static_duration |
交通量を考慮せずにテキスト形式で表現された所要時間。 |
transit_fare |
運賃はテキスト形式で表記されます。 |
RouteMatrixElementCondition
返されるルートの条件。
列挙型 | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
要素の status が OK でない場合にのみ使用します。 |
ROUTE_EXISTS |
ルートが見つかったので、対応する情報が要素に入力されました。 |
ROUTE_NOT_FOUND |
経路が見つかりませんでした。ルート情報(distance_meters 、duration など)を含むフィールドは、要素内で入力されません。 |
RouteMatrixOrigin
ComputeRouteMatrixRequest の単一のオリジン
フィールド | |
---|---|
waypoint |
必須。出発地点 |
route_modifiers |
(省略可)これを原点とするすべてのルートの修飾子 |
RouteModifier
ルートの計算時に満たす必要のある一連の条件をカプセル化します。
フィールド | |
---|---|
avoid_tolls |
true に設定すると、有料道路が含まれていなければ、有料道路を避けて、有料道路を含まないルートを優先します。 |
avoid_highways |
true に設定すると、合理的には高速道路を避けて、高速道路を含まないルートを優先します。 |
avoid_ferries |
true に設定すると、合理的にはフェリーを利用せず、フェリーを含まない経路を優先します。 |
avoid_indoor |
true に設定すると、妥当な場合に屋内のナビゲーションを回避し、屋内のナビゲーションを含まないルートを優先します。 |
vehicle_info |
車両情報を指定します。 |
toll_passes[] |
通行証に関する情報をカプセル化します。通行券が指定されている場合、API はパスの料金を返すよう試みます。通行券が提供されない場合、API では通行証が不明として処理され、現金料金が返還されます。 |
ルートトラベルアドバイザリ
トラフィック ゾーンの制限など、ユーザーに通知する必要がある追加情報が含まれています。
フィールド | |
---|---|
toll_info |
ルートの有料道路に関する情報が含まれています。このフィールドは、経路で有料道路が予想される場合にのみ入力されます。このフィールドが設定されている場合でも、estimatedPrice サブフィールドにデータが入力されていない場合、ルートには有料区間が含まれますが、推定料金は不明です。このフィールドが設定されていない場合、ルートで通行料金は表示されません。 |
speed_reading_intervals[] |
トラフィック密度の詳細速度。 例:
|
fuel_consumption_microliters |
予測される燃料消費量(マイクロリットル)。 |
route_restrictions_partially_ignored |
返されるルートには、リクエストされた移動手段や経路の修飾子に適さない制限が含まれている場合があります。 |
transit_fare |
このルートの運賃やチケットの合計金額が存在する場合、このプロパティは、 |
ルートの移動モード
移動手段を指定するために使用される値のセット。注: WALK
、BICYCLE
、TWO_WHEELER
の経路はベータ版のため、明確な歩道、歩行者専用道路、自転車専用道路が表示されないことがあります。この警告は、アプリに表示される徒歩、自転車、自転車のすべてのルートについて、ユーザーに表示する必要があります。
列挙型 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
移動手段が指定されていません。デフォルトは DRIVE です。 |
DRIVE |
乗用車での移動。 |
BICYCLE |
自転車で移動 |
WALK |
徒歩で移動しましょう。 |
TWO_WHEELER |
二輪車例: オートバイこれは、手動モードの移動手段(BICYCLE )に対応する移動手段とは異なります。 |
TRANSIT |
利用できる場合は、公共交通機関を使用するルートを指定します。 |
ルーティング設定
ルートを計算する際に考慮する要素を指定する値のセット。
列挙型 | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
ルーティング設定が指定されていません。デフォルトは TRAFFIC_UNAWARE です。 |
TRAFFIC_UNAWARE |
リアルタイムの交通状況を考慮せずにルートを計算します。交通状況が重要でないか、該当しない場合に適しています。この値を使用すると、レイテンシが最も低くなります。注: RouteTravelMode DRIVE と TWO_WHEELER は、道路網と平均的な交通状況(時間的な要素を考慮に入れない)に基づいてルートと所要時間を選択します。リクエストの結果は、道路網の変化、平均交通状態の更新、サービスの分散性によって、時間の経過とともに変化することがあります。また、結果は、ほぼ同等のルートでも、時刻やリクエストの頻度によって異なる場合があります。 |
TRAFFIC_AWARE |
リアルタイムの交通状況を考慮したルートを計算します。TRAFFIC_AWARE_OPTIMAL とは対照的に、いくつかの最適化によりレイテンシが大幅に削減されます。 |
TRAFFIC_AWARE_OPTIMAL |
パフォーマンスの最適化をほとんど行わずに、リアルタイムの交通状況を考慮したルートを計算します。この値を使用すると、レイテンシが最も高くなります。 |
SpeedReadingInterval(速度の読み取り間隔)
ポリラインまたはパスの隣接するセグメントのトラフィック密度インジケーター。SpeedReadingInterval は、ポイント P_0、P_1、...、P_N(ゼロベース インデックス)を持つパスの場合、間隔を定義し、そのトラフィックを次のカテゴリを使用して記述します。
フィールド | |
---|---|
start_polyline_point_index |
ポリライン内のこの間隔の開始インデックス。 |
end_polyline_point_index |
ポリライン内のこの間隔の終了インデックス。 |
共用体フィールド
|
|
speed |
この間隔のトラフィック速度。 |
スピード
交通データに基づくポリライン速度の分類。
列挙型 | |
---|---|
SPEED_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
NORMAL |
通常の速度、速度の低下は検出されません。 |
SLOW |
速度低下は検出されましたが、渋滞は発生しませんでした。 |
TRAFFIC_JAM |
渋滞が検出されました。 |
通行料金情報
フィールド | |
---|---|
estimated_price[] |
対応する |
通行証
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_KY_RIVERLINK |
ケンタッキー(米国) |
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 |
この交通機関の名前。 |
phone_number |
交通機関のロケール固有の形式の電話番号。 |
uri |
交通機関の URI。 |
路線
このステップで使用される交通機関の路線に関する情報が含まれます。
フィールド | |
---|---|
agencies[] |
この路線を運営する交通機関。 |
name |
この交通機関の路線の正式名称。例: 「東京都港区六本木 6 丁目 1 号線」。 |
uri |
交通機関によって提供される、この路線の URI。 |
color |
線の案内で一般的に使用される色。16 進数で表されます。 |
icon_uri |
この行に関連付けられたアイコンの URI。 |
name_short |
この路線の略称。この名前は通常、「M7」や「355」などの行番号になります。 |
text_color |
この路線のサイネージで一般的に使用される色。16 進数で表されます。 |
vehicle |
この路線を運行する車両の種類。 |
TransitPreferences
返されるルートに影響する TRANSIT
ベースのルートの設定。
フィールド | |
---|---|
allowed_travel_modes[] |
|
routing_preference |
指定するルーティング ルートは、返される |
交通機関のルーティング設定
交通機関のルートのルーティング設定を指定します。
列挙型 | |
---|---|
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED |
指定されていません。 |
LESS_WALKING |
計算されたルートが、歩行距離に制限があることを示します。 |
FEWER_TRANSFERS |
乗り換え回数に制限を付けてルートを計算するよう指定します。 |
交通機関の移動手段
交通手段を指定するために使用される値のセット。
列挙型 | |
---|---|
TRANSIT_TRAVEL_MODE_UNSPECIFIED |
移動手段が指定されていません。 |
BUS |
バスでの移動 |
SUBWAY |
地下鉄で移動する。 |
TRAIN |
電車で移動する。 |
LIGHT_RAIL |
ライトレールか路面電車を利用する。 |
RAIL |
電車を使う。これは、SUBWAY 、TRAIN 、LIGHT_RAIL の組み合わせと同等です。 |
交通機関の停止
交通機関に関する情報。
フィールド | |
---|---|
name |
停車地の名前。 |
location |
緯度と経度の座標で表される停車地の位置。 |
車両
交通機関の車両で使用されている車両に関する情報。
フィールド | |
---|---|
name |
この車両の名前(大文字)。 |
type |
使用された車両のタイプ。 |
icon_uri |
この車両タイプに関連付けられたアイコンの URI。 |
local_icon_uri |
地域の交通標識に基づく、この車両タイプに関連付けられたアイコンの 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 |
車両の排出量タイプを示します。 |
ウェイポイント
地点をカプセル化します。地点は経路の始点と終点をマークし、中間点はルートに含まれます。
フィールド | |
---|---|
via |
この地点は停止地点ではなくマイルストーンとしてマークされます。リクエスト内の非経由地点ごとに、レスポンスでは |
vehicle_stopover |
停車地点が車両の停留所で、乗車または降車を意図していることを示します。この値を設定すると、乗換に適さない道路の |
side_of_road |
ウェイポイントの位置が、車両の特定の側に停車することを優先することを示します。この値を設定すると、ルートはその場所を通るので、道路の中心から偏った位置で車両が停まります。このオプションは、「DRIVE」と「TWO_WHEELER」 |
共用体フィールド location_type 。場所の表現方法。location_type は次のいずれかになります。 |
|
location |
地理座標を使用して指定された地点(省略可の見出しを含む)。 |
place_id |
地点に関連付けられたスポット ID。 |
address |
人が読める形式の住所または plus code。詳しくは https://plus.codes をご覧ください。 |