Trip and Order Progress

Class FleetEngineTripLocationProvider

Class google.maps.journeySharing.FleetEngineTripLocationProvider

Penyedia lokasi perjalanan.

Class ini memperluas PollingLocationProvider.

Akses dengan memanggil const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). Lihat Library di Maps JavaScript API.

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parameter: 
Membuat penyedia lokasi baru untuk perjalanan Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parameter: 
Nilai yang Ditampilkan:  Tidak ada
Fungsi penyesuaian polyline yang mewarnai polyline aktif sesuai dengan pembacaan kecepatannya. Tentukan fungsi ini sebagai FleetEngineTripLocationProviderOptions.activePolylineCustomization untuk merender polyline yang mempertimbangkan lalu lintas untuk polyline aktif.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parameter: 
Nilai yang Ditampilkan:  Tidak ada
Fungsi penyesuaian polyline yang mewarnai polyline yang tersisa sesuai dengan pembacaan kecepatannya. Tentukan fungsi ini sebagai FleetEngineTripLocationProviderOptions.remainingPolylineCustomization untuk merender polyline yang mempertimbangkan traffic untuk polyline yang tersisa.
tripId
Jenis:  string
ID untuk perjalanan yang diamati penyedia lokasi ini. Tetapkan kolom ini untuk memulai pelacakan.
Diwariskan: isPolling, pollingIntervalMillis
refresh
refresh()
Parameter:  Tidak ada
Nilai Hasil:  void
Memperbarui lokasi yang dilacak secara eksplisit.
Diwariskan: addListener
error
function(event)
Argumen: 
Peristiwa yang dipicu saat penyedia lokasi mengalami error.
update
function(event)
Peristiwa yang dipicu saat permintaan pembaruan data Fleet Engine selesai.
Diwariskan: ispollingchange

Antarmuka FleetEngineTripLocationProviderOptions

Antarmuka google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Opsi untuk penyedia lokasi perjalanan.

authTokenFetcher
Memberikan Token Web JSON untuk mengautentikasi klien ke Fleet Engine.
projectId
Jenis:  string
Project ID konsumen dari Konsol Google Cloud.
activePolylineCustomization optional
Jenis:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Penyesuaian diterapkan ke polyline aktif. Polyline aktif sesuai dengan bagian rute yang saat ini dilalui kendaraan.

Gunakan kolom ini untuk menentukan gaya kustom (seperti warna polyline) dan interaktivitas (seperti penanganan klik).
  • Jika objek PolylineOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke polyline setelah polyline dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat polyline dibuat. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat koordinat polyline berubah, atau saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan polyline ini telah berubah.

    Lihat TripPolylineCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
destinationMarkerCustomization optional
Jenis:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Penyesuaian yang diterapkan ke penanda tujuan.

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti ikon penanda) dan interaktivitas (seperti penanganan klik).
  • Jika objek MarkerOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke penanda setelah penanda dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat penanda dibuat, sebelum ditambahkan ke tampilan peta. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan penanda ini telah berubah.

    Lihat TripMarkerCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
originMarkerCustomization optional
Jenis:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Penyesuaian yang diterapkan ke penanda asal.

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti ikon penanda) dan interaktivitas (seperti penanganan klik).
  • Jika objek MarkerOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke penanda setelah penanda dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat penanda dibuat, sebelum ditambahkan ke tampilan peta. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan penanda ini telah berubah.

    Lihat TripMarkerCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
pollingIntervalMillis optional
Jenis:  number optional
Waktu minimum antara pengambilan update lokasi dalam milidetik. Jika memerlukan waktu lebih dari pollingIntervalMillis untuk mengambil pembaruan lokasi, pembaruan lokasi berikutnya tidak akan dimulai hingga pembaruan saat ini selesai.

Menetapkan nilai ini ke 0 akan menonaktifkan pembaruan lokasi berulang. Pembaruan lokasi baru diambil jika salah satu parameter yang diamati oleh penyedia lokasi berubah.

Interval polling default adalah 5.000 milidetik, interval minimum. Jika Anda menetapkan interval polling ke nilai non-nol yang lebih rendah, 5000 akan digunakan.
remainingPolylineCustomization optional
Jenis:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Penyesuaian diterapkan ke polyline yang tersisa. Polyline yang tersisa sesuai dengan bagian rute yang belum dilalui kendaraan.

Gunakan kolom ini untuk menentukan gaya kustom (seperti warna polyline) dan interaktivitas (seperti penanganan klik).
  • Jika objek PolylineOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke polyline setelah polyline dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat polyline dibuat. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat koordinat polyline berubah, atau saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan polyline ini telah berubah.

    Lihat TripPolylineCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
takenPolylineCustomization optional
Jenis:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Penyesuaian diterapkan ke polyline yang diambil. Polyline yang diambil sesuai dengan bagian rute yang telah dilalui kendaraan.

Gunakan kolom ini untuk menentukan gaya kustom (seperti warna polyline) dan interaktivitas (seperti penanganan klik).
  • Jika objek PolylineOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke polyline setelah polyline dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat polyline dibuat. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat koordinat polyline berubah, atau saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan polyline ini telah berubah.

    Lihat TripPolylineCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
tripId optional
Jenis:  string optional
ID perjalanan yang akan dilacak segera setelah instance penyedia lokasi dibuat. Jika tidak ditentukan, penyedia lokasi tidak akan mulai melacak perjalanan apa pun; gunakan FleetEngineTripLocationProvider.tripId untuk menetapkan ID dan mulai melacak.
vehicleMarkerCustomization optional
Jenis:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Penyesuaian yang diterapkan ke penanda kendaraan.

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti ikon penanda) dan interaktivitas (seperti penanganan klik).
  • Jika objek MarkerOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke penanda setelah penanda dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat penanda dibuat, sebelum ditambahkan ke tampilan peta. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan penanda ini telah berubah.

    Lihat TripMarkerCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
waypointMarkerCustomization optional
Penyesuaian yang diterapkan ke penanda titik jalan.

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti ikon penanda) dan interaktivitas (seperti penanganan klik).
  • Jika objek MarkerOptions ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke penanda setelah penanda dibuat, yang akan menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil satu kali saat penanda dibuat, sebelum ditambahkan ke tampilan peta. (Pada pemanggilan ini, parameter isNew dalam objek parameter fungsi ditetapkan ke true.) Selain itu, fungsi ini dipanggil saat penyedia lokasi menerima data dari Fleet Engine, terlepas dari apakah data yang sesuai dengan penanda ini telah berubah.

    Lihat TripWaypointMarkerCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.

Antarmuka FleetEngineTripLocationProviderUpdateEvent

Antarmuka google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

Objek peristiwa yang diteruskan ke pengendali peristiwa saat peristiwa FleetEngineTripLocationProvider.update dipicu.

trip optional
Jenis:  Trip optional
Struktur perjalanan yang ditampilkan oleh update. Tidak dapat diubah.