Package maps.fleetengine.v1

Indeks

TripService

Layanan pengelolaan perjalanan.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Membuat perjalanan di Fleet Engine dan menampilkan perjalanan baru.

DeleteTrip

rpc DeleteTrip(DeleteTripRequest) returns (Empty)

Menghapus satu Perjalanan.

Menampilkan FAILED_PRECONDITION jika Perjalanan aktif dan ditetapkan ke kendaraan.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Mendapatkan informasi tentang satu perjalanan.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Melaporkan penggunaan perjalanan yang dapat ditagih.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Mendapatkan semua perjalanan untuk kendaraan tertentu.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Memperbarui data perjalanan.

VehicleService

Layanan pengelolaan kendaraan.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Membuat instance kendaraan baru yang terkait dengan penyedia layanan berbagi tumpangan atau pengiriman on-demand. Setiap Vehicle harus memiliki ID kendaraan yang unik.

Kolom Vehicle berikut wajib diisi saat membuat Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Kolom Vehicle berikut diabaikan saat membuat Vehicle:

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

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

Menghapus Kendaraan dari Fleet Engine.

Menampilkan FAILED_PRECONDITION jika Kendaraan memiliki Perjalanan aktif yang ditetapkan untuknya.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Menampilkan kendaraan dari Fleet Engine.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Menampilkan daftar kendaraan bernomor halaman yang terkait dengan penyedia yang cocok dengan opsi permintaan.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Menampilkan daftar kendaraan yang cocok dengan opsi permintaan.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Menulis data kendaraan yang diperbarui ke Fleet Engine.

Saat memperbarui Vehicle, kolom berikut tidak dapat diperbarui karena dikelola oleh server:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Kendaraan name juga tidak dapat diupdate.

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 diupdate, tetapi harus berisi semua titik jalan yang saat ini ada di kendaraan, dan tidak ada titik jalan lain.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Memperbarui sebagian atribut kendaraan. Hanya atribut yang disebutkan dalam permintaan yang akan diperbarui, atribut lainnya TIDAK akan diubah. Catatan: hal ini berbeda di UpdateVehicle, di mana seluruh kolom attributes akan digantikan oleh kolom di UpdateVehicleRequest, dan atribut yang tidak ada dalam permintaan akan dihapus.

BatteryInfo

Informasi tentang baterai perangkat.

Kolom
battery_status

BatteryStatus

Status baterai, apakah penuh atau sedang diisi dayanya, dll.

power_source

PowerSource

Status sumber daya baterai.

battery_percentage

float

Persentase baterai saat ini [0-100].

BatteryStatus

Status baterai, apakah penuh atau sedang diisi dayanya, dll.

Enum
UNKNOWN_BATTERY_STATUS Status baterai tidak diketahui.
BATTERY_STATUS_CHARGING Baterai sedang diisi dayanya.
BATTERY_STATUS_DISCHARGING Baterai sedang dilepaskan.
BATTERY_STATUS_FULL Baterai penuh.
BATTERY_STATUS_NOT_CHARGING Baterai tidak mengisi daya.
BATTERY_STATUS_POWER_LOW Daya baterai lemah.

BillingPlatformIdentifier

Kumpulan nilai yang menunjukkan platform tempat permintaan dikeluarkan.

Enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Default. Digunakan untuk platform yang tidak ditentukan.
SERVER Platform ini adalah server klien.
WEB Platformnya adalah browser web.
ANDROID Platformnya adalah perangkat seluler Android.
IOS Platformnya adalah perangkat seluler IOS.
OTHERS Platform lain yang tidak tercantum dalam enumerasi ini.

ConsumableTrafficPolyline

Kepadatan lalu lintas di sepanjang jalur Kendaraan.

Kolom
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

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

CreateTripRequest

Pesan permintaan CreateTrip.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

trip_id

string

Wajib. ID Perjalanan Unik. Tunduk pada batasan berikut:

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

Trip

Wajib. Entitas perjalanan yang akan dibuat.

Saat membuat Perjalanan, kolom berikut wajib diisi:

  • trip_type
  • pickup_point

Kolom berikut digunakan jika Anda menyediakannya:

  • 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, atau 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 berada sebelum titik pengantaran. Titik jalan perjalanan EXCLUSIVE tidak boleh diselingi dengan perjalanan lain.

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

CreateVehicleRequest

Pesan permintaan CreateVehicle.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

vehicle_id

string

Wajib. ID Kendaraan Unik. Tunduk pada batasan berikut:

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

Vehicle

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Saat membuat Kendaraan, kolom berikut 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.

DeleteTripRequest

Pesan permintaan DeleteTrip.

Kolom
header

RequestHeader

Opsional. Header permintaan Fleet Engine standar.

name

string

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

DeleteVehicleRequest

Pesan permintaan DeleteVehicle.

Kolom
header

RequestHeader

Opsional. Header permintaan Fleet Engine standar.

name

string

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

DeviceSettings

Informasi tentang berbagai setelan di perangkat seluler.

Kolom
location_power_save_mode

LocationPowerSaveMode

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

is_power_save_mode

bool

Apakah perangkat saat ini dalam mode hemat daya.

is_interactive

bool

Apakah perangkat dalam status interaktif.

battery_info

BatteryInfo

Informasi tentang status baterai.

GetTripRequest

Pesan permintaan GetTrip.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

view

TripView

Subset kolom Perjalanan yang harus ditampilkan dan interpretasinya.

current_route_segment_version

Timestamp

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

remaining_waypoints_version
(deprecated)

Timestamp

Tidak digunakan lagi: Trip.remaining_waypoints selalu diambil. Gunakan remaining_waypoints_route_version untuk mengontrol kapan data Trip.remaining_waypoints.traffic_to_waypoint dan Trip.remaining_waypoints.path_to_waypoint diambil.

route_format_type

PolylineFormatType

Format rute saat ini yang ditampilkan, LAT_LNG_LIST_TYPE (dalam Trip.route), atau ENCODED_POLYLINE_TYPE (dalam Trip.current_route_segment). Defaultnya adalah LAT_LNG_LIST_TYPE.

current_route_segment_traffic_version

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) saat Trip.current_route_segment_traffic diambil. 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 Perjalanan dan Pengiriman Sesuai Permintaan.

remaining_waypoints_route_version

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) yang digunakan untuk mengambil data Trip.remaining_waypoints.traffic_to_waypoint dan Trip.remaining_waypoints.path_to_waypoint. 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 akan selalu diambil.

GetVehicleRequest

Pesan permintaan GetVehicle.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

current_route_segment_version

Timestamp

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

waypoints_version

Timestamp

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

LicensePlate

Informasi pelat nomor Kendaraan. Untuk menghindari penyimpanan informasi identitas pribadi, hanya informasi minimum tentang pelat nomor yang disimpan sebagai bagian dari entitas.

Kolom
country_code

string

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

last_character

string

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

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

ListVehiclesRequest

Pesan permintaan ListVehicles.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

page_size

int32

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

page_token

string

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

minimum_capacity

Int32Value

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

trip_types[]

TripType

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

maximum_staleness

Duration

Membatasi respons ke kendaraan yang telah mengirimkan update lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan yang tidak bergerak dan masih mengirimkan lokasinya tidak dianggap tidak aktif. Jika ada, harus berupa durasi positif yang valid.

vehicle_type_categories[]

Category

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

required_attributes[]

string

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. Jika digabungkan, kedua kolom ini 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. Maksimal 50 required_attributes yang diizinkan. Jumlah ini sesuai dengan jumlah maksimum atribut yang diizinkan pada kendaraan. Setiap string berulang harus dalam format "key:value".

required_one_of_attributes[]

string

Membatasi respons ke kendaraan dengan minimal 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 dalam format "key1:value1|key2:value2|key3:value3".

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets menyediakan fungsi tambahan.

Mirip dengan required_one_of_attributes, required_one_of_attribute_sets menggunakan pesan yang memungkinkan daftar daftar, sehingga 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".

vehicle_state

VehicleState

Membatasi respons ke kendaraan yang memiliki status kendaraan ini.

on_trip_only

bool

Hanya menampilkan kendaraan dengan perjalanan saat ini.

filter

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 hanya kueri pada atribut kendaraan (misalnya, attributes.<key> = <value> atau attributes.<key1> = <value1> AND attributes.<key2> = <value2>) yang didukung. 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 membandingkan dengan nilai angka atau boolean, nilai harus dikutip secara eksplisit agar diperlakukan sebagai string (misalnya, attributes.<key> = "10" atau attributes.<key> = "true").

viewport

Viewport

Opsional. Filter yang membatasi kendaraan yang ditampilkan hanya pada kendaraan yang lokasi terakhirnya diketahui berada di area persegi panjang yang ditentukan oleh area tampilan.

ListVehiclesResponse

Pesan respons ListVehicles.

Kolom
vehicles[]

Vehicle

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

next_page_token

string

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

total_size

int64

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

LocationPowerSaveMode

Cara fitur lokasi dikonfigurasi untuk berfungsi di perangkat seluler saat fitur "penghemat baterai" perangkat diaktifkan. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE Undefined LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE Penyedia lokasi tidak boleh terpengaruh oleh penghemat baterai, atau penghemat baterai dinonaktifkan.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Penyedia lokasi berbasis GPS harus dinonaktifkan saat penghemat baterai aktif dan perangkat tidak interaktif.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Semua penyedia lokasi harus dinonaktifkan saat penghemat baterai aktif dan perangkat tidak interaktif.
LOCATION_MODE_FOREGROUND_ONLY Semua penyedia lokasi akan tetap tersedia, tetapi perbaikan lokasi hanya boleh diberikan ke aplikasi latar depan.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Lokasi tidak akan dinonaktifkan, tetapi LocationManager akan membatasi semua permintaan ke penyedia saat perangkat tidak interaktif.

LocationSensor

Sensor atau metodologi yang digunakan untuk menentukan lokasi.

Enum
UNKNOWN_SENSOR Sensor tidak ditentukan atau tidak diketahui.
GPS GPS atau GPS Berbantuan.
NETWORK GPS yang dibantu, ID menara seluler, atau titik akses Wi-Fi.
PASSIVE ID menara BTS atau titik akses Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokasi yang ditentukan oleh perangkat seluler sebagai posisi jalan yang paling mungkin.
CUSTOMER_SUPPLIED_LOCATION Lokasi yang disediakan pelanggan dari sumber independen. Biasanya, nilai ini digunakan untuk lokasi yang disediakan dari sumber selain perangkat seluler yang menjalankan Driver SDK. Jika sumber asli dijelaskan oleh salah satu nilai enum lainnya, gunakan nilai tersebut. Lokasi yang ditandai CUSTOMER_SUPPLIED_LOCATION biasanya disediakan melalui last_location.supplemental_location_sensor Kendaraan.
FLEET_ENGINE_LOCATION Lokasi yang dihitung oleh Fleet Engine berdasarkan sinyal yang tersedia untuknya. Hanya output. Nilai ini akan ditolak jika diterima dalam permintaan.
FUSED_LOCATION_PROVIDER Fused Location Provider Android.
CORE_LOCATION Penyedia lokasi di sistem operasi Apple.

Status navigasi kendaraan.

Enum
UNKNOWN_NAVIGATION_STATUS Status navigasi tidak ditentukan.
NO_GUIDANCE Navigasi aplikasi Driver berada dalam mode FREE_NAV.
ENROUTE_TO_DESTINATION Navigasi belokan demi belokan tersedia dan navigasi aplikasi Driver telah memasuki mode GUIDED_NAV.
OFF_ROUTE Kendaraan telah keluar dari rute yang disarankan.
ARRIVED_AT_DESTINATION Kendaraan berada dalam jarak sekitar 50 m dari tujuan.

PolylineFormatType

Jenis format polyline.

Enum
UNKNOWN_FORMAT_TYPE Format tidak ditentukan atau tidak diketahui.
LAT_LNG_LIST_TYPE Daftar google.type.LatLng.
ENCODED_POLYLINE_TYPE Polyline yang dienkode dengan algoritma kompresi polyline. Dekode belum didukung.

PowerSource

Jenis pengisi daya yang digunakan untuk mengisi daya baterai.

Enum
UNKNOWN_POWER_SOURCE Sumber daya tidak diketahui.
POWER_SOURCE_AC Sumber daya adalah pengisi daya AC.
POWER_SOURCE_USB Sumber daya adalah port USB.
POWER_SOURCE_WIRELESS Sumber daya nirkabel.
POWER_SOURCE_UNPLUGGED Baterai dicabut.

ReportBillableTripRequest

Pesan permintaan ReportBillableTrip.

Kolom
name

string

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

country_code

string

Wajib. Kode negara dua huruf dari negara tempat perjalanan berlangsung. Harga ditentukan berdasarkan kode negara.

platform

BillingPlatformIdentifier

Platform tempat permintaan dikeluarkan.

related_ids[]

string

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

solution_type

SolutionType

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

SolutionType

Pemilih untuk berbagai jenis solusi dari perjalanan yang dilaporkan.

Enum
SOLUTION_TYPE_UNSPECIFIED Nilai default. Untuk kompatibilitas mundur, API akan menggunakan ON_DEMAND_RIDESHARING_AND_DELIVERIES secara default, yang merupakan jenis solusi pertama yang didukung.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Solusinya adalah perjalanan berbagi kendaraan dan pengiriman on-demand.

RequestHeader

RequestHeader berisi kolom yang umum untuk semua permintaan RPC Fleet Engine.

Kolom
language_code

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 untuk bahasa Inggris jika nama tersebut ada. Contoh nilai kolom: en-US.

region_code

string

Wajib. Kode wilayah CLDR wilayah tempat permintaan berasal. Contoh nilai kolom: US.

sdk_version

string

Versi SDK panggilan, jika ada. Format versi adalah "major.minor.patch", contoh: 1.1.2.

os_version

string

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

device_model

string

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

sdk_type

SdkType

Jenis SDK yang mengirim permintaan.

maps_sdk_version

string

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

nav_sdk_version

string

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

platform

Platform

Platform SDK yang memanggil.

manufacturer

string

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

android_api_level

int32

Level API Android dari SDK yang memanggil, hanya berlaku untuk Android SDK. Contoh nilai kolom: 23.

trace_id

string

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

Platform

Platform SDK yang memanggil.

Enum
PLATFORM_UNSPECIFIED Nilai default. Nilai ini digunakan jika platform tidak dicantumkan.
ANDROID Permintaan berasal dari Android.
IOS Permintaan berasal dari iOS.
WEB Permintaan berasal dari web.

SdkType

Kemungkinan jenis SDK.

Enum
SDK_TYPE_UNSPECIFIED Nilai default. Nilai ini digunakan jika sdk_type tidak ada.
CONSUMER SDK yang memanggil adalah Konsumen.
DRIVER SDK yang memanggil adalah Driver.
JAVASCRIPT SDK yang memanggil adalah JavaScript.

SearchTripsRequest

Pesan permintaan SearchTrips.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

vehicle_id

string

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

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

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

page_size

int32

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

page_token

string

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

minimum_staleness

Duration

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

SearchTripsResponse

Pesan respons SearchTrips.

Kolom
trips[]

Trip

Daftar perjalanan untuk kendaraan yang diminta.

next_page_token

string

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

SearchVehiclesRequest

Pesan permintaan SearchVehicles.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

pickup_point

TerminalLocation

Wajib. Lokasi pengambilan yang akan ditelusuri di sekitar.

dropoff_point

TerminalLocation

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

pickup_radius_meters

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

count

int32

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

minimum_capacity

int32

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

trip_types[]

TripType

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

maximum_staleness

Duration

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

vehicle_types[]

VehicleType

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

required_attributes[]

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. Jika digabungkan, kedua kolom ini 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 pada kendaraan dengan atribut tertentu. Kolom ini adalah operasi konjungsi/AND. Maksimal 50 required_attributes yang diizinkan. Jumlah ini sesuai dengan jumlah maksimum atribut yang diizinkan pada kendaraan.

required_one_of_attributes[]

VehicleAttributeList

Membatasi penelusuran hanya pada 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.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets menyediakan fungsi tambahan.

Mirip dengan required_one_of_attributes, required_one_of_attribute_sets menggunakan pesan yang memungkinkan daftar daftar, sehingga 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 pada kendaraan 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.

order_by

VehicleMatchOrder

Wajib. Menentukan kriteria pengurutan yang diinginkan untuk hasil.

include_back_to_back

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 mencakup kendaraan dengan satu perjalanan aktif yang memiliki status ENROUTE_TO_DROPOFF. Jika current_trips_present ditentukan, kolom ini tidak dapat ditetapkan ke benar.

Nilai default-nya adalah false.

trip_id

string

Menunjukkan perjalanan yang terkait dengan SearchVehicleRequest ini.

current_trips_present

CurrentTripsPresent

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 menyertakan SHARED.

filter

string

Opsional. Kueri filter yang akan diterapkan saat menelusuri 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 minimum_capacity atau vehicle_types.

Perhatikan bahwa hanya kueri pada atribut kendaraan (misalnya, attributes.<key> = <value> atau attributes.<key1> = <value1> AND attributes.<key2> = <value2>) yang didukung. 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 membandingkan dengan nilai angka atau boolean, nilai harus dikutip secara eksplisit agar diperlakukan sebagai string (misalnya, attributes.<key> = "10" atau attributes.<key> = "true").

CurrentTripsPresent

Menentukan jenis batasan pada perjalanan kendaraan saat ini.

Enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Ketersediaan kendaraan dengan perjalanan yang ada diatur oleh kolom include_back_to_back.
NONE Kendaraan tanpa perjalanan dapat muncul di hasil penelusuran. Jika nilai ini digunakan, include_back_to_back tidak boleh true.
ANY Kendaraan dengan maksimal 5 perjalanan saat ini dan 10 titik jalan disertakan dalam hasil penelusuran. Jika nilai ini digunakan, include_back_to_back tidak boleh true.

VehicleMatchOrder

Menentukan urutan kecocokan kendaraan dalam respons.

Enum
UNKNOWN_VEHICLE_MATCH_ORDER Default, digunakan untuk urutan kecocokan kendaraan yang tidak ditentukan atau tidak dikenali.
PICKUP_POINT_ETA Urutan menaik berdasarkan waktu mengemudi kendaraan ke titik penjemputan.
PICKUP_POINT_DISTANCE Urutan menaik berdasarkan jarak tempuh kendaraan ke titik pengambilan.
DROPOFF_POINT_ETA Urutan menaik berdasarkan waktu mengemudi kendaraan ke titik pengantaran. Urutan ini hanya dapat digunakan jika titik pengantaran ditentukan dalam permintaan.
PICKUP_POINT_STRAIGHT_DISTANCE Urutan menaik berdasarkan jarak garis lurus dari lokasi terakhir yang dilaporkan kendaraan ke titik penjemputan.
COST Urutan menaik berdasarkan biaya pencocokan yang dikonfigurasi. Biaya kecocokan ditentukan sebagai perhitungan berbobot antara jarak garis lurus dan perkiraan waktu tempuh. Bobot ditetapkan dengan nilai default dan dapat diubah per pelanggan. Hubungi dukungan Google jika bobot ini perlu diubah untuk project Anda.

SearchVehiclesResponse

Pesan respons SearchVehicles.

Kolom
matches[]

VehicleMatch

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

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 trafficnya menggunakan kategori berikut.

Kolom
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

speed

Speed

Kecepatan lalu lintas dalam interval ini.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data lalu lintas.

Enum
SPEED_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
NORMAL Kecepatan normal, tidak ada kemacetan lalu lintas.
SLOW Perlambatan terdeteksi, lalu lintas agak padat.
TRAFFIC_JAM Keterlambatan lalu lintas.

StopLocation

Lokasi sebenarnya tempat perhentian (pengambilan/penurunan) terjadi.

Kolom
point

LatLng

Wajib. Menunjukkan lokasi sebenarnya.

timestamp

Timestamp

Menunjukkan kapan perhentian terjadi.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

Mendeskripsikan lokasi titik jalan.

Kolom
point

LatLng

Menunjukkan LatLng persis dari titik jalan. point atau place harus ditentukan sebagai input. Jika keduanya ditentukan, point akan digunakan untuk perutean dan place akan digunakan untuk metadata. Jika hanya place yang ditentukan sebagai input, point akan dihitung dari place dan disertakan dalam output.

place

string

Nama resource tempat yang merepresentasikan lokasi ini. Formatnya adalah places/{place_id}. point atau place harus ditentukan sebagai input. Jika keduanya ditentukan, point akan digunakan untuk perutean dan place akan digunakan untuk metadata. place hanya disertakan dalam output jika disertakan dalam input, yang berarti tidak ada penelusuran place dari LatLng yang dilakukan.

Ini adalah fitur eksperimental.

point_location_source

PointSource

Hanya output. Sumber kolom point.

terminal_point_id
(deprecated)

TerminalPointId

Tidak digunakan lagi: Tentukan kolom place sebagai gantinya.

access_point_id
(deprecated)

string

Tidak digunakan lagi: Tentukan kolom place sebagai gantinya.

trip_id
(deprecated)

string

Tidak digunakan lagi.

terminal_location_type
(deprecated)

WaypointType

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

PointSource

Menunjukkan sumber LatLng.

Enum
POINT_SOURCE_UNSPECIFIED Sumber titik tidak ditentukan.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng diberikan secara eksplisit oleh developer.
POINT_SOURCE_CALCULATED_FROM_PLACE LatLng dihitung dari tempat yang diberikan.

TerminalPointId

Tidak digunakan lagi: TerminalPoint tidak lagi didukung di Fleet Engine. Sebagai gantinya, gunakan TerminalLocation.point.

Kolom
value
(deprecated)

string

Tidak digunakan lagi.

Kolom union Id. Tidak digunakan lagi. Id hanya dapat berupa salah satu dari berikut:
place_id
(deprecated)

string

Tidak digunakan lagi.

generated_id
(deprecated)

string

Tidak digunakan lagi.

TrafficPolylineData

Kondisi lalu lintas di sepanjang rute kendaraan yang diperkirakan.

Kolom
traffic_rendering

VisualTrafficReportPolylineRendering

Rendering polyline tentang seberapa cepat lalu lintas untuk semua wilayah di sepanjang satu perjalanan pelanggan.

Perjalanan

Metadata perjalanan.

Kolom
name

string

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

vehicle_id

string

ID kendaraan yang melakukan perjalanan ini.

trip_status

TripStatus

Status perjalanan saat ini.

trip_type

TripType

Jenis perjalanan.

pickup_point

TerminalLocation

Lokasi tempat pelanggan menunjukkan bahwa mereka akan dijemput.

actual_pickup_point

StopLocation

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

actual_pickup_arrival_point

StopLocation

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

pickup_time

Timestamp

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

intermediate_destinations[]

TerminalLocation

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

intermediate_destinations_version

Timestamp

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

intermediate_destination_index

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.

actual_intermediate_destination_arrival_points[]

StopLocation

Hanya input. Waktu dan lokasi sebenarnya saat pengemudi tiba di tujuan antara. Kolom ini digunakan penyedia untuk memberikan masukan tentang informasi kedatangan sebenarnya di tujuan perantara.

actual_intermediate_destinations[]

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 sebenarnya di tujuan perantara.

dropoff_point

TerminalLocation

Lokasi tempat pelanggan menunjukkan bahwa mereka akan diturunkan.

actual_dropoff_point

StopLocation

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

dropoff_time

Timestamp

Hanya output. Perkiraan waktu mendatang saat penumpang akan diantar ke tujuan akhir, atau waktu sebenarnya saat mereka diantar.

remaining_waypoints[]

TripWaypoint

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

vehicle_waypoints[]

TripWaypoint

Kolom ini mendukung pengurutan titik jalan secara manual untuk perjalanan. Array ini berisi semua titik jalan yang tersisa untuk kendaraan yang ditetapkan, serta titik jalan penjemputan dan pengantaran untuk perjalanan ini. Jika perjalanan belum ditetapkan ke 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.

route[]

LatLng

Hanya output. Rute yang diantisipasi untuk perjalanan ini ke entri pertama di remaining_waypoints. Perhatikan bahwa titik jalan pertama mungkin termasuk dalam perjalanan yang berbeda.

current_route_segment

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.

current_route_segment_version

Timestamp

Hanya output. Menunjukkan terakhir kali rute diubah.

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

current_route_segment_traffic

ConsumableTrafficPolyline

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

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

current_route_segment_traffic_version

Timestamp

Hanya output. Menunjukkan terakhir kali current_route_segment_traffic diubah.

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

current_route_segment_end_point

TripWaypoint

Hanya output. Titik jalan tempat current_route_segment berakhir.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

Hanya output. ETA 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).

remaining_time_to_first_waypoint

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

remaining_waypoints_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

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

number_of_passengers

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.

last_location

VehicleLocation

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

last_location_snappable

bool

Hanya output. Menunjukkan apakah last_location kendaraan dapat disesuaikan dengan current_route_segment. Salah (False) jika last_location atau current_route_segment tidak ada. Nilai ini dihitung oleh Fleet Engine. Setiap pembaruan dari klien akan diabaikan.

view

TripView

Subkumpulan kolom Perjalanan yang diisi dan cara penafsirannya.

attributes[]

TripAttribute

Daftar atribut Perjalanan kustom. Setiap atribut harus memiliki kunci unik.

TripAttribute

Menjelaskan atribut perjalanan sebagai key-value pair. Panjang string "key:value" tidak boleh melebihi 256 karakter.

Kolom
key

string

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

Kolom union trip_attribute_value. Nilai atribut dapat berupa jenis string, bool, atau double. trip_attribute_value hanya dapat berupa salah satu dari berikut:
string_value

string

Nilai atribut berjenis string.

bool_value

bool

Nilai atribut berjenis Boolean.

number_value

double

Nilai atribut yang diketik ganda.

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 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 pengantaran).
ENROUTE_TO_DROPOFF Pengemudi telah menjemput penumpang dan sedang dalam perjalanan menuju tujuan berikutnya.
COMPLETE Pengendara sudah diantar ke tujuan dan perjalanan selesai.
CANCELED Perjalanan dibatalkan sebelum penjemputan oleh pengemudi, penumpang, atau penyedia layanan transportasi online.

TripType

Jenis perjalanan.

Enum
UNKNOWN_TRIP_TYPE Default, digunakan untuk jenis perjalanan yang tidak ditentukan atau tidak dikenali.
SHARED Perjalanan dapat berbagi kendaraan dengan perjalanan lain.
EXCLUSIVE Perjalanan ini eksklusif untuk kendaraan.

TripView

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

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

TripWaypoint

Mendeskripsikan titik perhentian di rute kendaraan atau titik akhir di perjalanan kendaraan.

Kolom
location

TerminalLocation

Lokasi titik jalan ini.

trip_id

string

Perjalanan yang terkait dengan titik jalan ini.

waypoint_type

WaypointType

Peran titik jalan ini dalam perjalanan ini, seperti pengambilan atau pengantaran.

path_to_waypoint[]

LatLng

Jalur dari titik jalan sebelumnya ke titik jalan saat ini. Jika ini adalah titik jalan pertama, jalur akan dimulai dari lokasi kendaraan saat ini ke titik jalan. Kolom ini hanya diisi jika diminta.

encoded_path_to_waypoint

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.

traffic_to_waypoint

ConsumableTrafficPolyline

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

distance_meters

Int32Value

Jarak jalur dari titik jalan sebelumnya ke titik jalan saat ini. Jika ini adalah titik jalan pertama, jarak jalur adalah dari lokasi kendaraan saat ini ke titik jalan.

eta

Timestamp

Perkiraan waktu tiba di titik jalan ini.

duration

Duration

Waktu perjalanan dari titik jalan sebelumnya ke titik jalan ini. Jika ini adalah titik jalan pertama, waktu perjalanannya adalah dari lokasi kendaraan saat ini ke titik jalan.

UpdateTripRequest

Pesan permintaan UpdateTrip.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

trip

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, urutannya 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 berada sebelum titik pengantaran. Titik jalan perjalanan EXCLUSIVE tidak boleh diselingi dengan perjalanan lain. Kolom trip_id, waypoint_type, dan location digunakan, dan semua kolom TripWaypoint lainnya di vehicle_waypoints diabaikan.

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

update_mask

FieldMask

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

UpdateVehicleAttributesRequest

Pesan permintaan UpdateVehicleAttributes.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

Pesan respons UpdateVehicleAttributes.

Kolom
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

`Pesan permintaan UpdateVehicle.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

vehicle

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 diupdate, tetapi harus berisi semua titik jalan yang saat ini ada di kendaraan, dan tidak ada titik jalan lain.

update_mask

FieldMask

Wajib. Mask kolom yang menunjukkan kolom Vehicle yang akan diperbarui. Setidaknya satu nama kolom harus diberikan.

Kendaraan

Metadata kendaraan.

Kolom
name

string

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

vehicle_state

VehicleState

Status kendaraan.

supported_trip_types[]

TripType

Jenis perjalanan yang didukung oleh kendaraan ini.

current_trips[]

string

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

last_location

VehicleLocation

Lokasi terakhir yang dilaporkan dari kendaraan.

past_locations[]

VehicleLocation

Hanya input. Lokasi yang pernah dikunjungi kendaraan ini pada masa lalu yang belum dilaporkan ke Fleet Engine. ID ini digunakan di UpdateVehicleRequest untuk mencatat lokasi yang sebelumnya tidak dapat dikirim ke server. Biasanya hal ini terjadi saat kendaraan tidak memiliki konektivitas internet.

maximum_capacity

int32

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

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

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

license_plate

LicensePlate

Informasi pelat nomor kendaraan.

route[]
(deprecated)

TerminalLocation

Tidak digunakan lagi: Gunakan Vehicle.waypoints sebagai gantinya.

current_route_segment

string

Polyline yang menentukan rute yang akan 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.

current_route_segment_traffic

TrafficPolylineData

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

current_route_segment_version

Timestamp

Hanya output. Waktu saat current_route_segment ditetapkan. Dapat disimpan oleh klien dan diteruskan dalam permintaan GetVehicle mendatang untuk mencegah rute yang tidak berubah ditampilkan.

current_route_segment_end_point

TripWaypoint

Titik jalan tempat current_route_segment berakhir. Hal ini dapat diberikan oleh pengemudi pada panggilan UpdateVehicle baik sebagai titik jalan perjalanan lengkap, titik jalan LatLng, atau sebagai LatLng terakhir dari current_route_segment. Kemudian, Fleet Engine akan berupaya sebaik mungkin untuk melakukan interpolasi ke titik jalan sebenarnya jika tidak sepenuhnya ditentukan. Kolom ini diabaikan dalam panggilan UpdateVehicle kecuali jika current_route_segment juga ditentukan.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

Perkiraan waktu tiba untuk 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.

remaining_time_seconds

Int32Value

Hanya input. 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 waktu yang sama.

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

waypoints[]

TripWaypoint

Titik jalan yang tersisa yang ditetapkan ke Kendaraan ini.

waypoints_version

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.

back_to_back_enabled

bool

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

navigation_status

NavigationStatus

Status navigasi kendaraan.

device_settings

DeviceSettings

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

VehicleType

Jenis kendaraan.

Kolom
category

Category

Kategori jenis kendaraan

Kategori

Kategori jenis kendaraan

Enum
UNKNOWN Default, digunakan untuk kategori kendaraan yang tidak ditentukan atau tidak dikenali.
AUTO Mobil.
TAXI Kendaraan apa pun yang berfungsi sebagai taksi (biasanya berlisensi atau diatur).
TRUCK Umumnya, kendaraan dengan kapasitas penyimpanan yang besar.
TWO_WHEELER Sepeda motor, moped, atau kendaraan roda dua lainnya
BICYCLE Transportasi yang digerakkan manusia.
PEDESTRIAN Pengangkut manusia, biasanya berjalan atau berlari, bepergian di sepanjang jalur pejalan kaki.

VehicleAttribute

Menjelaskan atribut kendaraan sebagai key-value pair. Panjang string "key:value" tidak boleh melebihi 256 karakter.

Kolom
key

string

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

value

string

Nilai atribut.

Kolom union vehicle_attribute_value. Nilai atribut dapat berupa jenis string, bool, atau double. vehicle_attribute_value hanya dapat berupa salah satu dari berikut:
string_value

string

Nilai atribut berjenis string.

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

bool_value

bool

Nilai atribut berjenis Boolean.

number_value

double

Nilai atribut yang diketik ganda.

VehicleAttributeList

Jenis data list-of-lists untuk atribut kendaraan.

Kolom
attributes[]

VehicleAttribute

Daftar atribut dalam koleksi ini.

VehicleLocation

Lokasi, kecepatan, dan arah kendaraan pada suatu waktu.

Kolom
location

LatLng

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

horizontal_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Gunakan latlng_accuracy sebagai gantinya.

latlng_accuracy

DoubleValue

Akurasi location dalam meter sebagai radius.

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Gunakan heading_accuracy sebagai gantinya.

heading_accuracy

DoubleValue

Akurasi heading dalam derajat.

altitude

DoubleValue

Ketinggian dalam meter di atas WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Gunakan altitude_accuracy sebagai gantinya.

altitude_accuracy

DoubleValue

Akurasi altitude dalam meter.

speed_kmph
(deprecated)

Int32Value

Kecepatan kendaraan dalam kilometer per jam. Tidak digunakan lagi: Gunakan speed sebagai gantinya.

speed

DoubleValue

Kecepatan kendaraan dalam meter/detik

speed_accuracy

DoubleValue

Akurasi speed dalam meter/detik.

update_time

Timestamp

Waktu saat location dilaporkan oleh sensor menurut jam sensor.

server_time

Timestamp

Hanya output. Waktu saat server menerima informasi lokasi.

location_sensor

LocationSensor

Penyedia data lokasi (misalnya, GPS).

is_road_snapped

BoolValue

Apakah location disesuaikan dengan jalan.

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

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

num_stale_updates
(deprecated)

Int32Value

Hanya input. Tidak digunakan lagi: Sinyal lain kini digunakan untuk menentukan apakah lokasi sudah tidak valid.

raw_location

LatLng

Lokasi kendaraan mentah (tidak diproses oleh road-snapper).

raw_location_time

Timestamp

Stempel waktu yang terkait dengan lokasi mentah.

raw_location_sensor

LocationSensor

Sumber lokasi mentah. Default-nya adalah GPS.

raw_location_accuracy

DoubleValue

Akurasi raw_location sebagai radius, dalam meter.

flp_location

LatLng

Lokasi dari Penyedia Lokasi Gabungan Android.

flp_update_time

Timestamp

Stempel waktu update flp_location

flp_latlng_accuracy_meters

DoubleValue

Akurasi flp_location dalam meter sebagai radius.

flp_heading_degrees

Int32Value

Arah pergerakan kendaraan dalam derajat, sebagaimana ditentukan oleh Fused Location Provider. 0 mewakili Utara. Rentang yang valid adalah [0,360).

supplemental_location

LatLng

Lokasi tambahan yang disediakan oleh aplikasi pengintegrasi.

supplemental_location_time

Timestamp

Stempel waktu yang terkait dengan lokasi tambahan.

supplemental_location_sensor

LocationSensor

Sumber lokasi tambahan. Default-nya adalah CUSTOMER_SUPPLIED_LOCATION.

supplemental_location_accuracy

DoubleValue

Akurasi supplemental_location sebagai radius, dalam meter.

road_snapped
(deprecated)

bool

Tidak digunakan lagi: Gunakan is_road_snapped sebagai gantinya.

VehicleMatch

Berisi kendaraan dan estimasi terkait untuk kendaraan yang cocok dengan titik perjalanan aktif untuk kendaraan SearchVehiclesRequest.

Kolom
vehicle

Vehicle

Wajib. Kendaraan yang cocok dengan permintaan.

vehicle_pickup_eta

Timestamp

Perkiraan waktu tiba kendaraan ke titik pengambilan 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 mencakup waktu yang diperlukan untuk menyelesaikan perjalanan aktif saat ini.

vehicle_pickup_distance_meters

Int32Value

Jarak dari lokasi kendaraan saat ini ke titik penjemputan yang ditentukan dalam permintaan, termasuk titik penjemputan atau pengantaran 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.

vehicle_pickup_straight_line_distance_meters

Int32Value

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

vehicle_dropoff_eta

Timestamp

Perkiraan waktu tiba (ETA) mengemudi kendaraan lengkap ke titik pengantaran yang ditentukan dalam permintaan. Waktu tiba mencakup berhenti di titik jalan mana pun sebelum dropoff_point yang ditentukan dalam permintaan. Nilai hanya akan diisi jika titik keluar ditentukan dalam permintaan. Nilai kosong menunjukkan error saat menghitung perkiraan waktu tiba.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Jarak tempuh kendaraan (dalam meter) dari titik penjemputan ke titik pengantaran 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 jika dropoff_point ditentukan dalam permintaan. Nilai kosong menunjukkan kegagalan dalam menghitung jarak dari titik pengambilan ke titik pengantaran yang ditentukan dalam permintaan.

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

Daftar titik jalan yang diurutkan dan digunakan untuk menghitung perkiraan waktu tiba. Daftar ini mencakup lokasi kendaraan, titik pengambilan perjalanan aktif untuk kendaraan, dan titik pengambilan yang diberikan dalam permintaan. Daftar kosong menunjukkan kegagalan dalam menghitung perkiraan waktu tiba untuk kendaraan.

vehicle_match_type

VehicleMatchType

Jenis kecocokan kendaraan.

requested_ordered_by

VehicleMatchOrder

Urutan yang diminta untuk mengurutkan kecocokan kendaraan. Setara dengan ordered_by.

ordered_by

VehicleMatchOrder

Urutan yang diminta untuk mengurutkan kecocokan kendaraan. Setara dengan requested_ordered_by.

VehicleMatchType

Jenis pencocokan kendaraan.

Enum
UNKNOWN Jenis pencocokan kendaraan tidak diketahui
EXCLUSIVE Kendaraan saat ini tidak memiliki perjalanan yang ditetapkan dan dapat melanjutkan perjalanan ke titik penjemputan.
BACK_TO_BACK Kendaraan saat ini ditetapkan untuk perjalanan, tetapi dapat menuju titik penjemputan setelah menyelesaikan perjalanan yang sedang berlangsung. Penghitungan jarak dan ETP memperhitungkan perjalanan yang ada.
CARPOOL Kendaraan memiliki kapasitas yang cukup untuk perjalanan bersama.
CARPOOL_BACK_TO_BACK Kendaraan akan menyelesaikan perjalanan aktifnya saat ini sebelum melanjutkan ke titik penjemputan. Penghitungan jarak dan ETP memperhitungkan perjalanan yang ada.

VehicleState

Status Vehicle.

Enum
UNKNOWN_VEHICLE_STATE Default, digunakan untuk status kendaraan yang tidak ditentukan atau tidak dikenali.
OFFLINE Kendaraan tidak menerima perjalanan baru. Catatan: kendaraan dapat terus beroperasi dalam status ini saat menyelesaikan perjalanan yang ditetapkan untuknya.
ONLINE Kendaraan menerima perjalanan baru.

VisualTrafficReportPolylineRendering

Menjelaskan cara klien harus mewarnai satu bagian polyline di sepanjang rute.

Kolom
road_stretch[]

RoadStretch

Opsional. Bentangan jalan yang harus dirender di sepanjang polyline. Rentang dijamin tidak tumpang-tindih, dan tidak selalu mencakup rute penuh.

Jika tidak ada ruas jalan yang akan diberi gaya, klien harus menerapkan default untuk rute.

RoadStretch

Satu ruas jalan yang harus dirender.

Kolom
style

Style

Wajib. Gaya yang akan diterapkan.

offset_meters

int32

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

length_meters

int32

Wajib. Panjang jalur tempat gaya akan diterapkan.

Gaya

Gaya lalu lintas, yang menunjukkan kecepatan lalu lintas.

Enum
STYLE_UNSPECIFIED Tidak ada gaya yang dipilih.
SLOWER_TRAFFIC Lalu lintas melambat.
TRAFFIC_JAM Ada kemacetan.

Waypoint

Mendeskripsikan titik perantara di sepanjang rute untuk VehicleMatch dalam SearchVehiclesResponse. Konsep ini direpresentasikan sebagai TripWaypoint di semua endpoint lainnya.

Kolom
lat_lng

LatLng

Lokasi titik jalan ini.

eta

Timestamp

Perkiraan waktu kendaraan akan tiba di titik jalan ini.

WaypointType

Jenis titik jalan.

Enum
UNKNOWN_WAYPOINT_TYPE Jenis titik jalan tidak diketahui atau tidak ditentukan.
PICKUP_WAYPOINT_TYPE Titik jalan untuk menjemput penumpang atau mengambil item.
DROP_OFF_WAYPOINT_TYPE Titik jalan untuk menurunkan penumpang atau item.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Titik jalan untuk tujuan perantara dalam perjalanan multi-tujuan.