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,
  "enableRemainingRouteReporting": boolean
}
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".
enableRemainingRouteReporting

boolean

Opsional. Apakah akan mengaktifkan pelaporan rute yang tersisa untuk perjalanan.

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

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/Provinsi

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.
CANCELED Perjalanan dibatalkan secara eksplisit oleh developer.

TripExecution

Data tentang pelaksanaan perjalanan.

Representasi JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "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 pengangkut. Ini akan menjadi lokasi yang disesuaikan dengan jalan jika tersedia.
remainingRoute

object (Route)

Hanya output. Menyediakan polyline untuk bagian rute yang tersisa.
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 pembaruan 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.

Rute

Polyline rute.

Representasi 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.
}
Kolom
trafficInformation[]

object (SpeedReadingInterval)

Hanya output. Informasi lalu lintas pada polyline yang dijelaskan sebagai interval pembacaan kecepatan.

CATATAN:

  • Interval tidak tumpang-tindih.
  • Interval berdekatan.
  • Interval mencakup seluruh polyline.
  • Interval diurutkan berdasarkan indeks yang meningkat.
  • Kecepatan ditentukan untuk setiap interval.

Kolom union format. Format rute.

Format yang diisi dikontrol oleh parameter route_polyline_format. Jika tidak disetel, nilai defaultnya adalah polyline sederhana. format hanya dapat berupa salah satu dari berikut:
simplePolyline

object (SimplePolyline)

Hanya output. Rute sebagai daftar sederhana latlng.
encodedPolyline

string

Hanya output. Rute sebagai polyline yang dienkode. Lihat https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
s2Polyline

string (bytes format)

Hanya output. Rute sebagai S2Polyline yang dienkode. Lihat https://s2geometry.io/devguide/basic_types.html.

String berenkode base64.
geoJson

object (Struct format)

Hanya output. Rute sebagai LineString GeoJSON. Lihat https://tools.ietf.org/html/rfc7946#section-3.1.4.

SimplePolyline

Mewakili polyline menggunakan daftar titik sederhana.

Representasi JSON 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
Kolom
points[]

object (LatLng)

Hanya output. Daftar titik yang diurutkan yang mewakili polyline.

SpeedReadingInterval

Indikator kepadatan lalu lintas pada segmen jalur yang berdekatan. Mengingat jalur dengan titik P_0, P_1, ... , P_N (indeks berbasis nol), SpeedReadingInterval menentukan interval dan mendeskripsikan traffic-nya menggunakan kategori Speed.

Representasi JSON 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
Kolom
speed

enum (Speed)

Hanya output. Kecepatan lalu lintas dalam interval ini.
startPolylinePointIndex

integer

Hanya output. Indeks awal interval ini di jalur.
endPolylinePointIndex

integer

Hanya output. Indeks akhir interval ini dalam jalur.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data lalu lintas.

Enum
SPEED_UNSPECIFIED Kecepatan tidak ditentukan.
NORMAL Kecepatan normal, tidak ada kemacetan lalu lintas.
SLOW Terdeteksi perlambatan, lalu lintas ringan hingga sedang.
TRAFFIC_JAM Keterlambatan lalu lintas, termasuk kemacetan total.

Metode

create

 Membuat perjalanan.

get

 Mendapatkan perjalanan.