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)の指定は、次の理由からおすすめしません。

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

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)

(省略可)出発時刻。値を設定しない場合、この値はデフォルトでリクエストを行った時刻になります。注: 過去の departureTime を指定できるのは、RouteTravelModeTRANSIT に設定されている場合のみです。交通機関での移動は、過去 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 を使用して、新しい順序を確認します。ComputeRoutesResponseroutes.optimized_intermediate_waypoint_indexX-Goog-FieldMask ヘッダーでリクエストされていない場合、リクエストは失敗します。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。このコンテンツは表示専用です。プログラムで解析しないでください。

Route

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

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)

1 区間の区間で発生する可能性のある交通ゾーン制限など、ユーザーに知らせる必要がある追加情報が含まれます。

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

1 区間の区間で発生する可能性のあるトラフィック ゾーン制限など、ユーザーに知らせる必要がある追加情報が含まれます。

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)

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

travelMode

enum (RouteTravelMode)

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

stepStartIndex

integer

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

stepEndIndex

integer

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

ビューポート

lowhigh の 2 つの対角線上のポイントとして表される、緯度と経度のビューポート。ビューポートは閉じた領域(境界を含む)とみなされます。緯度の範囲は -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 個以上の type タグの形式です。サポートされている種類: 住所の種類と住所コンポーネントのタイプ

partialMatch

boolean

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

placeId

string

この結果のプレイス ID。

intermediateWaypointRequestIndex

integer

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