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 Hasil: Tidak ada
Fungsi penyesuaian polyline yang mewarnai polyline aktif sesuai dengan pembacaan kecepatannya. Tentukan fungsi ini sebagai FleetEngineTripLocationProviderOptions.activePolylineCustomization untuk merender polyline berbasis traffic untuk polyline aktif.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parameter: 
Nilai Hasil: Tidak ada
Fungsi penyesuaian polyline yang mewarnai polyline yang tersisa sesuai dengan pembacaan kecepatannya. Tentukan fungsi ini sebagai FleetEngineTripLocationProviderOptions.remainingPolylineCustomization untuk merender polyline berbasis traffic untuk polyline yang tersisa.
tripId
Jenis:  string
ID untuk perjalanan yang diamati oleh 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 telah selesai.
Diwariskan: ispollingchange

Antarmuka FleetEngineTripLocationProviderOptions

Antarmuka google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Opsi untuk penyedia lokasi perjalanan.

authTokenFetcher
Menyediakan 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 pada polyline aktif. Polyline aktif sesuai dengan bagian rute yang saat ini dilalui kendaraan.

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti warna polyline) dan interaktivitas (seperti penanganan klik).
  • Jika objek PolylineOptions telah ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke polyline setelah polyline dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika sebuah fungsi ditetapkan, fungsi tersebut 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 berkaitan dengan polyline ini telah berubah.

    Lihat TripPolylineCustomizationFunctionParams untuk daftar parameter yang disediakan dan penggunaannya.
destinationMarkerCustomization optional
Jenis:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Penyesuaian diterapkan pada 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 pada penanda setelah penanda dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika fungsi ditetapkan, 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 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 pada penanda setelah penanda dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika fungsi ditetapkan, 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 pembaruan lokasi dalam milidetik. Jika 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. Update lokasi baru akan diambil jika ada parameter yang diamati oleh penyedia lokasi berubah.

Interval polling default adalah 5.000 milidetik, yaitu interval minimum. Jika Anda menetapkan interval polling ke nilai selain 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 mulai dilalui kendaraan.

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti warna polyline) dan interaktivitas (seperti penanganan klik).
  • Jika objek PolylineOptions telah ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke polyline setelah polyline dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika sebuah fungsi ditetapkan, fungsi tersebut 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 berkaitan dengan polyline ini telah berubah.

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

Gunakan kolom ini untuk menentukan gaya visual kustom (seperti warna polyline) dan interaktivitas (seperti penanganan klik).
  • Jika objek PolylineOptions telah ditentukan, perubahan yang ditentukan di dalamnya akan diterapkan ke polyline setelah polyline dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika sebuah fungsi ditetapkan, fungsi tersebut 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 berkaitan dengan polyline ini telah berubah.

    Lihat TripPolylineCustomizationFunctionParams untuk daftar parameter yang disediakan dan penggunaannya.
tripId optional
Jenis:  string optional
ID perjalanan untuk dilacak segera setelah penyedia lokasi dibuat instance-nya. Jika tidak ditentukan, penyedia lokasi tidak akan mulai melacak perjalanan; gunakan FleetEngineTripLocationProvider.tripId untuk menyetel ID dan memulai pelacakan.
vehicleMarkerCustomization optional
Jenis:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Penyesuaian diterapkan pada 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 pada penanda setelah penanda dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika fungsi ditetapkan, 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 diterapkan pada 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 pada penanda setelah penanda dibuat, yang menimpa opsi defaultnya jika ada.
  • Jika fungsi ditetapkan, 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.