Package maps.fleetengine.v1

BatteryStatus

Status baterai, baik penuh maupun sedang diisi dayanya, dll.

PowerSource

Status sumber daya baterai.

float

Persentase baterai saat ini [0-100].

SpeedReadingInterval

Kecepatan lalu lintas di sepanjang jalur dari titik jalan sebelumnya ke titik jalan saat ini.

string

Jalur yang diambil pengemudi dari titik jalan sebelumnya ke titik jalan saat ini. Jalur ini memiliki penanda sehingga klien dapat menampilkan penanda lalu lintas di sepanjang jalur (lihat speed_reading_interval). Dekode belum didukung.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

string

Wajib. ID Perjalanan Unik. Tunduk pada batasan berikut:

• Harus berupa string Unicode yang valid.
• Dibatasi hingga maksimum 64 karakter.
• Dinormalisasi sesuai dengan Unicode Normalization Form C.
• Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', '?', ',', atau '#'.

Trip

Wajib. Entitas perjalanan yang akan dibuat.

Saat membuat Perjalanan, kolom berikut diperlukan:

• trip_type
• pickup_point

Kolom berikut digunakan jika Anda memberikannya:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Semua kolom Perjalanan lainnya akan diabaikan. Misalnya, semua perjalanan dimulai dengan trip_status NEW meskipun Anda meneruskan trip_status CANCELED dalam permintaan pembuatan.

Hanya perjalanan EXCLUSIVE yang mendukung intermediate_destinations.

Jika vehicle_id ditetapkan untuk perjalanan bersama, Anda harus memberikan daftar Trip.vehicle_waypoints untuk menentukan urutan titik jalan yang tersisa untuk kendaraan. Jika tidak, urutan titik jalan tidak akan ditentukan.

Saat Anda menentukan Trip.vehicle_waypoints, daftar harus berisi semua titik jalan yang tersisa dari perjalanan kendaraan, tanpa titik jalan tambahan. Anda harus mengurutkan titik jalan ini sedemikian rupa, sehingga untuk perjalanan tertentu, titik penjemputan berada sebelum tujuan perantara, dan semua tujuan perantara ditampilkan sebelum titik pengantaran. Titik jalan perjalanan EXCLUSIVE tidak boleh disisipkan dengan perjalanan lainnya.

Kolom trip_id, waypoint_type, dan location digunakan, dan semua kolom TripWaypoint lainnya di vehicle_waypoints diabaikan.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

string

Wajib. ID Kendaraan Unik. Tunduk pada batasan berikut:

• Harus berupa string Unicode yang valid.
• Dibatasi hingga panjang maksimum 64 karakter.
• Dinormalkan menurut Formulir Normalisasi Unicode C.
• Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.

Vehicle

Wajib. Entitas Kendaraan yang akan dibuat. Saat membuat Kendaraan, kolom berikut wajib diisi:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Saat membuat Kendaraan, kolom berikut akan diabaikan:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

Semua kolom lainnya bersifat opsional dan digunakan jika disediakan.

LocationPowerSaveMode

Cara fitur lokasi disetel untuk berperilaku di perangkat saat penghemat baterai aktif.

bool

Apakah perangkat saat ini dalam mode hemat daya.

bool

Apakah perangkat berada dalam status interaktif.

BatteryInfo

Informasi tentang status baterai.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}/trips/{trip}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) Project Google Cloud tempat akun layanan yang melakukan panggilan ini menjadi anggota.

TripView

Subkumpulan kolom Perjalanan yang harus ditampilkan dan interpretasinya.

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) tempat data Trip.route atau Trip.current_route_segment diambil. Jika data rute tidak berubah sejak stempel waktu ini, kolom rute tidak akan ditetapkan dalam respons. Jika minimum tidak ditentukan, data rute akan selalu diambil.

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) yang digunakan untuk mengambil Trip.remaining_waypoints. Jika tidak berubah sejak stempel waktu ini, remaining_waypoints tidak ditetapkan dalam respons. Jika kolom ini tidak ditentukan, remaining_waypoints akan selalu diambil.

PolylineFormatType

Format rute saat ini yang ditampilkan, LAT_LNG_LIST_TYPE (di Trip.route), atau ENCODED_POLYLINE_TYPE (di Trip.current_route_segment). Default-nya adalah LAT_LNG_LIST_TYPE.

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) yang diambil Trip.current_route_segment_traffic. Jika data traffic tidak berubah sejak stempel waktu ini, kolom current_route_segment_traffic tidak ditetapkan dalam respons. Jika nilai minimum tidak ditentukan, data traffic akan selalu diambil. Perhatikan bahwa traffic hanya tersedia untuk pelanggan Solusi Pengiriman dan Perjalanan On-Demand.

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) tempat data Trip.remaining_waypoints.traffic_to_waypoint dan Trip.remaining_waypoints.path_to_waypoint diambil. Jika data tidak berubah sejak stempel waktu ini, kolom di atas tidak ditetapkan dalam respons. Jika remaining_waypoints_route_version tidak ditentukan, traffic dan jalur selalu diambil.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}/vehicles/{vehicle}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) Project Google Cloud tempat akun layanan yang melakukan panggilan ini menjadi anggota.

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) yang diambil Vehicle.current_route_segment. Jika rute tidak berubah sejak stempel waktu ini, kolom current_route_segment tidak ditetapkan dalam respons. Jika nilai minimum tidak ditentukan, current_route_segment akan selalu diambil.

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) tempat data Vehicle.waypoints diambil. Jika titik jalan tidak berubah sejak stempel waktu ini, data vehicle.waypoints tidak ditetapkan dalam respons. Jika kolom ini tidak ditentukan, vehicle.waypoints akan selalu diambil.

string

Wajib. Kode Negara/Wilayah CLDR. Misalnya, US untuk Amerika Serikat, atau IN untuk India.

string

Digit terakhir pelat nomor atau "-1" untuk menunjukkan bahwa tidak ada nilai numerik di pelat nomor.

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

int32

Jumlah maksimum kendaraan yang akan ditampilkan. Nilai default: 100.

string

Nilai next_page_token yang diberikan oleh panggilan sebelumnya ke ListVehicles sehingga Anda dapat membuat penomoran halaman melalui grup kendaraan. Nilai tidak ditentukan jika kriteria filter permintaan tidak sama dengan kriteria filter untuk panggilan sebelumnya ke ListVehicles.

Int32Value

Menentukan kapasitas minimum kendaraan yang diperlukan. Semua kendaraan yang dikembalikan akan memiliki maximum_capacity lebih besar dari atau sama dengan nilai ini. Jika ditetapkan, harus lebih besar dari atau sama dengan 0.

TripType

Membatasi respons ke kendaraan yang mendukung setidaknya salah satu jenis perjalanan yang ditentukan.

Duration

Membatasi respons ke kendaraan yang telah mengirim pembaruan lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan statis yang masih mengirimkan lokasinya tidak dianggap usang. Jika ada, harus berupa durasi positif yang valid.

Category

Wajib. Membatasi respons untuk kendaraan dengan salah satu kategori jenis yang ditentukan. UNKNOWN tidak diizinkan.

string

Pemanggil dapat membentuk operasi logika yang kompleks menggunakan kombinasi kolom required_attributes, required_one_of_attributes, dan required_one_of_attribute_sets.

required_attributes adalah daftar; required_one_of_attributes menggunakan pesan yang mengizinkan daftar daftar. Secara gabungan, kedua kolom memungkinkan komposisi ekspresi ini:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Membatasi respons ke kendaraan dengan atribut yang ditentukan. Kolom ini adalah operasi konjungsi/AND. Maksimum 50 required_attributes yang diizinkan. Jumlah ini sesuai dengan jumlah atribut maksimum yang diizinkan di kendaraan. Setiap string berulang harus memiliki format "key:value".

string

Membatasi respons ke kendaraan dengan setidaknya satu atribut yang ditentukan di setiap VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan setidaknya salah satu atribut. Kolom ini adalah operasi disjungsi/OR inklusif di setiap VehicleAttributeList dan operasi konjungsi/AND di seluruh kumpulan VehicleAttributeList. Setiap string berulang harus memiliki format "key1:value1|key2:value2|key3:value3".

string

required_one_of_attribute_sets menyediakan fungsi tambahan.

Serupa dengan required_one_of_attributes, required_one_of_attribute_sets menggunakan pesan yang mengizinkan daftar daftar, yang memungkinkan ekspresi seperti ini:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Membatasi respons ke kendaraan yang cocok dengan semua atribut dalam VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan semua atribut. Kolom ini adalah operasi konjungsi/AND di setiap VehicleAttributeList dan operasi disjungsi/OR inklusif di seluruh kumpulan VehicleAttributeList. Setiap string berulang harus dalam format "key1:value1|key2:value2|key3:value3".

VehicleState

Membatasi respons untuk kendaraan yang memiliki status kendaraan ini.

bool

Hanya menampilkan kendaraan dengan perjalanan saat ini.

string

Opsional. Kueri filter yang akan diterapkan saat mencantumkan kendaraan. Lihat http://aip.dev/160 untuk contoh sintaksis filter.

Kolom ini dirancang untuk menggantikan kolom required_attributes, required_one_of_attributes, dan required_one_of_attributes_sets. Jika nilai yang tidak kosong ditentukan di sini, kolom berikut harus kosong: required_attributes, required_one_of_attributes, dan required_one_of_attributes_sets.

Filter ini berfungsi sebagai klausa AND dengan batasan lain, seperti vehicle_state atau on_trip_only.

Perhatikan bahwa satu-satunya kueri yang didukung adalah di atribut kendaraan (misalnya, attributes.<key> = <value> atau attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Jumlah batasan maksimum yang diizinkan dalam kueri filter adalah 50.

Selain itu, semua atribut disimpan sebagai string, sehingga satu-satunya perbandingan yang didukung terhadap atribut adalah perbandingan string. Untuk membandingkan dengan nilai angka atau boolean, nilai harus dikutip secara eksplisit agar diperlakukan sebagai string (misalnya, attributes.<key> = "10" atau attributes.<key> = "true").

Viewport

Opsional. Filter yang membatasi kendaraan yang ditampilkan ke kendaraan yang lokasi terakhir yang diketahui berada di area persegi panjang yang ditentukan oleh area pandang.

Vehicle

Kendaraan yang cocok dengan kriteria dalam permintaan. Jumlah maksimum kendaraan yang ditampilkan ditentukan oleh kolom page_size dalam permintaan.

string

Token untuk mengambil halaman kendaraan berikutnya, atau kosongkan jika tidak ada lagi kendaraan yang memenuhi kriteria permintaan.

int64

Wajib. Jumlah total kendaraan yang cocok dengan kriteria permintaan di semua halaman.

string

Wajib. Harus dalam format providers/{provider}/billableTrips/{billable_trip}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

string

Wajib. Kode negara dua huruf untuk negara tempat perjalanan dilakukan. Harga ditentukan berdasarkan kode negara.

BillingPlatformIdentifier

Platform tempat permintaan dikeluarkan.

string

ID yang terkait langsung dengan perjalanan yang dilaporkan. Ini biasanya adalah ID (misalnya, ID sesi) dari operasi pra-pemesanan yang dilakukan sebelum ID perjalanan tersedia. Jumlah related_ids dibatasi hingga 50.

SolutionType

Jenis solusi produk GMP (misalnya, ON_DEMAND_RIDESHARING_AND_DELIVERIES) yang digunakan untuk perjalanan yang dilaporkan.

string

Kode bahasa BCP-47, seperti en-US atau sr-Latn. Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jika tidak ada yang ditentukan, respons dapat dalam bahasa apa pun, dengan preferensi bahasa Inggris jika nama tersebut ada. Contoh nilai kolom: en-US.

string

Wajib. Kode wilayah CLDR wilayah asal permintaan. Contoh nilai kolom: US.

string

Versi SDK panggilan, jika berlaku. Format versinya adalah "major.minor.patch", contoh: 1.1.2.

string

Versi sistem operasi tempat SDK panggilan berjalan. Contoh nilai kolom: 4.4.1, 12.1.

string

Model perangkat tempat SDK panggilan berjalan. Contoh nilai kolom: iPhone12,1, SM-G920F.

SdkType

Jenis SDK yang mengirim permintaan.

string

Versi MapSDK yang menjadi dependensi SDK panggilan, jika berlaku. Format versinya adalah "major.minor.patch", contoh: 5.2.1.

string

Versi NavSDK yang menjadi dependensi SDK panggilan, jika ada. Format versinya adalah "major.minor.patch", contoh: 2.1.0.

Platform

Platform SDK yang memanggil.

string

Produsen perangkat Android dari SDK panggilan, hanya berlaku untuk Android SDK. Contoh nilai kolom: Samsung.

int32

API level Android dari SDK panggilan, hanya berlaku untuk Android SDK. Contoh nilai kolom: 23.

string

ID opsional yang dapat diberikan untuk tujuan logging guna mengidentifikasi permintaan.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) Project Google Cloud tempat akun layanan yang melakukan panggilan ini menjadi anggota.

string

Kendaraan yang terkait dengan perjalanan dalam permintaan. Jika tidak ditentukan, perjalanan yang ditampilkan tidak akan berisi:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Jika ditetapkan ke benar (true), respons akan menyertakan Perjalanan yang memengaruhi rute pengemudi.

int32

Jika tidak disetel, server akan menentukan jumlah hasil yang akan ditampilkan.

string

Setel ini ke nilai yang sebelumnya ditampilkan di SearchTripsResponse untuk melanjutkan dari hasil sebelumnya.

Duration

Jika ditentukan, menampilkan perjalanan yang belum diperbarui setelah waktu (current - minimum_staleness).

Trip

Daftar perjalanan untuk kendaraan yang diminta.

string

Teruskan token ini di SearchTripsRequest untuk melihat hasil daftar secara berurut. API menampilkan daftar perjalanan pada setiap panggilan, dan jika tidak ada lagi hasil, daftar perjalanan akan kosong.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

TerminalLocation

Wajib. Titik penjemputan untuk menelusuri di dekat.

TerminalLocation

Lokasi pengantaran yang diinginkan pelanggan. Kolom ini wajib diisi jika trip_types berisi TripType.SHARED.

int32

Wajib. Menentukan radius penelusuran kendaraan di sekitar titik penjemputan. Hanya kendaraan dalam radius penelusuran yang akan ditampilkan. Nilai harus antara 400 dan 10.000 meter (inklusif).

int32

Wajib. Menentukan jumlah maksimum kendaraan yang akan ditampilkan. Nilai harus antara 1 dan 50 (inklusif).

int32

Wajib. Menentukan jumlah penumpang yang dipertimbangkan untuk perjalanan. Nilai harus lebih besar dari atau sama dengan satu. Driver tidak dipertimbangkan dalam nilai kapasitas.

TripType

Wajib. Merepresentasikan jenis perjalanan yang diusulkan. Harus menyertakan tepat satu jenis. UNKNOWN_TRIP_TYPE tidak diizinkan. Membatasi penelusuran hanya ke kendaraan yang dapat mendukung jenis perjalanan tersebut.

Duration

Membatasi penelusuran hanya untuk kendaraan yang telah mengirim pembaruan lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan statis yang masih mengirimkan lokasinya tidak dianggap usang. Jika kolom ini tidak disetel, server akan menggunakan lima menit sebagai nilai default.

VehicleType

Wajib. Membatasi penelusuran ke kendaraan dengan salah satu jenis yang ditentukan. Setidaknya satu jenis kendaraan harus ditentukan. VehicleType dengan kategori UNKNOWN tidak diizinkan.

VehicleAttribute

Pemanggil dapat membentuk operasi logis yang kompleks menggunakan kombinasi kolom required_attributes, required_one_of_attributes, dan required_one_of_attribute_sets.

required_attributes adalah daftar; required_one_of_attributes menggunakan pesan yang memungkinkan daftar daftar. Secara gabungan, kedua kolom memungkinkan komposisi ekspresi ini:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Membatasi penelusuran hanya untuk kendaraan dengan atribut yang ditentukan. Kolom ini adalah operasi konjungsi/AND. Jumlah atribut yang diizinkan maksimum 50 adalah 50. Jumlah ini cocok dengan jumlah maksimum atribut yang diizinkan pada kendaraan.

VehicleAttributeList

Membatasi penelusuran hanya ke kendaraan yang memiliki setidaknya satu atribut yang ditentukan di setiap VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan setidaknya salah satu atribut. Kolom ini adalah operasi disjungsi/OR inklusif di setiap VehicleAttributeList dan operasi konjungsi/AND di seluruh kumpulan VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets menyediakan fungsi tambahan.

Serupa dengan required_one_of_attributes, required_one_of_attribute_sets menggunakan pesan yang mengizinkan daftar daftar, yang memungkinkan ekspresi seperti ini:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Membatasi penelusuran hanya untuk kendaraan yang memiliki semua atribut di VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan semua atribut. Kolom ini adalah operasi konjungsi/AND di setiap VehicleAttributeList dan operasi disjungsi/OR inklusif di seluruh kumpulan VehicleAttributeList.

VehicleMatchOrder

Wajib. Menentukan kriteria pengurutan yang diinginkan untuk hasil.

bool

Ini menunjukkan apakah kendaraan dengan satu perjalanan aktif memenuhi syarat untuk penelusuran ini. Kolom ini hanya digunakan jika current_trips_present tidak ditentukan. Jika current_trips_present tidak ditentukan dan kolom ini adalah false, kendaraan dengan perjalanan yang ditetapkan akan dikecualikan dari hasil penelusuran. Jika current_trips_present tidak ditentukan dan kolom ini adalah true, hasil penelusuran dapat menyertakan kendaraan dengan satu perjalanan aktif yang memiliki status ENROUTE_TO_DROPOFF. Jika current_trips_present ditentukan, kolom ini tidak dapat ditetapkan ke benar (true).

Nilai default-nya adalah false.

string

Menunjukkan perjalanan yang terkait dengan SearchVehicleRequest ini.

CurrentTripsPresent

Detail ini menunjukkan apakah kendaraan dengan perjalanan aktif memenuhi syarat untuk penelusuran ini. Nilai ini harus disetel ke sesuatu selain CURRENT_TRIPS_PRESENT_UNSPECIFIED jika trip_type mencakup SHARED.

string

Opsional. Kueri filter yang akan diterapkan saat menelusuri kendaraan. Lihat http://aip.dev/160 untuk mengetahui contoh sintaksis filter.

Kolom ini dirancang untuk menggantikan kolom required_attributes, required_one_of_attributes, dan required_one_of_attributes_sets. Jika nilai yang tidak kosong ditentukan di sini, kolom berikut harus kosong: required_attributes, required_one_of_attributes, dan required_one_of_attributes_sets.

Filter ini berfungsi sebagai klausa AND dengan batasan lain, seperti minimum_capacity atau vehicle_types.

Perhatikan bahwa satu-satunya kueri yang didukung adalah pada atribut kendaraan (misalnya, attributes.<key> = <value> atau attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Jumlah maksimum batasan yang diizinkan dalam kueri filter adalah 50.

Selain itu, semua atribut disimpan sebagai string, sehingga satu-satunya perbandingan yang didukung terhadap atribut adalah perbandingan string. Untuk dibandingkan dengan nilai angka atau boolean, nilai harus diapit tanda kutip secara eksplisit agar diperlakukan sebagai string (misalnya, attributes.<key> = "10" atau attributes.<key> = "true").

VehicleMatch

Daftar kendaraan yang cocok dengan kriteria SearchVehiclesRequest, diurutkan menurut kolom SearchVehiclesRequest.order_by.

int32

Indeks awal interval ini di jalur. Dalam JSON, jika indeksnya 0, kolom akan tampak kosong.

int32

Indeks akhir interval ini di jalur. Di JSON, jika indeksnya adalah 0, kolom ini akan tampak tidak terisi.

Speed

Kecepatan lalu lintas dalam interval ini.

LatLng

Wajib. Menunjukkan lokasi sebenarnya.

Timestamp

Menunjukkan kapan perhentian terjadi.

Timestamp

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

LatLng

Wajib. Menunjukkan lokasi titik jalan perjalanan.

TerminalPointId

Tidak digunakan lagi: Tentukan kolom point sebagai gantinya.

string

Tidak digunakan lagi: Tentukan kolom point sebagai gantinya.

string

Tidak digunakan lagi.

WaypointType

Tidak digunakan lagi: Vehicle.waypoint akan memiliki data ini.

string

Tidak digunakan lagi.

string

Tidak digunakan lagi.

string

Tidak digunakan lagi.

VisualTrafficReportPolylineRendering

Rendering polyline yang menggambarkan kecepatan lalu lintas untuk semua region di sepanjang satu perjalanan pelanggan.

string

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

string

ID kendaraan yang melakukan perjalanan ini.

TripStatus

Status perjalanan saat ini.

TripType

Jenis perjalanan.

TerminalLocation

Lokasi yang menunjukkan bahwa pelanggan akan dijemput.

StopLocation

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

StopLocation

Input saja. Waktu dan lokasi sebenarnya pengemudi tiba di titik penjemputan. Kolom ini digunakan penyedia untuk memberikan masukan tentang informasi kedatangan sebenarnya di lokasi penjemputan.

Timestamp

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

TerminalLocation

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

Timestamp

Menunjukkan waktu terakhir intermediate_destinations diubah. Server Anda harus meng-cache nilai ini dan meneruskannya di UpdateTripRequest saat mengupdate intermediate_destination_index untuk memastikan intermediate_destinations tidak berubah.

int32

Jika TripStatus adalah ENROUTE_TO_INTERMEDIATE_DESTINATION, angka antara [0..N-1] yang menunjukkan tujuan perantara mana yang akan dilewati 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 intermediate_destinations, kolom ini akan diabaikan.

StopLocation

Hanya input. Waktu dan lokasi sebenarnya dari kedatangan pengemudi di tujuan perantara. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi kedatangan sebenarnya di tujuan perantara.

StopLocation

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

TerminalLocation

Lokasi tempat pelanggan menunjukkan bahwa mereka akan diturunkan.

StopLocation

Input saja. Waktu dan lokasi sebenarnya saat dan tempat pelanggan diturunkan. Kolom ini digunakan penyedia untuk memberikan masukan tentang informasi penurunan yang sebenarnya.

Timestamp

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

TripWaypoint

Hanya output. Jalur lengkap dari lokasi saat ini ke titik penurunan, inklusif. Jalur ini dapat menyertakan titik jalan dari perjalanan lain.

TripWaypoint

Kolom ini mendukung pengurutan manual titik jalan untuk perjalanan. Daftar ini berisi semua titik jalan yang tersisa untuk kendaraan yang ditetapkan, serta titik jalan penjemputan dan penurunan untuk perjalanan ini. Jika perjalanan belum ditetapkan ke sebuah kendaraan, Fleet Engine akan mengabaikan kolom ini. Untuk alasan privasi, kolom ini hanya diisi oleh server pada panggilan UpdateTrip dan CreateTrip, BUKAN pada panggilan GetTrip.

LatLng

Hanya output. Rute yang diantisipasi untuk perjalanan ini ke entri pertama di remaining_waypoints. Perhatikan, titik jalan pertama mungkin merupakan milik perjalanan yang berbeda.

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.

Timestamp

Hanya output. Menunjukkan waktu terakhir kali rute diubah.

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

ConsumableTrafficPolyline

Hanya output. Menunjukkan kondisi lalu lintas di sepanjang current_route_segment saat tersedia.

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

Timestamp

Hanya output. Menunjukkan kapan terakhir kali current_route_segment_traffic diubah.

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

TripWaypoint

Hanya output. Titik jalan tempat current_route_segment berakhir.

Int32Value

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

Timestamp

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

Duration

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).

Timestamp

Hanya output. Menunjukkan waktu terakhir remaining_waypoints diubah (titik jalan ditambahkan, dihapus, atau diubah).

Timestamp

Hanya output. Menunjukkan waktu terakhir remaining_waypoints.path_to_waypoint dan remaining_waypoints.traffic_to_waypoint diubah. Aplikasi klien Anda harus menyimpan nilai ini ke dalam cache dan meneruskannya dalam GetTripRequest guna memastikan jalur dan traffic untuk remaining_waypoints hanya ditampilkan jika diperbarui.

int32

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

VehicleLocation

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

bool

Hanya output. Menunjukkan apakah last_location kendaraan dapat dipaskan ke current_route_segment. Salah jika last_location atau current_route_segment tidak ada. Hal ini dihitung oleh Fleet Engine. Setiap pembaruan dari klien akan diabaikan.

TripView

Subkumpulan kolom Perjalanan yang diisi dan cara menafsirkannya.

TerminalLocation

Lokasi titik jalan ini.

string

Perjalanan yang dikaitkan dengan titik jalan ini.

WaypointType

Peran waypoint ini dalam perjalanan ini, seperti pengambilan atau pengantaran.

LatLng

Jalur dari titik jalan sebelumnya ke titik jalan saat ini. Tidak ditetapkan untuk titik jalan pertama dalam daftar. Kolom ini hanya diisi jika diminta.

string

Jalur yang dienkode dari titik jalan sebelumnya ke titik jalan saat ini.

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

ConsumableTrafficPolyline

Kondisi lalu lintas di sepanjang jalur ke titik jalan ini. Perhatikan bahwa traffic hanya tersedia untuk pelanggan Solusi Perjalanan dan Pengiriman Google Maps Platform.

Int32Value

Jarak jalur dari titik jalan sebelumnya ke titik jalan saat ini. Tidak ditentukan untuk titik jalan pertama dalam daftar.

Timestamp

Perkiraan waktu tiba di titik jalan ini. Tidak ditentukan untuk titik jalan pertama dalam daftar.

Duration

Waktu perjalanan dari titik jalan sebelumnya ke titik ini. Tidak ditetapkan untuk titik jalan pertama dalam daftar.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}/trips/{trip}. Penyedia harus berupa Project ID (misalnya, sample-consumer-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

Trip

Wajib. Perjalanan yang terkait dengan pembaruan.

Kolom berikut dikelola oleh Fleet Engine. Jangan perbarui menggunakan Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Saat memperbarui Trip.vehicle_id untuk perjalanan bersama, Anda harus memberikan daftar Trip.vehicle_waypoints untuk menentukan urutan titik jalan yang tersisa. Jika tidak, urutan tidak akan ditentukan.

Saat Anda menentukan Trip.vehicle_waypoints, daftar harus berisi semua titik jalan yang tersisa dari perjalanan kendaraan, tanpa titik jalan tambahan. Anda harus mengurutkan titik jalan ini sedemikian rupa, sehingga untuk perjalanan tertentu, titik penjemputan berada sebelum tujuan perantara, dan semua tujuan perantara ditampilkan sebelum titik pengantaran. Titik jalan perjalanan EXCLUSIVE tidak boleh disisipkan dengan perjalanan lainnya. Kolom trip_id, waypoint_type, dan location digunakan, dan semua kolom TripWaypoint lainnya di vehicle_waypoints diabaikan.

Guna menghindari kondisi balapan untuk perjalanan dengan beberapa tujuan, Anda harus memberikan Trip.intermediate_destinations_version saat memperbarui status perjalanan ke ENROUTE_TO_INTERMEDIATE_DESTINATION. Trip.intermediate_destinations_version yang diteruskan harus konsisten dengan versi Fleet Engine. Jika tidak, permintaan akan gagal.

FieldMask

Wajib. Mask kolom yang menunjukkan kolom mana di Perjalanan yang akan diperbarui. update_mask harus berisi setidaknya satu kolom.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}/vehicles/{vehicle}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini adalah anggotanya.

VehicleAttribute

Wajib. Atribut kendaraan yang akan diperbarui. Atribut yang tidak disebutkan tidak akan diubah atau dihapus.

VehicleAttribute

Wajib. Daftar lengkap atribut kendaraan yang diperbarui, termasuk atribut baru, yang diubah, dan yang tidak diubah.

RequestHeader

Header permintaan Fleet Engine standar.

string

Wajib. Harus dalam format providers/{provider}/vehicles/{vehicle}. {provider} harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini menjadi anggotanya.

Vehicle

Wajib. Nilai entity Vehicle yang akan diterapkan. Saat memperbarui Vehicle, kolom berikut mungkin tidak diperbarui karena dikelola oleh server.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Jika kolom attributes diperbarui, semua atribut kendaraan akan diganti dengan atribut yang diberikan dalam permintaan. Jika Anda hanya ingin memperbarui beberapa atribut, lihat metode UpdateVehicleAttributes.

Demikian pula, kolom waypoints dapat diperbarui, tetapi harus berisi semua titik jalan yang saat ini ada di kendaraan, dan tidak ada titik jalan lain.

FieldMask

Wajib. Mask kolom yang menunjukkan kolom Vehicle yang akan diperbarui. Anda harus memberikan setidaknya satu nama kolom.

string

Hanya output. Nama unik untuk kendaraan ini. Formatnya adalah providers/{provider}/vehicles/{vehicle}.

VehicleState

Status kendaraan.

TripType

Jenis perjalanan yang didukung oleh kendaraan ini.

string

Hanya output. Daftar trip_id untuk perjalanan yang saat ini ditetapkan ke kendaraan ini.

VehicleLocation

Lokasi terakhir yang dilaporkan kendaraan.

int32

Jumlah total penumpang yang dapat dibawa kendaraan ini. Pengemudi tidak dipertimbangkan dalam nilai ini. Nilai ini harus lebih besar dari atau sama dengan satu.

VehicleAttribute

Daftar atribut kendaraan. Kendaraan dapat memiliki maksimal 100 atribut, dan setiap atribut harus memiliki kunci yang unik.

VehicleType

Wajib. Jenis kendaraan ini. Dapat digunakan untuk memfilter kendaraan di hasil SearchVehicles. Juga memengaruhi perkiraan waktu tiba dan penghitungan rute.

LicensePlate

Informasi pelat nomor untuk kendaraan.

TerminalLocation

Tidak digunakan lagi: Gunakan Vehicle.waypoints sebagai gantinya.

string

Polyline yang menentukan rute yang ingin diambil aplikasi pengemudi ke titik jalan berikutnya. Daftar ini juga ditampilkan di Trip.current_route_segment untuk semua perjalanan aktif yang ditetapkan ke kendaraan.

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

TrafficPolylineData

Hanya input. Fleet Engine menggunakan informasi ini untuk meningkatkan kualitas berbagi perjalanan. Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK.

Timestamp

Hanya output. Waktu saat current_route_segment disetel. Nilai ini dapat disimpan oleh klien dan diteruskan dalam permintaan GetVehicle mendatang untuk mencegah rute yang ditampilkan kembali yang belum berubah.

TripWaypoint

Titik jalan tempat current_route_segment berakhir. Ini dapat disediakan oleh pengemudi pada panggilan UpdateVehicle sebagai titik jalan perjalanan lengkap, LatLng titik jalan, atau sebagai LatLng terakhir dari current_route_segment. Fleet Engine kemudian akan melakukan yang terbaik untuk melakukan interpolasi ke titik jalan yang sebenarnya jika tidak sepenuhnya ditentukan. Kolom ini diabaikan dalam panggilan UpdateVehicle kecuali jika current_route_segment juga ditentukan.

Int32Value

Jarak mengemudi yang tersisa untuk current_route_segment. Nilai ini juga ditampilkan dalam Trip.remaining_distance_meters untuk semua perjalanan aktif yang ditetapkan ke kendaraan. Nilai tidak ditentukan jika kolom current_route_segment kosong.

Timestamp

Perkiraan waktu tiba ke entri pertama di kolom waypoints. Nilai tidak ditentukan jika kolom waypoints kosong atau kolom Vehicle.current_route_segment kosong.

Saat memperbarui kendaraan, remaining_time_seconds lebih diutamakan daripada eta_to_first_waypoint dalam permintaan yang sama.

Int32Value

Input saja. Sisa waktu mengemudi untuk current_route_segment. Nilai tidak ditentukan jika kolom waypoints kosong atau kolom Vehicle.current_route_segment kosong. Nilai ini harus cocok dengan eta_to_first_waypoint - current_time jika semua pihak menggunakan jam yang sama.

Saat mengupdate kendaraan, remaining_time_seconds akan lebih diprioritaskan daripada eta_to_first_waypoint dalam permintaan yang sama.

TripWaypoint

Titik jalan yang tersisa yang ditetapkan untuk Kendaraan ini.

Timestamp

Hanya output. Terakhir kali kolom waypoints diperbarui. Klien harus meng-cache nilai ini dan meneruskannya di GetVehicleRequest untuk memastikan kolom waypoints hanya ditampilkan jika diperbarui.

bool

Menunjukkan apakah pengemudi menerima perjalanan berturut-turut. Jika true, SearchVehicles dapat menyertakan kendaraan meskipun saat ini ditetapkan ke perjalanan. Nilai defaultnya adalah false.

NavigationStatus

Status navigasi kendaraan.

DeviceSettings

Hanya input. Informasi tentang setelan di perangkat seluler yang digunakan oleh pengemudi.

Category

Kategori jenis kendaraan

string

Kunci atribut. Kunci tidak boleh berisi karakter titik dua (:).

string

Nilai atribut.

string

Nilai atribut dengan jenis string.

Catatan: Kolom ini sama dengan kolom value yang pada akhirnya tidak akan digunakan lagi. Untuk metode pembuatan atau update, kedua kolom dapat digunakan, tetapi sangat direkomendasikan untuk menggunakan string_value. Jika string_value dan value ditetapkan, keduanya harus identik atau error akan ditampilkan. Kedua kolom diisi dalam respons.

bool

Nilai atribut berjenis boolean.

double

Nilai atribut berjenis ganda.

VehicleAttribute

Daftar atribut dalam koleksi ini.

LatLng

Lokasi kendaraan. Ketika dikirim ke Fleet Engine, lokasi kendaraan adalah lokasi GPS. Saat Anda menerimanya dalam respons, lokasi kendaraan dapat berupa lokasi GPS, lokasi tambahan, atau beberapa perkiraan lokasi lainnya. Sumber ditentukan di location_sensor.

DoubleValue

Tidak digunakan lagi: Gunakan latlng_accuracy sebagai gantinya.

DoubleValue

Akurasi location dalam meter sebagai radius.

Int32Value

Arah kendaraan bergerak dalam derajat. 0 mewakili Utara. Rentang yang valid adalah [0,360).

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan heading_accuracy.

DoubleValue

Akurasi heading dalam derajat.

DoubleValue

Ketinggian dalam meter di atas WGS84.

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan altitude_accuracy.

DoubleValue

Akurasi altitude dalam meter.

Int32Value

Kecepatan kendaraan dalam kilometer per jam. Tidak digunakan lagi: Sebagai gantinya, gunakan speed.

DoubleValue

Kecepatan kendaraan dalam meter/detik

DoubleValue

Akurasi speed dalam meter/detik.

Timestamp

Waktu saat location dilaporkan oleh sensor sesuai dengan jam sensor.

Timestamp

Hanya output. Waktu saat server menerima informasi lokasi.

LocationSensor

Penyedia data lokasi (misalnya, GPS).

BoolValue

Apakah location disambungkan ke jalan.

BoolValue

Hanya input. Menunjukkan apakah sensor GPS diaktifkan pada perangkat seluler.

Int32Value

Input saja. Waktu (dalam detik) sejak lokasi ini pertama kali dikirim ke server. Nilainya akan nol untuk update pertama. Jika waktu tidak diketahui (misalnya, saat aplikasi dimulai ulang), nilai ini akan direset ke nol.

Int32Value

Input saja. Tidak digunakan lagi: Sinyal lain kini digunakan untuk menentukan apakah suatu lokasi sudah usang.

LatLng

Lokasi kendaraan mentah (belum diproses oleh perekam jalan).

Timestamp

Stempel waktu yang terkait dengan lokasi mentah.

LocationSensor

Sumber lokasi mentah. Default-nya adalah GPS.

DoubleValue

Akurasi raw_location sebagai radius, dalam meter.

LatLng

Lokasi tambahan yang disediakan oleh aplikasi integrasi.

Timestamp

Stempel waktu yang terkait dengan lokasi tambahan.

LocationSensor

Sumber lokasi tambahan. Default-nya adalah CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Akurasi supplemental_location sebagai radius, dalam meter.

bool

Tidak digunakan lagi: Gunakan is_road_snapped sebagai gantinya.

Vehicle

Wajib. Kendaraan yang sesuai dengan permintaan.

Timestamp

PWT mengemudi kendaraan ke lokasi penjemputan yang ditentukan dalam permintaan. Nilai kosong menunjukkan kegagalan dalam menghitung perkiraan waktu tiba untuk kendaraan. Jika SearchVehiclesRequest.include_back_to_back adalah true dan kendaraan ini memiliki perjalanan aktif, vehicle_pickup_eta akan menyertakan waktu yang diperlukan untuk menyelesaikan perjalanan aktif saat ini.

Int32Value

Jarak dari lokasi Kendaraan saat ini ke titik penjemputan yang ditentukan dalam permintaan, termasuk titik penjemputan atau penurunan perantara untuk perjalanan yang ada. Jarak ini terdiri dari jarak mengemudi (rute) yang dihitung, ditambah jarak garis lurus antara titik akhir navigasi dan titik penjemputan yang diminta. (Jarak antara titik akhir navigasi dan titik pengambilan yang diminta biasanya kecil.) Nilai kosong menunjukkan error dalam menghitung jarak.

Int32Value

Wajib. Jarak garis lurus antara kendaraan dan titik penjemputan yang ditentukan dalam permintaan.

Timestamp

PWT mengemudi kendaraan lengkap ke titik penurunan yang ditentukan dalam permintaan. Perkiraan waktu tiba mencakup perhentian di titik jalan mana pun sebelum dropoff_point yang ditentukan dalam permintaan. Nilai hanya akan diisi jika titik penjemputan ditentukan dalam permintaan. Nilai kosong menunjukkan error saat menghitung perkiraan waktu tiba.

Int32Value

Jarak mengemudi kendaraan (dalam meter) dari titik penjemputan ke titik penurunan yang ditentukan dalam permintaan. Jarak hanya antara dua titik dan tidak mencakup lokasi kendaraan atau titik lain yang harus dikunjungi sebelum kendaraan mengunjungi titik penjemputan atau titik pengantaran. Nilai hanya akan diisi saat dropoff_point ditentukan dalam permintaan. Nilai kosong menunjukkan kegagalan dalam menghitung jarak dari titik penjemputan ke titik penurunan yang ditentukan dalam permintaan.

TripType

Wajib. Jenis perjalanan permintaan yang digunakan untuk menghitung perkiraan waktu tiba ke titik penjemputan.

Waypoint

Daftar titik jalan yang diurutkan yang digunakan untuk menghitung PWT. Daftar ini mencakup lokasi kendaraan, titik penjemputan perjalanan aktif untuk kendaraan, dan titik penjemputan yang diberikan dalam permintaan. Daftar kosong menunjukkan kegagalan dalam menghitung PWT untuk kendaraan.

VehicleMatchType

Jenis pencocokan kendaraan.

VehicleMatchOrder

Urutan yang diminta untuk mengurutkan kecocokan kendaraan.

VehicleMatchOrder

Urutan sebenarnya yang digunakan untuk kendaraan ini. Biasanya, ini akan cocok dengan kolom 'order_by' dari permintaan; namun, dalam situasi tertentu seperti error server internal, metode lain dapat digunakan (seperti PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

Opsional. Jalan membentang yang harus dirender sepanjang polyline. Peregangan dijamin tidak akan tumpang tindih, dan tidak selalu mencakup rute penuh.

Jika tidak ada peregangan jalan untuk gaya, klien harus menerapkan default untuk rute.

Style

Wajib. Gaya yang akan diterapkan.

int32

Wajib. Gaya harus diterapkan antara [offset_meters, offset_meters + length_meters).

int32

Wajib. Panjang jalur tempat gaya diterapkan.

LatLng

Lokasi titik jalan ini.

Timestamp

Perkiraan waktu kendaraan akan tiba di titik jalan ini.