Package maps.fleetengine.v1

Indeks

TripService

Layanan pengelolaan perjalanan.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Membuat perjalanan di Fleet Engine dan menampilkan perjalanan baru.

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 transportasi online 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 ada.

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.

SearchFuzzedVehicles

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Tidak digunakan lagi: Sebagai gantinya, gunakan SearchVehicles.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Menampilkan daftar kendaraan yang cocok dengan opsi permintaan.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Menulis data kendaraan yang telah 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 diperbarui, tetapi harus berisi semua titik jalan yang saat ini ada di kendaraan, dan tidak boleh ada titik jalan lainnya.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Mengupdate sebagian atribut kendaraan. Hanya atribut yang disebutkan dalam permintaan yang akan diperbarui, atribut lainnya TIDAK akan diubah. Catatan: hal ini berbeda di UpdateVehicle, dengan seluruh kolom attributes akan diganti dengan yang ada di UpdateVehicleRequest, atribut yang tidak ada dalam permintaan akan dihapus.

UpdateVehicleLocation

rpc UpdateVehicleLocation(UpdateVehicleLocationRequest) returns (VehicleLocation)

Tidak digunakan lagi: Sebagai gantinya, gunakan metode UpdateVehicle. UpdateKendaraanLocation memperbarui lokasi kendaraan.

BatteryInfo

Informasi tentang baterai perangkat.

Kolom
battery_status

BatteryStatus

Status baterai, apakah penuh atau sedang mengisi daya, dll.

power_source

PowerSource

Status sumber daya baterai.

battery_percentage

float

Persentase baterai saat ini [0-100].

BatteryStatus

Status baterai, apakah penuh atau sedang mengisi daya, dll.

Enum
UNKNOWN_BATTERY_STATUS Status baterai tidak diketahui.
BATTERY_STATUS_CHARGING Baterai sedang diisi daya.
BATTERY_STATUS_DISCHARGING Daya baterai sedang habis.
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 di platform mana permintaan diajukan.

Enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Default. Digunakan untuk platform yang tidak ditentukan.
SERVER Platform tersebut 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 diambil pengemudi dari titik jalan sebelumnya ke titik jalan saat ini. Jalur ini memiliki tempat terkenal di dalamnya, sehingga klien dapat menampilkan penanda traffic di sepanjang jalur (lihat speed_reading_interval). Decoding belum didukung.

CreateTripRequest

Pesan permintaan CreateTrip.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

trip_id

string

Wajib. ID Perjalanan Unik. Tunduk pada pembatasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan 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 akan digunakan jika Anda memberikannya:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Semua kolom Perjalanan lainnya diabaikan. Misalnya, semua perjalanan dimulai dengan trip_status dari 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 muncul sebelum titik pengantaran. Titik jalan perjalanan EXCLUSIVE tidak boleh disisipkan dengan perjalanan lain.

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

CreateVehicleRequest

CreateVehicle pesan permintaan.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

vehicle_id

string

Wajib. ID Kendaraan Unik. Tunduk pada pembatasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalkan 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 ada.

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 merupakan Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini menjadi anggota.

view

TripView

Subset kolom Perjalanan yang harus ditampilkan dan interpretasinya.

current_route_segment_version

Timestamp

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

remaining_waypoints_version

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) untuk Trip.remaining_waypoints yang diambil. Jika tidak berubah sejak stempel waktu ini, remaining_waypoints tidak akan ditetapkan dalam respons. Jika kolom ini tidak ditentukan, remaining_waypoints akan selalu 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) untuk Trip.current_route_segment_traffic yang 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) saat 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 akan selalu diambil.

GetVehicleRequest

GetVehicle pesan permintaan.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

current_route_segment_version

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) untuk Vehicle.current_route_segment yang diambil. 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.

waypoints_version

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) saat 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.

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 dari pelat nomor atau "-1" untuk menunjukkan tidak ada nilai numerik pada pelat nomor kendaraan.

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

ListVehiclesRequest

ListVehicles pesan permintaan.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

page_size

int32

Jumlah maksimum kendaraan untuk dikembalikan. 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 sebelumnya ke ListVehicles.

minimum_capacity

Int32Value

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

trip_types[]

TripType

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

maximum_staleness

Duration

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

vehicle_type_categories[]

Category

Wajib. Membatasi respons terhadap 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 mengizinkan daftar. Dalam kombinasinya, 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 untuk kendaraan dengan atribut yang ditentukan. Kolom ini merupakan operasi gabungan/DAN. Maksimal 50 required_attributes diizinkan. Jumlah ini cocok dengan jumlah atribut maksimum yang diizinkan di kendaraan. Setiap string berulang harus dalam format "key:value".

required_one_of_attributes[]

string

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

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets menyediakan fungsi tambahan.

Serupa dengan required_one_of_attributes, required_one_of_attribute_sets menggunakan pesan yang memungkinkan 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 untuk kendaraan yang cocok dengan semua atribut di VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan semua atribut. Kolom ini merupakan operasi konjungsi/AND di setiap VehicleAttributeList dan operasi disjungsi/ATAU inklusif di seluruh kumpulan VehicleAttributeList. Setiap string yang berulang harus memiliki format "key1:value1|key2:value2|key3:value3".

vehicle_state

VehicleState

Membatasi respons untuk kendaraan yang memiliki status kendaraan ini.

on_trip_only

bool

Hanya kembalikan kendaraan dengan perjalanan saat ini.

filter

string

Opsional. Kueri filter yang akan diterapkan saat mencantumkan kendaraan. Buka 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 lainnya, seperti vehicle_state atau on_trip_only.

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 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 ke kendaraan yang lokasi terakhirnya diketahui berada di area persegi panjang yang ditentukan oleh area pandang.

ListVehiclesResponse

ListVehicles pesan respons.

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 berperilaku di perangkat seluler saat fitur "penghemat baterai" perangkat aktif. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode Tidak Ditentukan
LOCATION_MODE_NO_CHANGE Penyedia lokasi tidak akan terpengaruh oleh penghemat baterai, atau penghemat baterai nonaktif.
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 jika 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 berbantuan, ID menara BTS, atau titik akses WiFi.
PASSIVE ID menara BTS atau titik akses WiFi.
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 diberikan 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 untuk lokasi tersebut. Hanya output. Nilai ini akan ditolak jika diterima dalam permintaan.
FUSED_LOCATION_PROVIDER Penyedia Lokasi Gabungan Android.
CORE_LOCATION Penyedia lokasi di sistem operasi Apple.

Status navigasi kendaraan.

Enum
UNKNOWN_NAVIGATION_STATUS Status navigasi tidak ditentukan.
NO_GUIDANCE Navigasi aplikasi Pengemudi berada dalam mode FREE_NAV.
ENROUTE_TO_DESTINATION Navigasi belokan demi belokan tersedia dan navigasi aplikasi Pengemudi telah memasuki mode GUIDED_NAV.
OFF_ROUTE Kendaraan telah menyimpang 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. Decoding belum didukung.

PowerSource

Jenis pengisi daya yang digunakan untuk mengisi daya baterai.

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

ReportBillableTripRequest

Pesan permintaan ReportBillableTrip.

Kolom
name

string

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

country_code

string

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

platform

BillingPlatformIdentifier

Platform tempat permintaan diajukan.

related_ids[]

string

ID yang terkait langsung dengan perjalanan yang dilaporkan. ID ini biasanya berupa 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 untuk 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 transportasi online dan pengiriman sesuai permintaan.

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 mungkin dalam bahasa apa pun, dengan preferensi bahasa Inggris jika nama tersebut ada. Contoh nilai kolom: en-US.

region_code

string

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

sdk_version

string

Versi SDK panggilan, jika berlaku. Format versinya 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 diandalkan SDK panggilan, jika ada. Format versinya adalah "major.minor.patch", contoh: 5.2.1.

nav_sdk_version

string

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

platform

Platform

Platform SDK panggilan.

manufacturer

string

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

android_api_level

int32

Level API Android SDK panggilan, 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 panggilan.

Enum
PLATFORM_UNSPECIFIED Nilai default. Nilai ini digunakan jika platform dihilangkan.
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 dihilangkan.
CONSUMER SDK panggilan adalah Konsumen.
DRIVER SDK panggilan adalah Driver.
JAVASCRIPT SDK panggilan adalah JavaScript.

SearchTripsRequest

Pesan permintaan SearchTrips.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

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 ditetapkan ke true, responsnya akan mencakup Perjalanan yang memengaruhi rute pengemudi.

page_size

int32

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

page_token

string

Tetapkan string 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 menelusuri hasil daftar. API menampilkan daftar perjalanan pada setiap panggilan, dan jika tidak ada hasil lagi, daftar perjalanan tersebut akan kosong.

SearchVehiclesRequest

SearchVehicles pesan permintaan.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

parent

string

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

pickup_point

TerminalLocation

Wajib. Titik penjemputan untuk menelusuri di dekat.

dropoff_point

TerminalLocation

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

pickup_radius_meters

int32

Wajib. Menentukan radius pencarian 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 atau sama dengan satu. Driver 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 pada kendaraan yang telah mengirimkan pembaruan lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan tidak bergerak yang masih mengirimkan lokasinya tidak dianggap usang. Jika kolom ini tidak disetel, server akan menggunakan lima menit sebagai nilai default.

vehicle_types[]

VehicleType

Wajib. Membatasi penelusuran pada kendaraan dengan salah satu jenis yang ditentukan. Minimal satu jenis kendaraan harus ditentukan. VehicleType 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 mengizinkan daftar. Dalam kombinasinya, 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 yang ditentukan. Kolom ini merupakan operasi gabungan/DAN. Maksimal 50 required_attributes diizinkan. Jumlah ini cocok dengan jumlah atribut maksimum yang diizinkan di kendaraan.

required_one_of_attributes[]

VehicleAttributeList

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

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets menyediakan fungsi tambahan.

Serupa dengan required_one_of_attributes, required_one_of_attribute_sets menggunakan pesan yang memungkinkan 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 tersebut dengan semua atribut di VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan semua atribut. Kolom ini merupakan operasi konjungsi/AND di setiap VehicleAttributeList dan operasi disjungsi/ATAU inklusif di seluruh kumpulan VehicleAttributeList.

order_by

VehicleMatchOrder

Wajib. Menentukan kriteria pengurutan yang diinginkan untuk hasil.

include_back_to_back

bool

Hal 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 ditetapkan ke 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 true.

Nilai default-nya adalah false.

trip_id

string

Menunjukkan perjalanan yang terkait dengan SearchVehicleRequest ini.

current_trips_present

CurrentTripsPresent

Nilai ini menunjukkan apakah kendaraan dengan perjalanan aktif memenuhi syarat untuk penelusuran ini. Nilai ini harus ditetapkan ke selain CURRENT_TRIPS_PRESENT_UNSPECIFIED jika trip_type menyertakan SHARED.

filter

string

Opsional. Kueri filter yang akan diterapkan saat menelusuri kendaraan. Buka 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 lainnya, 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 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 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 kendaraan yang cocok dalam respons.

Enum
UNKNOWN_VEHICLE_MATCH_ORDER Default, digunakan untuk pesanan kendaraan yang tidak ditentukan atau tidak dikenal.
PICKUP_POINT_ETA Urutan naik menurut waktu mengemudi kendaraan ke titik penjemputan.
PICKUP_POINT_DISTANCE Urutan naik menurut jarak mengemudi kendaraan ke titik penjemputan.
DROPOFF_POINT_ETA Urutan menaik menurut waktu mengemudi kendaraan ke titik pengantaran. Pesanan ini hanya dapat digunakan jika titik pengantaran ditentukan dalam permintaan.
PICKUP_POINT_STRAIGHT_DISTANCE Urutan menaik menurut jarak garis lurus dari lokasi terakhir kendaraan yang dilaporkan ke titik penjemputan.
COST Urutan menaik menurut biaya pencocokan yang dikonfigurasi. Biaya pencocokan didefinisikan sebagai penghitungan berbobot antara jarak garis lurus dan PWT. Bobot ditetapkan dengan nilai default dan dapat diubah per pelanggan. Hubungi dukungan Google jika bobot ini perlu diubah untuk project Anda.

SearchVehiclesResponse

SearchVehicles pesan respons.

Kolom
matches[]

VehicleMatch

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

SpeedReadingInterval

Indikator kepadatan lalu lintas pada segmen yang berdekatan dari sebuah jalur. Dengan jalur dengan titik P_0, P_1, ... , P_N (indeks berbasis nol), SpeedReadingInterval menentukan interval dan menjelaskan traffic menggunakan kategori berikut.

Kolom
start_polyline_point_index

int32

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

end_polyline_point_index

int32

Indeks akhir interval ini di jalur. Di JSON, jika indeksnya 0, kolom tidak akan 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 pelambatan yang terdeteksi.
SLOW Kecepatan lambat terdeteksi, tetapi tidak ada kemacetan lalu lintas.
TRAFFIC_JAM Kemacetan lalu lintas terdeteksi.

StopLocation

Lokasi sebenarnya tempat perhentian (pengambilan/penurunan) terjadi.

Kolom
point

LatLng

Wajib. Menunjukkan lokasi sebenarnya.

timestamp

Timestamp

Menunjukkan waktu perhentian terjadi.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

Menjelaskan lokasi titik jalan.

Kolom
point

LatLng

Wajib. Menunjukkan lokasi titik jalan perjalanan.

terminal_point_id

TerminalPointId

ID titik terminal.

access_point_id
(deprecated)

string

Tidak digunakan lagi.

trip_id
(deprecated)

string

Tidak digunakan lagi.

terminal_location_type
(deprecated)

WaypointType

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

TerminalPointId

Mengidentifikasi titik terminal.

Kolom
value

string

ID unik titik terminal.

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

string

Tidak digunakan lagi.

generated_id
(deprecated)

string

Tidak digunakan lagi.

TrafficPolylineData

Kondisi lalu lintas di sepanjang rute kendaraan yang diharapkan.

Kolom
traffic_rendering

VisualTrafficReportPolylineRendering

Rendering polyline yang menampilkan seberapa cepat lalu lintas untuk semua region di sepanjang satu jalur 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 penjemputan.

actual_pickup_point

StopLocation

Hanya input. Lokasi sebenarnya saat dan di mana pelanggan diambil. Kolom ini ditujukan bagi penyedia untuk memberikan masukan tentang informasi pengambilan yang sebenarnya.

actual_pickup_arrival_point

StopLocation

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

pickup_time

Timestamp

Hanya output. Baik perkiraan waktu penjemputan di masa mendatang atau waktu sebenarnya saat penumpang tersebut dijemput.

intermediate_destinations[]

TerminalLocation

Perhentian menengah dalam urutan permintaan perjalanan (selain pengambilan dan penurunan). Awalnya, fitur ini tidak akan didukung untuk perjalanan bersama.

intermediate_destinations_version

Timestamp

Menunjukkan waktu terakhir kali intermediate_destinations diubah. Server Anda harus menyimpan nilai ini ke dalam cache dan meneruskannya dalam UpdateTripRequest saat mengupdate 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 dilintasi kendaraan berikutnya. Jika TripStatus adalah ARRIVED_AT_INTERMEDIATE_DESTINATION, angka antara [0..N-1] yang menunjukkan tujuan perantara tempat kendaraan berada. Penyedia menetapkan nilai ini. Jika tidak ada intermediate_destinations, kolom ini akan diabaikan.

actual_intermediate_destination_arrival_points[]

StopLocation

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

actual_intermediate_destinations[]

StopLocation

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

dropoff_point

TerminalLocation

Lokasi tempat pelanggan menunjukkan bahwa mereka akan berhenti mengunjunginya.

actual_dropoff_point

StopLocation

Hanya input. Waktu dan lokasi aktual saat dan tempat pelanggan diturunkan. Kolom ini digunakan untuk memberikan masukan tentang informasi pengantaran yang sebenarnya.

dropoff_time

Timestamp

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

remaining_waypoints[]

TripWaypoint

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

vehicle_waypoints[]

TripWaypoint

Kolom ini mendukung pengurutan titik jalan secara manual untuk perjalanan. Daftar 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. Karena 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 rest_waypoints. Perhatikan, titik jalan pertama mungkin berasal dari 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. Decoding belum didukung.

current_route_segment_version

Timestamp

Hanya output. Menunjukkan waktu 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 saat tersedia.

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

current_route_segment_traffic_version

Timestamp

Hanya output. Menunjukkan waktu 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 ini tidak ditentukan jika perjalanan tidak ditetapkan ke kendaraan, atau perjalanan telah selesai atau dibatalkan.

eta_to_first_waypoint

Timestamp

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

remaining_time_to_first_waypoint

Duration

Hanya output. Durasi dari saat data Perjalanan ditampilkan ke waktu di Trip.eta_to_first_waypoint. Nilai ini 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 waktu terakhir kali remaining_waypoints.path_to_waypoint dan remaining_waypoints.traffic_to_waypoint diubah. Aplikasi klien Anda harus meng-cache nilai ini dan meneruskannya dalam GetTripRequest untuk memastikan jalur dan traffic untuk remaining_waypoints hanya ditampilkan jika diupdate.

number_of_passengers

int32

Tidak dapat diubah. Menunjukkan jumlah penumpang pada 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 yang dilaporkan untuk kendaraan di sepanjang rute.

last_location_snappable

bool

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

view

TripView

Subset kolom Perjalanan yang diisi dan cara penafsirannya.

TripStatus

Status perjalanan yang menunjukkan progresnya.

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

TripType

Jenis perjalanan.

Enum
UNKNOWN_TRIP_TYPE Default, digunakan untuk jenis perjalanan yang tidak ditentukan atau tidak dikenal.
SHARED Perjalanan tersebut mungkin menggunakan kendaraan yang sama dengan perjalanan lain.
EXCLUSIVE Perjalanan ini bersifat eksklusif untuk kendaraan.

TripView

Pemilih untuk kumpulan kolom Perjalanan yang berbeda dalam respons GetTrip. Lihat AIP-157 untuk konteks. Penayangan tambahan kemungkinan akan ditambahkan.

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

TripWaypoint

Menjelaskan titik perhentian pada rute kendaraan atau titik akhir pada perjalanan kendaraan.

Kolom
location

TerminalLocation

Lokasi titik jalan ini.

trip_id

string

Perjalanan yang terkait dengan titik jalan ini.

waypoint_type

WaypointType

Peran yang dimainkan titik jalan ini dalam perjalanan ini, seperti penjemputan atau penurunan.

path_to_waypoint[]

LatLng

Jalur dari titik jalan sebelumnya ke titik jalan saat ini. Tidak ditetapkan untuk titik jalan pertama dalam daftar. Kolom ini hanya diisi saat 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. Decoding belum didukung.

traffic_to_waypoint

ConsumableTrafficPolyline

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

distance_meters

Int32Value

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

eta

Timestamp

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

duration

Duration

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

UpdateTripRequest

Pesan permintaan UpdateTrip.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

trip

Trip

Wajib. Perjalanan yang terkait dengan update.

Kolom berikut dikelola oleh Fleet Engine. Jangan memperbaruinya 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 muncul sebelum titik pengantaran. Titik jalan perjalanan EXCLUSIVE tidak boleh disisipkan dengan perjalanan lain. Kolom trip_id, waypoint_type, dan location digunakan, dan semua kolom TripWaypoint lainnya di vehicle_waypoints akan diabaikan.

Guna menghindari kondisi race 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.

update_mask

FieldMask

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

UpdateVehicleAttributesRequest

UpdateVehicleAttributes pesan permintaan.

Kolom
header

RequestHeader

Header permintaan Fleet Engine standar.

name

string

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

attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

UpdateVehicleAttributes pesan respons.

Kolom
attributes[]

VehicleAttribute

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

UpdateVehicleLocationRequest

UpdateVehicleLocation pesan permintaan.

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 tempat akun layanan yang melakukan panggilan ini menjadi anggota.

current_location

VehicleLocation

Wajib. Lokasi terbaru kendaraan. Subkolom location dan update_time wajib diisi.

current_state

VehicleState

Tetapkan status kendaraan ke ONLINE atau OFFLINE. Jika ditetapkan ke UNKNOWN_VEHICLE_STATE, status kendaraan tidak akan diubah.

UpdateVehicleRequest

`Pesan permintaan UpdateKendaraan.

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 tempat akun layanan yang melakukan panggilan ini menjadi anggota.

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

update_mask

FieldMask

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

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 kendaraan yang terakhir dilaporkan.

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. Sebuah 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 di hasil SearchVehicles. Juga memengaruhi PWT dan perhitungan rute.

license_plate

LicensePlate

Informasi pelat nomor untuk kendaraan.

route[]
(deprecated)

TerminalLocation

Tidak digunakan lagi: Sebagai gantinya, gunakan Vehicle.waypoints.

current_route_segment

string

Polyline yang menetapkan 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. Decoding belum didukung.

current_route_segment_traffic

TrafficPolylineData

Hanya input. Fleet Engine menggunakan informasi ini untuk meningkatkan pengalaman 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. Pelacak dapat disimpan oleh klien dan diteruskan dalam permintaan GetVehicle mendatang untuk mencegah rute kembali yang belum berubah.

current_route_segment_end_point

TripWaypoint

Titik jalan tempat current_route_segment berakhir. Info ini dapat diberikan oleh pengemudi pada panggilan UpdateVehicle sebagai titik jalan perjalanan lengkap, titik jalan LatLng, atau sebagai LatLng terakhir dari current_route_segment. Fleet Engine akan melakukan yang terbaik untuk menginterpolasi titik jalan aktual jika tidak sepenuhnya ditetapkan. Kolom ini diabaikan dalam panggilan UpdateVehicle kecuali jika current_route_segment juga ditentukan.

remaining_distance_meters

Int32Value

Sisa jarak mengemudi 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

PWT ke entri pertama di kolom waypoints. Nilai tidak ditentukan jika kolom waypoints kosong atau kolom Vehicle.current_route_segment kosong.

Saat mengupdate kendaraan, remaining_time_seconds lebih diprioritaskan 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 jam yang sama.

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

waypoints[]

TripWaypoint

Titik jalan tersisa yang ditetapkan untuk Kendaraan ini.

waypoints_version

Timestamp

Hanya output. Terakhir kali kolom waypoints diperbarui. Klien harus meng-cache nilai ini dan meneruskannya dalam 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 dikenal.
AUTO Sebuah mobil.
TAXI Kendaraan apa pun yang bertindak sebagai taksi (biasanya berlisensi atau teregulasi).
TRUCK Umumnya, kendaraan dengan kapasitas penyimpanan yang besar.
TWO_WHEELER Sepeda motor, moped, atau kendaraan roda dua lainnya
BICYCLE Transportasi bertenaga manusia.
PEDESTRIAN Transportasi manusia, biasanya berjalan atau berlari, yang bepergian di sepanjang jalur pejalan kaki.

VehicleAttribute

Menjelaskan atribut kendaraan sebagai pasangan nilai kunci. Panjang string "key:value" tidak boleh lebih dari 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 string, bool, atau jenis ganda. vehicle_attribute_value hanya ada berupa salah satu diantara berikut:
string_value

string

Nilai atribut dengan jenis string.

Catatan: Kolom ini sama dengan kolom value yang pada akhirnya tidak akan digunakan lagi. Untuk metode pembuatan atau pembaruan, salah satu 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 akan diisi dalam respons.

bool_value

bool

Nilai atribut dengan jenis Boolean.

number_value

double

Nilai atribut diketik ganda.

VehicleAttributeList

Jenis data daftar-daftar untuk atribut kendaraan.

Kolom
attributes[]

VehicleAttribute

Daftar atribut dalam koleksi ini.

VehicleLocation

Lokasi, kecepatan, dan arah tujuan kendaraan pada waktu tertentu.

Kolom
location

LatLng

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

horizontal_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan latlng_accuracy.

latlng_accuracy

DoubleValue

Akurasi location dalam meter sebagai radius.

heading

Int32Value

Arah laju kendaraan dalam derajat. 0 mewakili Utara. Rentang yang valid adalah [0.360).

bearing_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan heading_accuracy.

heading_accuracy

DoubleValue

Akurasi heading dalam derajat.

altitude

DoubleValue

Ketinggian dalam meter di atas WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan altitude_accuracy.

altitude_accuracy

DoubleValue

Akurasi altitude dalam meter.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

Kecepatan kendaraan dalam meter/detik

speed_accuracy

DoubleValue

Akurasi speed dalam meter/detik.

update_time

Timestamp

Waktu saat location dilaporkan oleh sensor sesuai dengan 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 dipaskan ke 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. Ini akan nol untuk pembaruan pertama. Jika waktu tidak diketahui (misalnya, saat aplikasi dimulai ulang), nilai ini direset ke nol.

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

Lokasi kendaraan mentah (tidak diproses oleh kakap jalan).

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.

supplemental_location

LatLng

Lokasi tambahan yang disediakan oleh aplikasi yang mengintegrasikan.

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: Sebagai gantinya, gunakan is_road_snapped.

VehicleMatch

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

Kolom
vehicle

Vehicle

Wajib. Kendaraan yang sesuai dengan permintaan.

vehicle_pickup_eta

Timestamp

Kendaraan mengemudi PWT ke lokasi penjemputan yang ditentukan dalam permintaan. Nilai kosong menunjukkan kegagalan dalam menghitung PWT 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 meliputi 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 penjemputan 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

Kendaraan yang lengkap mengarahkan PWT ke titik pengantaran yang ditentukan dalam permintaan. PWT mencakup berhenti di setiap titik jalan sebelum dropoff_point yang ditentukan dalam permintaan. Nilai hanya akan diisi jika titik pengantaran ditentukan dalam permintaan. Nilai kosong menunjukkan error saat menghitung PWT.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Jarak mengemudi 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 penjemputan ke titik pengantaran yang ditentukan dalam permintaan.

trip_type

TripType

Wajib. Jenis perjalanan dari permintaan yang digunakan untuk menghitung PWT ke titik penjemputan.

vehicle_trips_waypoints[]

Waypoint

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

vehicle_match_type

VehicleMatchType

Jenis kendaraan yang cocok.

requested_ordered_by

VehicleMatchOrder

Pesanan yang diminta untuk menyortir kecocokan kendaraan.

ordered_by

VehicleMatchOrder

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

VehicleMatchType

Jenis pencocokan kendaraan.

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

VehicleState

Status Vehicle.

Enum
UNKNOWN_VEHICLE_STATE Default, digunakan untuk status kendaraan yang tidak ditentukan atau tidak dikenal.
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 bagaimana klien harus mewarnai satu bagian polyline di sepanjang rute.

Kolom
road_stretch[]

RoadStretch

Opsional. Jalan yang harus dirender di sepanjang polyline. Peregangan dijamin tidak akan tumpang tindih, dan tidak harus menjangkau seluruh rute.

Jika tidak ada jalan yang direntangkan untuk ditata, klien harus menerapkan {i>default<i} untuk rute.

RoadStretch

Satu peregangan 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 untuk menerapkan gaya.

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.

Titik jalan

Menjelaskan 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 kedatangan kendaraan di titik jalan ini.

WaypointType

Jenis titik jalan.

Enum
UNKNOWN_WAYPOINT_TYPE Jenis titik jalan tidak dikenal atau tidak ditentukan.
PICKUP_WAYPOINT_TYPE Titik jalan untuk mengambil penumpang atau item.
DROP_OFF_WAYPOINT_TYPE Titik jalan untuk mengantar penumpang atau barang.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Titik jalan untuk tujuan perantara dalam perjalanan multi-tujuan.