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)

省略可。出発時刻。この値を設定しない場合、この値はデフォルトでリクエストを行った時刻になります。注: 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 の duration フィールドに返される値に影響します。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 燃料効率が良いルート。この値でラベル付けされたルートは、燃料消費量などのパラメータに対して最適化されていると判断されます。

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 つの区間が含まれます。1 つの via 中間地点を含むルートには 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 は、Via の地点を含むリクエストではサポートされていません。

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_points です。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 にカリフォルニア州サンノゼを発車するアムトラックの 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

この路線の正式名称(例: 「東京都渋谷区渋谷 3-21-3」)。

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 で有料道路があると予想される場合にのみ入力されます。このフィールドが設定されていても、estimatesPrice サブフィールドに入力されていない場合は、道路に有料道路が含まれていることが予想されますが、推定料金はわかりません。このフィールドが存在しない場合、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 個以上のタイプタグの形式で指定します。サポートされているタイプ: 住所タイプと住所コンポーネント タイプ

partialMatch

boolean

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

placeId

string

この結果のプレイス ID。

intermediateWaypointRequestIndex

integer

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