Method: computeRoutes

ターミナルと中間のウェイポイントのセットを基に、メイン ルートとオプションの代替ルートを返します。

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

たとえば、このメソッドの場合は次のようになります。

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

ワイルドカード(*)レスポンス フィールド マスクの使用や、トップレベルでのフィールド マスク(routes)の指定は、次の理由からおすすめしません。

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

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 日間まで利用できます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

arrivalTime

string (Timestamp format)

(省略可)到着時刻。注: RouteTravelModeTRANSIT に設定されている場合にのみ設定できます。departureTime または arrivalTime のいずれかを指定できます。両方を指定することはできません。交通機関のルートは、過去 7 日間または未来の 100 日間まで利用できます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

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 基準ルートの計算では、燃料効率が良いルートを生成するさまざまなパラメータが考慮されます。

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

単位

表示で使用される測定単位を指定する値のセット。

列挙型
UNITS_UNSPECIFIED 測定単位が指定されていません。デフォルトは、リクエストから推定される単位です。
METRIC 指標の単位。
IMPERIAL ヤード・ポンド法の計量単位。

ReferenceRoute

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

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

ExtraComputation

リクエストの処理中に追加の計算を実行する必要があります。

列挙型
EXTRA_COMPUTATION_UNSPECIFIED 使用されません。この値を含むリクエストは失敗します。
TOLLS このルートの通行料金情報です。
FUEL_CONSUMPTION ルートの燃料消費量の推定値です。
TRAFFIC_ON_POLYLINE ルートの交通情報認識ポリライン。
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS フォーマットされた HTML テキスト文字列として表示される NavigationInstructions。このコンテンツは表示専用です。プログラムで解析しないでください。

ルート

開始地点、終了地点、中間地点を結ぶ一連の道路セグメントからなるルートが含まれます。

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
}
フィールド
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

ルートを構成する区間(地点間の経路セグメント)の集まり。各区間は、via でない 2 つの Waypoints 間のルートに対応します。たとえば、中間地点がないルートには区間が 1 つしかありません。via 以外の中間ウェイポイントが 1 つあるルートには、区間が 2 つあります。via の中間ウェイポイントが 1 つあるルートの区間は 1 つです。区間の順序は、originintermediatesdestination の地点の順序と同じです。

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

localizedValues

object (RouteLocalizedValues)

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

routeToken

string

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

RouteLabel

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

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

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)

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

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

transitLine

object (TransitLine)

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

stopCount

integer

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

tripShortText

string

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

TransitStopDetails

RouteLegStep の交通機関の停留所に関する詳細。

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

object (TransitStop)

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

arrivalTime

string (Timestamp format)

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

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

departureStop

object (TransitStop)

ステップの出発駅に関する情報。

departureTime

string (Timestamp format)

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

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

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 アベニュー ローカル」)。

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)

マルチモーダル セグメントの Navigation 指示。

travelMode

enum (RouteTravelMode)

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

stepStartIndex

integer

対応する RouteLegStep インデックス。マルチモーダル セグメントの開始を表します。

stepEndIndex

integer

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

ビューポート

緯度と経度のビューポート。2 つの対角線上の lowhigh のポイントで表されます。ビューポートは閉じた領域と見なされます。つまり、その境界が含まれます。緯度の範囲は -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)

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

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

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