Method: computeRoutes

リクエストされた移動手段について、リクエストされた出発地と目的地の間のメインルートを返します。

HTTP リクエスト

POST https://mapstools.googleapis.com/v1:computeRoutes

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

リクエストの本文

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

JSON 表現 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
フィールド
origin

object (Waypoint)

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

object (Waypoint)

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

enum (RouteTravelMode)

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

object (Waypoint)

省略可。出発地と目的地の間に設定する、順番に通過する中間地点。最大 25 個の中間地点がサポートされています。

10 個を超える中間地点を指定すると、費用とレイテンシが増加します。travelMode が TRANSIT の場合、中間地点はサポートされません。
routingPreference

enum (RoutingPreference)

省略可。ルートの計算に交通状況データを使用する方法を指定します。travelMode が WALK または BICYCLE の場合、ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL はサポートされません。TRANSIT の場合、遅延やキャンセルなどのリアルタイムの乗換案内データが有効になります。
locationBias

object (LatLng)

省略可。検索結果をバイアスする場所（ウェイポイントのテキストクエリの曖昧さを解消するなど）。
includePolyline

boolean

省略可。レスポンス ルートにエンコードされたポリラインを含めるかどうか。デフォルトは false です。true に設定すると、Route.encoded_polyline が返されます。
computeAlternativeRoutes

boolean

省略可。推奨ルートに加えて代替ルートを計算するかどうか。デフォルトは false で、この場合はおすすめのルートのみが返されます。true に設定すると、利用可能なすべてのルートが返されます。ただし、リクエストによっては代替ルートが利用できない場合もあります。
出発地を出発する時刻、または最終ウェイポイントに到着する時刻を指定します。指定しない場合、デフォルトは現在の時刻に出発します。TRANSIT の場合、時刻は過去 7 日以内、将来 100 日以内にする必要があります。他の移動手段の場合、時刻は過去ではなく、365 日以内にする必要があります。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
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"。
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"。
相互に排他的なフィールドの終了。

レスポンスの本文

成功した場合、レスポンスの本文には ComputeRoutesResponse のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/maps-platform.mapstools