REST Resource: projects.trips

Resource: Trip

Perjalanan.

Representasi JSON 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
Kolom
name

string

Hanya output. ID. Nama resource perjalanan. Format: projects/{project_number}/trips/{tripId}.
config

object (TripConfig)

Tidak dapat diubah. Konfigurasi untuk perjalanan.
androidAppId

string

Hanya input. Tidak dapat diubah. ID aplikasi Android dari aplikasi seluler yang akan menggunakan perjalanan. Setidaknya salah satu dari androidAppId atau iosAppId harus ditetapkan.
iosAppId

string

Hanya input. Tidak dapat diubah. ID paket iOS aplikasi seluler yang akan menggunakan perjalanan. Setidaknya salah satu dari androidAppId atau iosAppId harus ditetapkan.
authToken

object (AuthToken)

Hanya output. Token buram yang mengizinkan akses untuk memulai perjalanan NavConnect di Google Maps atau Waze dan memberikan akses ke aplikasi ini untuk memperbarui perjalanan. Hanya ditampilkan oleh trips.create.
state

enum (State)

Hanya output. Status Perjalanan.
execution

object (TripExecution)

Hanya output. Data terbaru tentang pelaksanaan perjalanan. Nilai ini mungkin tidak ditetapkan jika perjalanan dalam status error.
createTime

string (Timestamp format)

Hanya output. Waktu menurut server saat perjalanan dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu saat server menerima update perjalanan terbaru.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

TripConfig

Konfigurasi untuk perjalanan.

Representasi JSON 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string
}
Kolom
enableHighFrequencyUpdates

boolean

Opsional. Apakah akan mengaktifkan pembaruan perjalanan berfrekuensi tinggi.

CATATAN: Mengaktifkan fitur ini akan mencatat perjalanan dalam penggunaan Tingkat Perusahaan, dan tunduk pada tarif Tingkat Perusahaan.
enablePubsub

boolean

Opsional. Apakah akan mengaktifkan notifikasi pubsub untuk perjalanan.
pubsubFieldMask

string (FieldMask format)

Opsional. Jika disetel, hanya subset kolom Perjalanan yang ditentukan yang akan disertakan dalam notifikasi pubsub.

Jika tidak disetel, semua kolom Perjalanan akan disertakan dalam notifikasi pubsub (perilaku default).

Kolom berikut tidak didukung:

  • androidAppId
  • iosAppId
  • authToken
  • config

CATATAN: Kolom ini diabaikan jika enablePubsub bernilai false.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

AuthToken

Token autentikasi.

Representasi JSON 
{
  "token": string,
  "expireTime": string
}
Kolom
token

string

Hanya output. Token autentikasi yang harus diteruskan ke aplikasi seluler.
expireTime

string (Timestamp format)

Hanya output. Waktu saat token autentikasi akan berakhir masa berlakunya.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Negara Bagian

Semua kemungkinan status perjalanan.

Enum
STATE_UNSPECIFIED Status perjalanan tidak ditentukan.
NEW Perjalanan telah dibuat, tetapi belum dimulai.
ENROUTE Pengangkut sedang dalam perjalanan ke tujuan.
ARRIVED Pengangkut tiba di tujuan.
SUSPENDED Perjalanan ditangguhkan.
FAILED Perjalanan gagal diselesaikan dengan sukses.
CLIENT_ERROR Perjalanan gagal karena error klien.

TripExecution

Data tentang pelaksanaan perjalanan.

Representasi JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Kolom
origin

object (Location)

Hanya output. Asal perjalanan yang umumnya merupakan lokasi transporter saat memulai perjalanan NavConnect.
destination

object (Stop)

Hanya output. Tujuan perjalanan seperti yang dilaporkan oleh aplikasi seluler.
location

object (Location)

Hanya output. Sinyal lokasi yang mewakili lokasi terakhir yang diketahui dari transporter. Ini akan menjadi lokasi yang disesuaikan dengan jalan jika tersedia.
traveledDuration

string (Duration format)

Hanya output. Waktu perjalanan sejauh ini.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
remainingDuration

string (Duration format)

Hanya output. Sisa waktu perjalanan ini seperti yang diperkirakan oleh Google.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
traveledDistanceMeters

integer

Hanya output. Jarak yang ditempuh dari asal dalam meter.
remainingDistanceMeters

integer

Hanya output. Jarak yang tersisa ke tujuan dalam meter.
stopAddedInRoute

boolean

Hanya output. Menunjukkan apakah perhentian ditambahkan di sepanjang rute.

Lokasi

Lokasi seperti yang dilaporkan oleh aplikasi seluler.

Representasi JSON 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Kolom
point

object (LatLng)

Hanya output. Lintang/bujur lokasi.
sourceTime

string (Timestamp format)

Hanya output. Waktu saat lokasi diperoleh sebagaimana ditunjukkan oleh klien.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

Hanya output. Waktu saat server menerima update lokasi ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

Hentikan

Perhentian dalam perjalanan di mana beberapa tugas harus dilakukan.

Representasi JSON 
{
  "point": {
    object (LatLng)
  }
}
Kolom
point

object (LatLng)

Wajib. Lokasi perhentian sebagai lintang/bujur.

Metode

create

 Membuat perjalanan.

get

 Mendapatkan perjalanan.