REST Resource: providers.trips

Resource: Perjalanan

Metadata perjalanan.

Representasi JSON 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
Kolom
name

string

Hanya output. Dalam format "providers/{provider}/trips/{trip}"
vehicleId

string

ID kendaraan yang melakukan perjalanan ini.
tripStatus

enum (TripStatus)

Status perjalanan saat ini.
tripType

enum (TripType)

Jenis perjalanan.
pickupPoint

object (TerminalLocation)

Lokasi tempat pelanggan menunjukkan bahwa mereka akan dijemput.
actualPickupPoint

object (StopLocation)

Hanya input. Lokasi sebenarnya saat dan tempat pelanggan dijemput. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi pengambilan yang sebenarnya.
actualPickupArrivalPoint

object (StopLocation)

Hanya input. Waktu dan lokasi sebenarnya saat pengemudi tiba di titik penjemputan. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi kedatangan sebenarnya di titik penjemputan.
pickupTime

string (Timestamp format)

Hanya output. Perkiraan waktu mendatang saat penumpang akan dijemput, atau waktu sebenarnya saat mereka dijemput.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
intermediateDestinations[]

object (TerminalLocation)

Perhentian perantara untuk permintaan perjalanan (selain pengambilan dan pengantaran). Awalnya, fitur ini tidak akan didukung untuk perjalanan bersama.
intermediateDestinationsVersion

string (Timestamp format)

Menunjukkan kapan terakhir kali intermediateDestinations diubah. Server Anda harus meng-cache nilai ini dan meneruskannya di UpdateTripRequest saat mengupdate intermediateDestinationIndex untuk memastikan intermediateDestinations tidak berubah.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
intermediateDestinationIndex

integer

Jika TripStatus adalah ENROUTE_TO_INTERMEDIATE_DESTINATION, angka antara [0..N-1] yang menunjukkan tujuan perantara mana yang akan dilintasi kendaraan berikutnya. Jika TripStatus adalah ARRIVED_AT_INTERMEDIATE_DESTINATION, angka antara [0..N-1] yang menunjukkan tujuan perantara tempat kendaraan berada. Penyedia menetapkan nilai ini. Jika tidak ada intermediateDestinations, kolom ini akan diabaikan.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

Hanya input. Waktu dan lokasi sebenarnya saat pengemudi tiba di tujuan perantara. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi kedatangan sebenarnya di tujuan perantara.
actualIntermediateDestinations[]

object (StopLocation)

Hanya input. Waktu dan lokasi sebenarnya saat dan tempat pelanggan dijemput dari tujuan perantara. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi pengambilan yang sebenarnya di tujuan perantara.
dropoffPoint

object (TerminalLocation)

Lokasi tempat pelanggan menunjukkan bahwa mereka akan diturunkan.
actualDropoffPoint

object (StopLocation)

Hanya input. Waktu dan lokasi sebenarnya saat dan tempat pelanggan diturunkan. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi penurunan sebenarnya.
dropoffTime

string (Timestamp format)

Hanya output. Perkiraan waktu mendatang saat penumpang akan diturunkan di tujuan akhir, atau waktu sebenarnya saat mereka diturunkan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
remainingWaypoints[]

object (TripWaypoint)

Hanya output. Jalur lengkap dari lokasi saat ini ke titik penurunan, inklusif. Jalur ini dapat mencakup titik jalan dari perjalanan lain.
vehicleWaypoints[]

object (TripWaypoint)

Kolom ini mendukung pengurutan manual titik jalan untuk perjalanan. File ini berisi semua titik perhentian yang tersisa untuk kendaraan yang ditetapkan, serta titik perhentian pengambilan dan pengantaran untuk perjalanan ini. Jika perjalanan belum ditetapkan ke kendaraan, Fleet Engine akan mengabaikan kolom ini. Karena alasan privasi, kolom ini hanya diisi oleh server pada panggilan trips.update dan trips.create, BUKAN pada panggilan trips.get.
route[]

object (LatLng)

Hanya output. Rute yang diperkirakan untuk perjalanan ini ke entri pertama di remainingWaypoints. Perhatikan bahwa titik jalan pertama mungkin milik perjalanan yang berbeda.
currentRouteSegment

string

Hanya output. Jalur yang dienkode ke titik jalan berikutnya.

Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK. Dekode belum didukung.
currentRouteSegmentVersion

string (Timestamp format)

Hanya output. Menunjukkan kapan terakhir kali rute diubah.

Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Hanya output. Menunjukkan kondisi lalu lintas di sepanjang currentRouteSegment jika tersedia.

Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Hanya output. Menunjukkan kapan terakhir kali currentRouteSegmentTraffic diubah.

Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
currentRouteSegmentEndPoint

object (TripWaypoint)

Hanya output. Titik jalan tempat currentRouteSegment berakhir.
remainingDistanceMeters

integer

Hanya output. Jarak mengemudi yang tersisa di kolom currentRouteSegment. Nilai tidak ditentukan jika perjalanan tidak ditetapkan ke kendaraan, atau perjalanan selesai atau dibatalkan.
etaToFirstWaypoint

string (Timestamp format)

Hanya output. Perkiraan waktu tiba ke titik jalan berikutnya (entri pertama di kolom remainingWaypoints). Nilai tidak ditentukan jika perjalanan tidak ditetapkan ke kendaraan, atau perjalanan tidak aktif (selesai atau dibatalkan).

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
remainingTimeToFirstWaypoint

string (Duration format)

Hanya output. Durasi sejak data Perjalanan ditampilkan hingga waktu di Trip.eta_to_first_waypoint. Nilai tidak ditentukan jika perjalanan tidak ditetapkan ke kendaraan, atau perjalanan tidak aktif (selesai atau dibatalkan).

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

string (Timestamp format)

Hanya output. Menunjukkan kapan terakhir kali remainingWaypoints diubah (titik jalan ditambahkan, dihapus, atau diubah).

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
remainingWaypointsRouteVersion

string (Timestamp format)

Hanya output. Menunjukkan kapan terakhir kali remainingWaypoints.path_to_waypoint dan remainingWaypoints.traffic_to_waypoint diubah. Aplikasi klien Anda harus meng-cache nilai ini dan meneruskannya di GetTripRequest untuk memastikan jalur dan traffic untuk remainingWaypoints hanya ditampilkan jika diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
numberOfPassengers

integer

Tidak dapat diubah. Menunjukkan jumlah penumpang dalam perjalanan ini dan tidak termasuk pengemudi. Kendaraan harus memiliki kapasitas yang tersedia untuk ditampilkan dalam respons vehicles.search.
lastLocation

object (VehicleLocation)

Hanya output. Menunjukkan lokasi terakhir yang dilaporkan kendaraan di sepanjang rute.
lastLocationSnappable

boolean

Hanya output. Menunjukkan apakah lastLocation kendaraan dapat disambungkan ke currentRouteSegment. Salah jika lastLocation atau currentRouteSegment tidak ada. Nilai ini dihitung oleh Fleet Engine. Setiap pembaruan dari klien akan diabaikan.
view

enum (TripView)

Subkumpulan kolom Perjalanan yang diisi dan cara penafsirannya.

TripStatus

Status perjalanan yang menunjukkan progresnya.

Enum
UNKNOWN_TRIP_STATUS Default, digunakan untuk status perjalanan yang tidak ditentukan atau tidak dikenali.
NEW Perjalanan yang baru dibuat.
ENROUTE_TO_PICKUP Pengemudi sedang dalam perjalanan ke titik pengambilan.
ARRIVED_AT_PICKUP Pengemudi telah tiba di titik pengambilan.
ARRIVED_AT_INTERMEDIATE_DESTINATION Pengemudi telah tiba di tujuan perantara dan sedang menunggu penumpang.
ENROUTE_TO_INTERMEDIATE_DESTINATION Pengemudi sedang dalam perjalanan ke tujuan perantara (bukan titik penurunan).
ENROUTE_TO_DROPOFF Pengemudi telah menjemput penumpang dan sedang dalam perjalanan ke tujuan berikutnya.
COMPLETE Penumpang telah diturunkan dan perjalanan selesai.
CANCELED Perjalanan dibatalkan sebelum penjemputan oleh pengemudi, penumpang, atau penyedia transportasi online.

StopLocation

Lokasi sebenarnya tempat perhentian (pengambilan/penurunan) terjadi.

Representasi JSON 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Kolom
point

object (LatLng)

Wajib. Menunjukkan lokasi sebenarnya.
timestamp

string (Timestamp format)

Menunjukkan kapan perhentian terjadi.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".
stopTime
(deprecated)

string (Timestamp format)

Hanya input. Tidak digunakan lagi. Gunakan kolom stempel waktu.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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".

TripView

Pemilih untuk berbagai kumpulan kolom Perjalanan dalam respons trips.get. Lihat AIP-157 untuk mengetahui konteksnya. Tampilan tambahan kemungkinan akan ditambahkan.

Enum
TRIP_VIEW_UNSPECIFIED Nilai default. Untuk kompatibilitas mundur, API akan ditetapkan secara default ke tampilan SDK. Untuk memastikan stabilitas dan dukungan, pelanggan disarankan untuk memilih TripView selain SDK.
SDK Mencakup kolom yang mungkin tidak dapat ditafsirkan atau didukung menggunakan library yang tersedia secara publik.
JOURNEY_SHARING_V1S Kolom Perjalanan diisi untuk kasus penggunaan Perjalanan Bersama. Tampilan ini ditujukan untuk komunikasi server ke server.

Metode

create

 Membuat perjalanan di Fleet Engine dan menampilkan perjalanan baru.

delete

 Menghapus satu Perjalanan.

get

 Mendapatkan informasi tentang satu perjalanan.
Mendapatkan semua perjalanan untuk kendaraan tertentu.

update

 Memperbarui data perjalanan.