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)

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

polylineQuality

enum (PolylineQuality)

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

polylineEncoding

enum (PolylineEncoding)

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

departureTime

string (Timestamp format)

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

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

optimizeWaypointOrder

boolean

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

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

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

transitPreferences

object (TransitPreferences)

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

レスポンスの本文

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 NavigationInstructions は、書式設定された HTML テキスト文字列として表示されます。このコンテンツはそのまま読み取られます。このコンテンツは表示専用です。プログラムで解析しないでください。
FLYOVER_INFO_ON_POLYLINE ルートのフライオーバー情報。この情報を返すには、routes.polyline_details.flyover_info フィールド マスクを指定する必要があります。現在、このデータはインドの一部の都市でのみ入力されます。この機能は試験運用版であり、SKU と料金は変更される可能性があります。
NARROW_ROAD_INFO_ON_POLYLINE ルートの狭い道路の情報。この情報を返すには、routes.polyline_details.narrow_road_info フィールド マスクを指定する必要があります。現在、このデータはインドの一部の都市でのみ入力されます。この機能は試験運用版であり、SKU と料金は変更される可能性があります。

ルート

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

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)

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

distanceMeters

integer

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

duration

string (Duration format)

ルートのナビゲーションに必要な時間。routingPreferenceTRAFFIC_UNAWARE に設定した場合、この値は staticDuration と同じになります。routingPreferenceTRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL に設定すると、この値は交通状況を考慮して計算されます。

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

localizedValues

object (RouteLocalizedValues)

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

routeToken

string

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

注: Route.route_token は、ComputeRoutesRequest.routing_preferenceTRAFFIC_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)

区間を移動するのに必要な時間。route_preferenceTRAFFIC_UNAWARE に設定されている場合、この値は staticDuration と同じです。route_preferenceTRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL の場合、この値はトラフィック状況を考慮して計算されます。

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 表現
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
フィールド
共用体フィールド polyline_type。ポリラインのタイプをカプセル化します。デフォルトは encoded_polyline です。polyline_type は次のいずれかになります。
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 道路名の変更を示すために使用されます。

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)

同じ場所における現時点での推定出発間隔を指定します。たとえば、headway seconds の値が 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 に有料道路がある場合にのみ入力されます。このフィールドが設定されていても estimatedPrice サブフィールドが入力されていない場合、道路には有料道路が含まれているが、推定料金は不明であると想定されます。このフィールドが存在しない場合、RouteLeg に通行料金はかかりません。

speedReadingIntervals[]

object (SpeedReadingInterval)

トラフィック密度を示す高速読み取り間隔。TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL のルーティング設定の場合に適用されます。間隔は、重複することなく 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 の場合、ビューポートはその単一点で構成されます。

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

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

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

  • low.latitude > high.latitude の場合、緯度範囲は空になります。

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

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

{ "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(ゼロベースのインデックス)を含むポリラインが指定されている場合、PolylineDetails は間隔と関連するメタデータを定義します。

JSON 表現
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
フィールド
flyoverInfo[]

object (FlyoverInfo)

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

narrowRoadInfo[]

object (NarrowRoadInfo)

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

FlyoverInfo

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

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

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

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

RoadFeatureState

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

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

PolylinePointIndex

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

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

integer

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

endIndex

integer

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

NarrowRoadInfo

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

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

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

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