Referensi: Perjalanan
Metadata perjalanan.
Representasi JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Kolom | |
---|---|
name |
Hanya output. Dalam format "providers/{provider}/trips/{trip}" |
vehicleId |
ID kendaraan yang melakukan perjalanan ini. |
tripStatus |
Status perjalanan saat ini. |
tripType |
Jenis perjalanan. |
pickupPoint |
Lokasi tempat pelanggan menunjukkan bahwa mereka akan dijemput. |
actualPickupPoint |
Hanya input. Lokasi sebenarnya saat dan di mana pelanggan diambil. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi pengambilan yang sebenarnya. |
actualPickupArrivalPoint |
Hanya input. Waktu dan lokasi sebenarnya kedatangan pengemudi di titik penjemputan. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi kedatangan sebenarnya di titik pengambilan. |
pickupTime |
Hanya output. Perkiraan waktu mendatang saat penumpang akan dijemput, atau waktu sebenarnya saat mereka dijemput. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
intermediateDestinations[] |
Perhentian menengah dalam urutan permintaan perjalanan (selain pengangkutan dan penurunan penumpang). Awalnya, parameter ini tidak akan didukung untuk perjalanan bersama. |
intermediateDestinationsVersion |
Menunjukkan kapan terakhir kali Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
intermediateDestinationIndex |
Jika |
actualIntermediateDestinationArrivalPoints[] |
Hanya input. Waktu sebenarnya dan lokasi kedatangan pengemudi di tujuan perantara. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi kedatangan aktual di tujuan perantara. |
actualIntermediateDestinations[] |
Hanya input. Waktu dan lokasi sebenarnya kapan dan di mana pelanggan dijemput dari tujuan perantara. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi pengambilan yang sebenarnya di tujuan perantara. |
dropoffPoint |
Lokasi tempat pelanggan menunjukkan bahwa mereka akan diantarkan. |
actualDropoffPoint |
Hanya input. Waktu dan lokasi aktual saat pelanggan dikembalikan. Kolom ini digunakan untuk memberikan masukan tentang informasi pengantaran yang sebenarnya. |
dropoffTime |
Hanya output. Perkiraan waktu mendatang saat penumpang akan diturunkan di tujuan akhir, atau waktu sebenarnya saat mereka diantar. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
remainingWaypoints[] |
Hanya output. Jalur lengkap dari lokasi saat ini ke titik penurunan, inklusif. Jalur ini bisa menyertakan titik jalan dari perjalanan lain. |
vehicleWaypoints[] |
Kolom ini mendukung pengurutan titik jalan secara manual untuk perjalanan. Isinya adalah semua titik jalan yang tersisa untuk kendaraan yang ditetapkan, serta titik jalan penjemputan dan penurunan untuk perjalanan ini. Jika perjalanan belum ditetapkan untuk kendaraan, Fleet Engine akan mengabaikan kolom ini. Untuk alasan privasi, kolom ini hanya diisi oleh server pada panggilan |
route[] |
Hanya output. Rute yang diperkirakan untuk perjalanan ini ke entri pertama di sisaWaypoints. Perhatikan, titik jalan pertama mungkin milik perjalanan yang berbeda. |
currentRouteSegment |
Hanya output. Jalur yang dienkode ke titik jalan berikutnya. Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK. Decoding belum didukung. |
currentRouteSegmentVersion |
Hanya output. Menunjukkan waktu terakhir kali rute diubah. Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
currentRouteSegmentTraffic |
Hanya output. Menunjukkan kondisi lalu lintas di sepanjang Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK. |
currentRouteSegmentTrafficVersion |
Hanya output. Menunjukkan kapan terakhir kali Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK dan Consumer SDK. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
currentRouteSegmentEndPoint |
Hanya output. Titik jalan tempat |
remainingDistanceMeters |
Hanya output. Sisa jarak mengemudi di kolom |
etaToFirstWaypoint |
Hanya output. PWT ke titik jalan berikutnya (entri pertama di kolom Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
remainingTimeToFirstWaypoint |
Hanya output. Durasi dari saat data Perjalanan ditampilkan ke waktu di Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
remainingWaypointsVersion |
Hanya output. Menunjukkan waktu terakhir kali Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
remainingWaypointsRouteVersion |
Hanya output. Menunjukkan kapan terakhir kali Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
numberOfPassengers |
Tidak dapat diubah. Menunjukkan jumlah penumpang pada perjalanan ini dan tidak termasuk pengemudi. Kendaraan harus memiliki kapasitas yang tersedia untuk ditampilkan dalam respons |
lastLocation |
Hanya output. Menunjukkan lokasi terakhir kendaraan yang dilaporkan di sepanjang rute. |
lastLocationSnappable |
Hanya output. Menunjukkan apakah |
view |
Subset kolom Perjalanan yang diisi dan cara menafsirkannya. |
TripStatus
Status perjalanan yang menunjukkan progresnya.
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Default, digunakan untuk status perjalanan yang tidak ditentukan atau tidak dikenal. |
NEW |
Perjalanan yang baru dibuat. |
ENROUTE_TO_PICKUP |
Pengemudi sedang dalam perjalanan ke lokasi penjemputan. |
ARRIVED_AT_PICKUP |
Pengemudi telah tiba di titik penjemputan. |
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 pengambilan oleh pengemudi, penumpang, atau penyedia transportasi online. |
StopLocation
Lokasi sebenarnya tempat perhentian (pengambilan/penurunan) terjadi.
Representasi JSON |
---|
{
"point": {
object ( |
Kolom | |
---|---|
point |
Wajib. Menunjukkan lokasi sebenarnya. |
timestamp |
Menunjukkan waktu penghentian terjadi. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
stopTime |
Hanya input. Tidak digunakan lagi. Gunakan kolom stempel waktu. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
TripView
Pemilih untuk kumpulan kolom Perjalanan yang berbeda dalam respons trips.get
. Lihat AIP-157 untuk konteks. Penayangan lainnya kemungkinan akan ditambahkan.
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Nilai default. Untuk kompatibilitas mundur, API ini akan ditetapkan secara default ke tampilan SDK. Untuk memastikan stabilitas dan dukungan, pelanggan disarankan untuk memilih TripView selain SDK . |
SDK |
Menyertakan kolom yang mungkin tidak dapat ditafsirkan atau didukung menggunakan library yang tersedia untuk umum. |
JOURNEY_SHARING_V1S |
Kolom Perjalanan diisi untuk kasus penggunaan Berbagi Perjalanan. Tampilan ini ditujukan untuk komunikasi server ke server. |
Metode |
|
---|---|
|
Membuat perjalanan di Fleet Engine dan menampilkan perjalanan baru. |
|
Mendapatkan informasi tentang satu perjalanan. |
|
Dapatkan semua perjalanan untuk kendaraan tertentu. |
|
Memperbarui data perjalanan. |