Package maps.fleetengine.v1

BatteryStatus

Status baterai, apakah penuh atau mengisi daya, dll.

PowerSource

Status sumber daya baterai.

float

Persentase baterai saat ini [0-100].

SpeedReadingInterval

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

string

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

string

Wajib. ID Perjalanan Unik. Tunduk kepada batasan berikut:

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

Trip

Wajib. Entitas perjalanan yang akan dibuat.

Saat membuat Perjalanan, kolom-kolom berikut wajib diisi:

• trip_type
• pickup_point

Kolom berikut digunakan jika Anda memberikannya:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

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

Hanya EXCLUSIVE perjalanan yang mendukung intermediate_destinations.

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

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

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

string

Wajib. ID Kendaraan Unik. Tunduk kepada batasan berikut:

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

Vehicle

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

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Saat membuat Kendaraan, kolom berikut diabaikan:

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

Semua kolom lainnya bersifat opsional dan digunakan jika disediakan.

LocationPowerSaveMode

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

bool

Apakah perangkat saat ini dalam mode hemat daya.

bool

Apakah perangkat dalam status interaktif.

BatteryInfo

Informasi tentang status baterai.

RequestHeader

Header permintaan Fleet Engine standar.

string

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

TripView

Subkumpulan kolom Perjalanan yang harus ditampilkan dan penafsirannya.

Timestamp

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

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) tempat Trip.remaining_waypoints diambil. Jika tidak berubah sejak stempel waktu ini, remaining_waypoints tidak disetel dalam respons. Jika kolom ini tidak ditentukan, remaining_waypoints akan selalu diambil.

PolylineFormatType

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

Timestamp

Menunjukkan stempel waktu minimum (eksklusif) tempat 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 Pengiriman dan Perjalanan On-Demand.

Timestamp

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

Timestamp

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

Timestamp

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

string

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

string

Angka terakhir pelat nomor atau "-1" untuk menunjukkan tidak ada nilai numerik pada pelat nomor kendaraan.

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

int32

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

string

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

Int32Value

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

TripType

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

Duration

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

Category

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

string

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

required_attributes adalah daftar; required_one_of_attributes menggunakan pesan yang mengizinkan daftar daftar. Dalam kombinasi, kedua kolom tersebut 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. Jumlah atribut yang diizinkan maksimum 50 adalah 50. Jumlah ini sesuai dengan jumlah atribut maksimum yang diizinkan di kendaraan. Setiap string berulang harus memiliki format "key:value".

string

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

string

required_one_of_attribute_sets menyediakan fungsi tambahan.

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

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

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

VehicleState

Membatasi respons terhadap kendaraan yang memiliki status kendaraan ini.

bool

Hanya kembalikan kendaraan dengan perjalanan saat ini.

string

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

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

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

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

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

Viewport

Opsional. Filter yang membatasi pengembalian kendaraan ke mobil yang lokasi terakhirnya diketahui berada di area persegi panjang yang ditentukan oleh area pandang.

Vehicle

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

string

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

int64

Wajib. Total jumlah kendaraan yang cocok dengan kriteria permintaan di semua halaman.

string

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

string

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

BillingPlatformIdentifier

Platform tempat permintaan dikeluarkan.

string

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

SolutionType

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

string

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

string

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

string

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

string

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

string

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

SdkType

Jenis SDK yang mengirim permintaan.

string

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

string

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

Platform

Platform SDK panggilan.

string

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

int32

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

string

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

string

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

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

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

int32

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

string

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

Duration

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

Trip

Daftar perjalanan untuk kendaraan yang diminta.

string

Teruskan token ini di SearchTripsRequest ke halaman melalui hasil daftar. API menampilkan daftar perjalanan pada setiap panggilan, dan jika tidak ada hasil lagi, daftar perjalanan tetap kosong.

RequestHeader

Header permintaan Fleet Engine standar.

string

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

TerminalLocation

Wajib. Titik penjemputan untuk menelusuri di dekat.

TerminalLocation

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

int32

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

int32

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

int32

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

TripType

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

Duration

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

VehicleType

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

VehicleAttribute

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

required_attributes adalah daftar; required_one_of_attributes menggunakan pesan yang mengizinkan daftar daftar. Dalam kombinasi, kedua kolom tersebut memungkinkan komposisi ekspresi ini:

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

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

VehicleAttributeList

Membatasi penelusuran hanya 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 adalah operasi disjungsi/OR inklusif di setiap VehicleAttributeList dan operasi konjungsi/AND di seluruh kumpulan VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets menyediakan fungsi tambahan.

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

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

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

VehicleMatchOrder

Wajib. Menentukan kriteria pengurutan yang diinginkan untuk hasil.

bool

Detail 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 berupa true, hasil penelusuran dapat menyertakan kendaraan dengan satu perjalanan aktif yang memiliki status ENROUTE_TO_DROPOFF. Jika current_trips_present ditentukan, kolom ini tidak dapat ditetapkan ke benar (true).

Nilai default-nya adalah false.

string

Menunjukkan perjalanan yang terkait dengan SearchVehicleRequest ini.

CurrentTripsPresent

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

string

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

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

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

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

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

VehicleMatch

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

int32

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

int32

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

Speed

Kecepatan lalu lintas dalam interval ini.

LatLng

Wajib. Menunjukkan lokasi sebenarnya.

Timestamp

Menunjukkan kapan penghentian terjadi.

Timestamp

Input saja. Tidak digunakan lagi. Gunakan kolom stempel waktu.

LatLng

Wajib. Menunjukkan lokasi titik jalan perjalanan.

TerminalPointId

Tidak digunakan lagi: Sebagai gantinya, tentukan kolom point.

string

Tidak digunakan lagi: Sebagai gantinya, tentukan kolom point.

string

Tidak digunakan lagi.

WaypointType

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

string

Tidak digunakan lagi.

string

Tidak digunakan lagi.

string

Tidak digunakan lagi.

VisualTrafficReportPolylineRendering

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

string

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

string

ID kendaraan yang melakukan perjalanan ini.

TripStatus

Status perjalanan saat ini.

TripType

Jenis perjalanan.

TerminalLocation

Lokasi yang menunjukkan bahwa pelanggan akan dijemput.

StopLocation

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

StopLocation

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

Timestamp

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

TerminalLocation

Perhentian menengah agar perjalanan diminta (selain pengangkutan dan penurunan penumpang). Awalnya, fitur ini tidak akan didukung untuk perjalanan bersama.

Timestamp

Menunjukkan waktu terakhir intermediate_destinations diubah. Server harus menyimpan nilai ini dalam cache dan meneruskannya dalam UpdateTripRequest saat mengupdate intermediate_destination_index untuk memastikan intermediate_destinations tidak berubah.

int32

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

StopLocation

Input saja. Waktu dan lokasi sebenarnya dari kedatangan pengemudi di tujuan perantara. Kolom ini digunakan penyedia untuk memberikan masukan tentang informasi kedatangan aktual di tujuan perantara.

StopLocation

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

TerminalLocation

Lokasi tempat pelanggan menunjukkan bahwa mereka akan diturunkan.

StopLocation

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

Timestamp

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

TripWaypoint

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

TripWaypoint

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

LatLng

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

string

Hanya output. Jalur yang dienkode ke titik jalan berikutnya.

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

Timestamp

Hanya output. Menunjukkan waktu terakhir rute diubah.

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

ConsumableTrafficPolyline

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

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

Timestamp

Hanya output. Menunjukkan waktu terakhir current_route_segment_traffic diubah.

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

TripWaypoint

Hanya output. Titik jalan tempat current_route_segment berakhir.

Int32Value

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

Timestamp

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

Duration

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

Timestamp

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

Timestamp

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

int32

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

VehicleLocation

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

bool

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

TripView

Subkumpulan kolom Perjalanan yang diisi dan cara kolom tersebut harus ditafsirkan.

TerminalLocation

Lokasi titik jalan ini.

string

Perjalanan yang dikaitkan dengan titik jalan ini.

WaypointType

Peran titik jalan ini dalam perjalanan ini, seperti pengangkutan atau penurunan penumpang.

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.

string

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

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

ConsumableTrafficPolyline

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

Int32Value

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

Timestamp

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

Duration

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

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, urutan tidak akan ditentukan.

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

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

FieldMask

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

VehicleAttribute

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

VehicleAttribute

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

RequestHeader

Header permintaan Fleet Engine standar.

string

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

Vehicle

Wajib. Nilai entity Vehicle yang akan diterapkan. Saat mengupdate 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 saat ini di kendaraan, dan tidak boleh ada titik jalan lainnya.

FieldMask

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

string

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

VehicleState

Status kendaraan.

TripType

Jenis perjalanan yang didukung oleh kendaraan ini.

string

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

VehicleLocation

Lokasi kendaraan yang terakhir dilaporkan.

int32

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

VehicleAttribute

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

VehicleType

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

LicensePlate

Informasi pelat nomor untuk kendaraan.

TerminalLocation

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

string

Polyline yang menetapkan rute yang akan diambil aplikasi pengemudi ke titik jalan berikutnya. Daftar ini juga ditampilkan dalam Trip.current_route_segment untuk semua perjalanan aktif yang ditetapkan untuk kendaraan.

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

TrafficPolylineData

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

Timestamp

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

TripWaypoint

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

Int32Value

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

Timestamp

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 akan lebih diprioritaskan daripada eta_to_first_waypoint dalam permintaan yang sama.

Int32Value

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

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

TripWaypoint

Titik jalan yang tersisa yang ditetapkan untuk Kendaraan ini.

Timestamp

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

bool

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

NavigationStatus

Status navigasi kendaraan.

DeviceSettings

Input saja. Informasi tentang setelan di perangkat seluler yang digunakan oleh pengemudi.

Category

Kategori jenis kendaraan

string

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

string

Nilai atribut.

string

Nilai atribut berjenis string.

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

bool

Nilai atribut yang diketik Boolean.

double

Nilai atribut dengan jenis ganda.

VehicleAttribute

Daftar atribut dalam koleksi ini.

LatLng

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

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan latlng_accuracy.

DoubleValue

Akurasi location dalam meter sebagai radius.

Int32Value

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

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan heading_accuracy.

DoubleValue

Akurasi heading dalam derajat.

DoubleValue

Ketinggian dalam meter di atas WGS84.

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan altitude_accuracy.

DoubleValue

Akurasi altitude dalam meter.

Int32Value

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

DoubleValue

Kecepatan kendaraan dalam meter/detik

DoubleValue

Akurasi speed dalam meter/detik.

Timestamp

Waktu saat location dilaporkan oleh sensor menurut jam sensor.

Timestamp

Hanya output. Waktu saat server menerima informasi lokasi.

LocationSensor

Penyedia data lokasi (misalnya, GPS).

BoolValue

Apakah location dipaskan ke jalan.

BoolValue

Input saja. Menunjukkan apakah sensor GPS diaktifkan pada perangkat seluler.

Int32Value

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

Int32Value

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

LatLng

Lokasi kendaraan mentah (tidak diproses oleh pemukul jalan).

Timestamp

Stempel waktu yang terkait dengan lokasi mentah.

LocationSensor

Sumber lokasi mentah. Default-nya adalah GPS.

DoubleValue

Akurasi raw_location sebagai radius, dalam meter.

LatLng

Lokasi tambahan yang disediakan oleh aplikasi yang mengintegrasikan.

Timestamp

Stempel waktu yang terkait dengan lokasi tambahan.

LocationSensor

Sumber lokasi tambahan. Default-nya adalah CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Akurasi supplemental_location sebagai radius, dalam meter.

bool

Tidak digunakan lagi: Sebagai gantinya, gunakan is_road_snapped.

Vehicle

Wajib. Kendaraan yang sesuai dengan permintaan.

Timestamp

PWT mengemudi kendaraan 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 yang aktif, vehicle_pickup_eta menyertakan waktu yang diperlukan untuk menyelesaikan perjalanan yang aktif saat ini.

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 mencakup 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 saat menghitung jarak.

Int32Value

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

Timestamp

PWT mengemudi kendaraan lengkap ke titik penurunan yang ditentukan dalam permintaan. PWT mencakup perhentian di setiap titik jalan sebelum dropoff_point yang ditentukan dalam permintaan. Nilai hanya akan diisi jika titik penurunan ditentukan dalam permintaan. Nilai kosong menunjukkan error saat menghitung PWT.

Int32Value

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

TripType

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

Waypoint

Daftar titik jalan yang diurutkan yang digunakan untuk menghitung PWT. Daftar tersebut 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.

VehicleMatchType

Kecocokan jenis kendaraan.

VehicleMatchOrder

Pesanan yang diminta untuk mengurutkan kecocokan kendaraan.

VehicleMatchOrder

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

RoadStretch

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

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

Style

Wajib. Gaya yang akan diterapkan.

int32

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

int32

Wajib. Panjang jalur tempat gaya akan diterapkan.

LatLng

Lokasi titik jalan ini.

Timestamp

Perkiraan waktu kendaraan akan tiba di titik jalan ini.