REST Resource: projects.trips

リソース: Trip

旅行。

JSON 表現 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
フィールド
name

string

出力専用。ID。乗車のリソース名。形式: projects/{project_number}/trips/{tripId}。
config

object (TripConfig)

変更不可。乗車に関する構成。
androidAppId

string

入力専用。変更不可。旅行を使用するモバイル アプリケーションの Android アプリケーション ID。androidAppId または iosAppId の少なくとも 1 つを設定する必要があります。
iosAppId

string

入力専用。変更不可。乗車情報を使用するモバイル アプリケーションの iOS バンドル ID。androidAppId または iosAppId の少なくとも 1 つを設定する必要があります。
authToken

object (AuthToken)

出力専用。Google マップまたは Waze で NavConnect のルートを開始するアクセスを承認し、これらのアプリケーションにルートを更新するアクセス権を付与する不透明なトークン。trips.create によってのみ返されます。
state

enum (State)

出力専用。乗車ステータス。
execution

object (TripExecution)

出力専用。ルートの実行に関する最新のデータ。乗車がエラー状態の場合、この値は設定されないことがあります。
createTime

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"。
updateTime

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"。

TripConfig

旅行の構成。

JSON 表現 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string,
  "enableRemainingRouteReporting": boolean
}
フィールド
enableHighFrequencyUpdates

boolean

省略可。高頻度の乗車情報更新を有効にするかどうか。

注: この機能を有効にすると、乗車は Enterprise ティアの使用量として記録され、Enterprise ティアの料金が適用されます。
enablePubsub

boolean

省略可。乗車に関する Pub/Sub 通知を有効にするかどうか。
pubsubFieldMask

string (FieldMask format)

省略可。設定されている場合、指定された Trip フィールドのサブセットのみが pubsub 通知に含まれます。

設定しない場合、すべての Trip フィールドが Pub/Sub 通知に含まれます（デフォルトの動作）。

次のフィールドはサポートされていません。

  • androidAppId
  • iosAppId
  • authToken
  • config

注: enablePubsub が false の場合、このフィールドは無視されます。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
enableRemainingRouteReporting

boolean

省略可。乗車中の残りのルートのレポートを有効にするかどうか。

注: この機能を有効にすると、乗車は Enterprise ティアの使用状況として記録され、Enterprise ティアの料金が適用されます。

AuthToken

認証トークン。

JSON 表現 
{
  "token": string,
  "expireTime": string
}
フィールド
token

string

出力専用。モバイル アプリケーションに渡す必要がある認証トークン。
expireTime

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"。

州

考えられるすべての乗車状態。

列挙型
STATE_UNSPECIFIED 乗車状態が指定されていません。
NEW 旅行は作成されましたが、まだ開始されていません。
ENROUTE 輸送業者が目的地に向かっています。
ARRIVED 運送業者が目的地に到着しました。
SUSPENDED 旅行が一時停止されました。
FAILED 乗車が正常に完了しませんでした。
CLIENT_ERROR クライアント エラーのため、乗車を完了できませんでした。
CANCELED 乗車はデベロッパーによって明示的にキャンセルされました。

TripExecution

ルートの実行に関するデータ。

JSON 表現 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
フィールド
origin

object (Location)

出力専用。ルートの出発地。通常は、NavConnect ルートの開始時の運送業者の所在地です。
destination

object (Stop)

出力専用。モバイル アプリケーションから報告された旅行の目的地。
location

object (Location)

出力専用。運送業者の直近の位置情報を表す位置情報シグナル。利用可能な場合は、道路にスナップされた位置になります。
remainingRoute

object (Route)

出力専用。ルートの残りの部分のポリラインを提供します。
traveledDuration

string (Duration format)

出力専用。これまでの移動時間。

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

string (Duration format)

出力専用。Google が推定したこの経路の残り時間。

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

integer

出力専用。原点からの移動距離（メートル単位）。
remainingDistanceMeters

integer

出力専用。目的地までの残り距離（メートル単位）。
stopAddedInRoute

boolean

出力専用。ルートに経由地が追加されたかどうかを示します。

場所

モバイル アプリケーションから報告された位置情報。

JSON 表現 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
フィールド
point

object (LatLng)

出力専用。位置の緯度/経度。
sourceTime

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"。
serverTime

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"。

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

JSON 表現 
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。
longitude

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

停止

ルート内の停車地。ここでタスクが実行されます。

JSON 表現 
{
  "point": {
    object (LatLng)
  }
}
フィールド
point

object (LatLng)

必須。停留所の位置（緯度/経度）。

ルート

ルートのポリライン。

JSON 表現 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
フィールド
trafficInformation[]

object (SpeedReadingInterval)

出力専用。速度読み取り間隔として記述されたポリラインの交通情報。

注:

  • 期間は重複していません。
  • 間隔は連続しています。
  • 間隔はポリライン全体をカバーします。
  • 間隔はインデックスの昇順で並べ替えられます。
  • 速度は各間隔で指定されます。

共用体フィールド format。ルートの形式。

入力される形式は route_polyline_format パラメータによって制御されます。設定しない場合、デフォルトは単純なポリラインになります。format は次のいずれかになります。
simplePolyline

object (SimplePolyline)

出力専用。ルートを latlng の単純なリストとして表します。
encodedPolyline

string

出力専用。エンコードされたポリラインとしてのルート。https://developers.google.com/maps/documentation/utilities/polylinealgorithm をご覧ください。
s2Polyline

string (bytes format)

出力専用。エンコードされた S2Polyline としてのルート。https://s2geometry.io/devguide/basic_types.html をご覧ください。

Base64 でエンコードされた文字列。
geoJson

object (Struct format)

出力専用。GeoJSON LineString としてのルート。https://tools.ietf.org/html/rfc7946#section-3.1.4 をご覧ください。

SimplePolyline

ポイントのシンプルなリストを使用してポリラインを表します。

JSON 表現 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
フィールド
points[]

object (LatLng)

出力専用。ポリラインを表す点の順序付きリスト。

SpeedReadingInterval

パスの連続するセグメントの交通密度インジケーター。ポイント P_0、P_1、...、P_N（ゼロベースのインデックス）を含むパスが指定された場合、SpeedReadingInterval は間隔を定義し、Speed カテゴリを使用してそのトラフィックを記述します。

JSON 表現 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
フィールド
speed

enum (Speed)

出力専用。この間隔の交通速度。
startPolylinePointIndex

integer

出力専用。パス内のこの間隔の開始インデックス。
endPolylinePointIndex

integer

出力専用。パス内のこの間隔の終了インデックス。

速度

交通データに基づくポリラインの速度の分類。

列挙型
SPEED_UNSPECIFIED 速度が指定されていません。
NORMAL 通常の速度で、渋滞はありません。
SLOW 渋滞気味です。交通量は少ない～やや多いです。
TRAFFIC_JAM 交通の遅延（渋滞を含む）。

メソッド

create

 ルートを作成します。

get

 ルートを取得します。