Trip and Order Progress

Class FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider class
extends PollingLocationProvider
library "journeySharing"

Penyedia lokasi perjalanan.

const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing");
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 yang memperhitungkan lalu lintas 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 yang memperhitungkan lalu lintas untuk polyline yang tersisa.
tripId
Jenis: string
ID untuk perjalanan yang diamati oleh penyedia lokasi ini. Tetapkan kolom ini untuk mulai melacak.
Diwarisi: isPolling, pollingIntervalMillis
refresh
refresh()
Parameter: Tidak ada
Nilai Hasil: void
Memperbarui lokasi yang dilacak secara eksplisit.
Diwarisi: addListener
error
function(event)
Argumen:
Peristiwa yang dipicu saat penyedia lokasi mengalami error.
update
function(event)
Argumen:
Peristiwa yang dipicu saat permintaan update data Fleet Engine telah selesai.
Diwarisi: 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
opsional
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, sehingga menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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 atau belum.

    Lihat TripPolylineCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
destinationMarkerCustomization
opsional
Jenis: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Penyesuaian 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, sehingga menimpa opsi defaultnya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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
opsional
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 ke penanda setelah penanda dibuat, sehingga menimpa opsi defaultnya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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
opsional
Jenis: number optional
Waktu minimum antara pengambilan pembaruan lokasi dalam milidetik. Jika diperlukan 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 akan diambil jika ada parameter yang diamati oleh penyedia lokasi berubah.

Interval polling default adalah 5.000 milidetik, yang merupakan interval minimum. Jika Anda menetapkan interval polling ke nilai bukan nol yang lebih rendah, 5000 akan digunakan.
remainingPolylineCustomization
opsional
Penyesuaian diterapkan ke polyline yang tersisa. Polyline yang tersisa sesuai dengan bagian rute yang belum mulai 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, sehingga menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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 atau belum.

    Lihat TripPolylineCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
takenPolylineCustomization
opsional
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, sehingga menimpa opsi default-nya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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 atau belum.

    Lihat TripPolylineCustomizationFunctionParams untuk mengetahui daftar parameter yang disediakan dan penggunaannya.
tripId
opsional
Jenis: string optional
ID perjalanan yang akan dilacak segera setelah penyedia lokasi dibuat instance-nya. Jika tidak ditentukan, penyedia lokasi tidak akan mulai melacak perjalanan apa pun; gunakan FleetEngineTripLocationProvider.tripId untuk menetapkan ID dan memulai pelacakan.
vehicleMarkerCustomization
opsional
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, sehingga menimpa opsi defaultnya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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
opsional
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, sehingga menimpa opsi defaultnya jika ada.
  • Jika ditentukan, fungsi akan dipanggil sekali 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
opsional
Jenis: Trip optional
Struktur perjalanan yang ditampilkan oleh update. Tidak dapat diubah.