Method: computeRoutes

一連の終点と中間地点を指定すると、メインルートとオプションの代替ルートが返されます。

注: このメソッドでは、入力でレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクを指定するには、URL パラメータ $fields または fields を使用するか、HTTP/gRPC ヘッダー X-Goog-FieldMask を使用します(使用可能な URL パラメータとヘッダーをご覧ください)。値は、フィールドパスのカンマ区切りのリストです。フィールドパスの作成方法に関する詳細なドキュメントをご覧ください。

たとえば、次のメソッドでは、

  • 利用可能なすべてのフィールドのフィールド マスク(手動検査用): X-Goog-FieldMask: *
  • ルートレベルの所要時間、距離、ポリラインのフィールド マスク(本番環境の設定例): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google では、ワイルドカード(*)レスポンス フィールド マスクの使用や、最上位(routes)でのフィールド マスクの指定は推奨していません。理由は次のとおりです。

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

HTTP リクエスト

POST https://routes.googleapis.com/directions/v2:computeRoutes

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
フィールド
origin

object (Waypoint)

必須。出発地のウェイポイント。

destination

object (Waypoint)

必須。目的地のウェイポイント。

intermediates[]

object (Waypoint)

省略可。ルート上のウェイポイント(終点を除く)のセット。停車地点または通過地点として使用します。最大 25 個の中間地点がサポートされています。

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (RoutingPreference)

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

polylineQuality

enum (PolylineQuality)

省略可。ポリラインの品質に関する設定を指定します。

polylineEncoding

enum (PolylineEncoding)

省略可。ポリラインの優先エンコードを指定します。

departureTime

string (Timestamp format)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

arrivalTime

string (Timestamp format)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

string

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

regionCode

string

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

units

enum (Units)

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

optimizeWaypointOrder

boolean

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

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

省略可。交通状況を考慮して所要時間を計算する際に使用する前提条件を指定します。この設定に応じて、Route と RouteLeg の duration フィールドに返される値が変わります。この値は、過去の平均データに基づく予測所要時間となります。TrafficModel は、RoutingPreference が TRAFFIC_AWARE_OPTIMAL に設定され、RouteTravelMode が DRIVE に設定されているリクエストでのみ使用できます。トラフィックがリクエストされ、TrafficModel が指定されていない場合、デフォルトは BEST_GUESS です。

transitPreferences

object (TransitPreferences)

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

レスポンスの本文

v2.computeRoutes レスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
フィールド
routes[]

object (Route)

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

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

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

PolylineQuality

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

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

PolylineEncoding

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

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

ReferenceRoute

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

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

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

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

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

この機能は、他の移動手段、経由地、optimizeWaypointOrder とは互換性がありません。そのようなリクエストは失敗します。ただし、任意の routingPreference で使用できます。

ExtraComputation

リクエストの完了時に実行する追加の計算。今後、値が追加される可能性があります。

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

ルーティング

ルートが含まれます。ルートは、始点、終点、中間地点を結ぶ一連の接続された道路セグメントで構成されます。

JSON 表現
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
フィールド
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

distanceMeters

integer

ルートの移動距離(メートル単位)。

duration

string (Duration format)

ルートの移動に必要な時間。routingPreference を TRAFFIC_UNAWARE に設定すると、この値は staticDuration と同じになります。routingPreference を TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定すると、この値は交通状況を考慮して計算されます。

routingPreference が TRAFFIC_AWARE_OPTIMAL に設定されている場合、所要時間は乗用車の速度またはトラックの速度(所要時間が長くなる)を使用して計算されます。次のいずれかの条件に該当する場合、トラックの速度が使用されます。

それ以外の場合は、vehicleInfo で他の車両の寸法や重量が指定されていても、乗用車の速度が使用されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

staticDuration

string (Duration format)

交通状況を考慮しない、ルートの移動時間。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

polyline

object (Polyline)

ルート全体のポリライン。このポリラインは、すべての legs を組み合わせたポリラインです。

description

string

ルートの説明。

warnings[]

string

ルートを表示するときに表示する警告の配列。

viewport

object (Viewport)

ポリラインのビューポート境界ボックス。

travelAdvisory

object (RouteTravelAdvisory)

ルートに関する追加情報。

optimizedIntermediateWaypointIndex[]

integer

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

localizedValues

object (RouteLocalizedValues)

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

routeToken

string

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

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

polylineDetails

object (PolylineDetails)

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

RouteLabel

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

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

RouteLeg

via 以外のウェイポイント間のセグメントが含まれています。

JSON 表現
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
フィールド
distanceMeters

integer

ルート区間の移動距離(メートル単位)。

duration

string (Duration format)

区間の移動に必要な時間。routingPreference が TRAFFIC_UNAWARE に設定されている場合、この値は staticDuration と同じです。routingPreference が TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL の場合、この値は交通状況を考慮して計算されます。

routingPreference が TRAFFIC_AWARE_OPTIMAL に設定されている場合、所要時間は乗用車の速度またはトラックの速度(所要時間が長くなる)を使用して計算されます。次のいずれかの条件に該当する場合、トラックの速度が使用されます。

それ以外の場合は、vehicleInfo で他の車両の寸法や重量が指定されていても、乗用車の速度が使用されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

staticDuration

string (Duration format)

区間の移動時間。交通状況を考慮せずに計算されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

polyline

object (Polyline)

各 step のポリラインを含む、この区間の全体的なポリライン。

startLocation

object (Location)

この区間の開始位置。このロケーションは、指定された origin とは異なる場合があります。たとえば、指定された origin が道路の近くにない場合、これは道路上のポイントです。

endLocation

object (Location)

この区間の終了地点。このロケーションは、指定された destination とは異なる場合があります。たとえば、指定された destination が道路の近くにない場合、これは道路上のポイントです。

steps[]

object (RouteLegStep)

この区間内のセグメントを示すステップの配列。各ステップは 1 つのナビゲーション指示を表します。

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

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

stepsOverview

object (StepsOverview)

この RouteLeg の手順の概要。このフィールドは、TRANSIT ルートの場合にのみ入力されます。

ポリライン

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

JSON 表現
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
フィールド
ポリラインのタイプをカプセル化します。デフォルトは encoded_polyline です。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

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

相互に排他的なフィールドの終了。

RouteLegStep

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

JSON 表現
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
フィールド
distanceMeters

integer

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

staticDuration

string (Duration format)

交通状況を考慮しない、このステップの移動時間。状況によっては、このフィールドに値が設定されないことがあります。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

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

navigationInstruction

object (NavigationInstruction)

ナビゲーションの手順。

travelAdvisory

object (RouteLegStepTravelAdvisory)

区間のステップで、ユーザーに通知する必要がある追加情報(交通規制区域の制限など)が含まれます。

localizedValues

object (RouteLegStepLocalizedValues)

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

transitDetails

object (RouteLegStepTransitDetails)

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

travelMode

enum (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 道路名の変更を示すために使用します。
DESTINATION 目的地への到着を示すために使用されます。

RouteLegStepTravelAdvisory

区間のステップで交通規制が適用される可能性があるなど、ユーザーに通知する必要がある追加情報が含まれます。

JSON 表現
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
フィールド
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

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

JSON 表現
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
フィールド
distance

object (LocalizedText)

テキスト形式で表される移動距離。

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

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

JSON 表現
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
フィールド
stopDetails

object (TransitStopDetails)

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

localizedValues

object (TransitDetailsLocalizedValues)

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

headsign

string

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

headway

string (Duration format)

現時点での同じ駅や停留所からの出発間隔を推定時間として指定します。たとえば、運行間隔が 600 秒の場合、バスを逃すと 10 分待つことになると予想されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

transitLine

object (TransitLine)

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

stopCount

integer

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

tripShortText

string

乗客が交通機関のルートを識別できるように、時刻表や案内板に表示されるテキスト。このテキストは、運行日の特定のルートを一意に識別するものである必要があります。たとえば、「538」は、平日の 15:10 にカリフォルニア州サンノゼを出発してカリフォルニア州サクラメントに向かうアムトラックの列車の tripShortText です。

TransitStopDetails

RouteLegStep の停車地に関する詳細。

JSON 表現
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
フィールド
arrivalStop

object (TransitStop)

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

arrivalTime

string (Timestamp format)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

departureStop

object (TransitStop)

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

departureTime

string (Timestamp format)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

TransitStop

交通機関の駅に関する情報。

JSON 表現
{
  "name": string,
  "location": {
    object (Location)
  }
}
フィールド
name

string

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

location

object (Location)

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

TransitDetailsLocalizedValues

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

JSON 表現
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
フィールド
arrivalTime

object (LocalizedTime)

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

departureTime

object (LocalizedTime)

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

LocalizedTime

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

JSON 表現
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
フィールド
time

object (LocalizedText)

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

timeZone

string

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

TransitLine

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

JSON 表現
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
フィールド
agencies[]

object (TransitAgency)

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

name

string

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

uri

string

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

color

string

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

iconUri

string

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

nameShort

string

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

textColor

string

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

vehicle

object (TransitVehicle)

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

TransitAgency

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

JSON 表現
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
フィールド
name

string

この交通機関の名前。

phoneNumber

string

交通機関の電話番号(国際電話形式)。

uri

string

交通機関の URI。

TransitVehicle

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

JSON 表現
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
フィールド
name

object (LocalizedText)

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

type

enum (TransitVehicleType)

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

iconUri

string

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

localIconUri

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 トロリーバス。

RouteLegTravelAdvisory

区間のステップでユーザーに通知する必要がある追加情報(交通規制の可能性など)が含まれます。

JSON 表現
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
フィールド
tollInfo

object (TollInfo)

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

speedReadingIntervals[]

object (SpeedReadingInterval)

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

例:

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

RouteLegLocalizedValues

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

JSON 表現
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
フィールド
distance

object (LocalizedText)

テキスト形式で表される移動距離。

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

StepsOverview

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

JSON 表現
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
フィールド
multiModalSegments[]

object (MultiModalSegment)

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

MultiModalSegment

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

JSON 表現
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
フィールド
navigationInstruction

object (NavigationInstruction)

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

travelMode

enum (RouteTravelMode)

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

stepStartIndex

integer

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

stepEndIndex

integer

マルチモーダル セグメントの終了を示す対応する RouteLegStep インデックス。

ビューポート

緯度と経度のビューポート。対角線上にある 2 つの low ポイントと high ポイントで表されます。ビューポートは閉じた領域と見なされます。つまり、境界が含まれます。緯度の範囲は -90 ~ 90 度、経度の範囲は -180 ~ 180 度にする必要があります。さまざまなケースがあります。

  • low = high の場合、ビューポートはその 1 つのポイントで構成されます。

  • low.longitude > high.longitude の場合、経度の範囲は反転します(ビューポートは経度 180 度の線をまたぎます)。

  • low.longitude = -180 度、high.longitude = 180 度の場合、ビューポートにはすべての経度が含まれます。

  • low.longitude = 180 度、high.longitude = -180 度の場合、経度範囲は空になります。

  • low.latitude > high.latitude の場合、緯度範囲は空です。

low と high の両方に値を入力する必要があり、表されるボックスを空にすることはできません(上記の定義で指定されているとおり)。ビューポートが空の場合、エラーが発生します。

たとえば、次のビューポートはニューヨーク市を完全に囲んでいます。

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 表現
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
フィールド
low

object (LatLng)

必須。ビューポートの最下点。

high

object (LatLng)

必須。ビューポートの最高点。

RouteLocalizedValues

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

JSON 表現
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
フィールド
distance

object (LocalizedText)

テキスト形式で表される移動距離。

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

テキスト形式で表された交通機関の運賃。

PolylineDetails

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

JSON 表現
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
フィールド
tunnelInfo[]

object (TunnelInfo)

ポリラインに沿ったトンネルの詳細。このフィールドは、リクエストで avoidTunnels ルート修飾子が指定され、結果のルートでそれらを回避できなかった場合、または extraComputations で TUNNEL_INFO_ON_POLYLINE が指定され、ルートにトンネルが含まれている場合に設定されます。

restrictionInfo[]

object (RestrictionInfo)

ポリラインに沿った制限の詳細。このフィールドは、リクエストで vehicleInfo ルート修飾子が指定され、結果のルートに該当する制限が含まれている場合にのみ入力されます。それ以外の場合、このフィールドは使用されません。

flyoverInfo[]

object (FlyoverInfo)

ポリラインに沿ったフライオーバーの詳細。

narrowRoadInfo[]

object (NarrowRoadInfo)

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

bridgeInfo[]

object (BridgeInfo)

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

skywayInfo[]

object (SkywayInfo)

ポリラインに沿ったスカイウェイの詳細。

TunnelInfo

ポリラインに沿ったトンネルに関する情報をカプセル化します。

JSON 表現
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
フィールド
tunnelPresence

enum (RoadFeatureState)

ポリラインの特定の区間にトンネルが存在するかどうかを示します。

polylinePointIndex

object (PolylinePointIndex)

ポリラインに沿ったトンネル関連情報の位置。

RoadFeatureState

ポリラインの区間に沿った道路地物の状態をカプセル化します。

列挙型
ROAD_FEATURE_STATE_UNSPECIFIED 道路対象物の状態が計算されませんでした(デフォルト値)。
EXISTS 道路構造物が存在する。
DOES_NOT_EXIST 道路対象物が存在しない。

PolylinePointIndex

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

JSON 表現
{
  "startIndex": integer,
  "endIndex": integer
}
フィールド
startIndex

integer

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

endIndex

integer

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

RestrictionInfo

ポリラインに沿ったさまざまな制限に関する情報をカプセル化します。

JSON 表現
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
フィールド
restrictionPresence

enum (RoadFeatureState)

出力専用。ポリラインの特定の区間に制限があるかどうかを示します。

polylinePointIndex

object (PolylinePointIndex)

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

ポリラインの特定の区間に適用できる制限の種類をカプセル化します。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
restrictedHeightMm

string (int64 format)

高さ制限(ミリメートル単位)。このフィールドは、高さ制限により指定された車両が通行できない場合や、クリアランスが低い場合に設定されます。

restrictedWeightKg

string (int64 format)

重量制限(kg)。このフィールドは、重量制限により通行が妨げられている場合、または指定された車両の重量に近い場合に設定されます。

hazardousGoods

boolean

このフィールドは、危険物の運搬が制限されている場合に true に設定されます。

trucksProhibited

boolean

このフィールドは、トラックが禁止されている場合に true に設定されます。

相互に排他的なフィールドの終了。

FlyoverInfo

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

JSON 表現
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
フィールド
flyoverPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

ポリラインに沿ったフライオーバー関連情報の位置。

NarrowRoadInfo

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

JSON 表現
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
フィールド
narrowRoadPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

ポリラインに沿った狭い道路に関連する情報の位置。

BridgeInfo

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

JSON 表現
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
フィールド
bridgePresence

enum (RoadFeatureState)

ポリラインの特定の区間に橋が存在するかどうかを示します。

polylinePointIndex

object (PolylinePointIndex)

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

SkywayInfo

ポリラインに沿ったスカイウェイに関する情報をカプセル化します。

JSON 表現
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
フィールド
skywayPresence

enum (RoadFeatureState)

ポリラインの特定の区間にスカイウェイが存在するかどうかを示します。

polylinePointIndex

object (PolylinePointIndex)

ポリラインに沿ったスカイウェイ関連情報の位置。

GeocodingResults

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

JSON 表現
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
フィールド
origin

object (GeocodedWaypoint)

出発地のジオコーディングされたウェイポイント。

destination

object (GeocodedWaypoint)

目的地のジオコーディングされたウェイポイント。

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

経由地として使用される場所の詳細。住所のウェイポイントにのみ入力されます。住所がどのようにジオコーディングされたかを判断するための、ジオコーディング結果の詳細が含まれます。

JSON 表現
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
フィールド
geocoderStatus

object (Status)

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

type[]

string

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

partialMatch

boolean

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

placeId

string

この結果のプレイス ID。

intermediateWaypointRequestIndex

integer

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