Menyesuaikan penanda

Pilih platform: Android iOS JavaScript

Sesuaikan tampilan dan nuansa penanda yang ditambahkan ke peta. Sesuaikan tampilan dan nuansa penanda yang ditambahkan ke peta dengan dua cara:

  1. Penanda gaya berdasarkan jenis: Tentukan MarkerOptions untuk memberi gaya penanda dengan jenis yang sama. Perubahan yang Anda tetapkan kemudian diterapkan setelah setiap penanda dibuat, yang menimpa opsi default apa pun. Untuk contoh, lihat Ubah gaya visual penanda menggunakan MarkerOptions dalam hal ini kami.

  2. Penanda gaya berdasarkan data: Tentukan fungsi penyesuaian untuk penanda gaya berdasarkan data. Anda bisa menata gaya berdasarkan data dari perjalanan dari sumber luar:

    • Data dari berbagi perjalanan: Berbagi perjalanan meneruskan data penanda ke fungsi penyesuaian, termasuk jenis objek yang diwakili penanda: kendaraan, asal, titik jalan atau tujuan. Gaya visual penanda kemudian berubah berdasarkan status elemen penanda saat ini. Misalnya, jumlah titik jalan yang tersisa hingga kendaraan menyelesaikan perjalanan.

    • Sumber luar: Anda dapat menggabungkan data berbagi perjalanan dengan data dari sumber di luar Fleet Engine dan memberi gaya penanda berdasarkan informasi.

    Untuk contoh, lihat Mengubah gaya visual penanda menggunakan fungsi penyesuaian dalam panduan ini.

  3. Menambahkan penanganan klik ke penanda: Misalnya, lihat Menambahkan penanganan klik.

Opsi penyesuaian penanda

Kedua opsi tersebut menggunakan parameter penyesuaian berikut di Maps JavaScript API dengan FleetEngineTripLocationProviderOptions:

Ubah gaya visual penanda menggunakan MarkerOptions

Contoh berikut menunjukkan cara mengonfigurasi gaya visual penanda kendaraan dengan objek MarkerOptions. Ikuti pola ini untuk menyesuaikan gaya visual penanda menggunakan salah satu penyesuaian penanda yang tercantum di Opsi penyesuaian penanda.

JavaScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

TypeScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

Mengubah gaya visual penanda menggunakan fungsi penyesuaian

Contoh berikut menunjukkan cara mengonfigurasi gaya visual penanda kendaraan menggunakan fungsi penyesuaian. Ikuti pola ini untuk menyesuaikan gaya visual penanda menggunakan salah satu parameter penyesuaian penanda yang tercantum dalam Opsi penyesuaian penanda.

JavaScript

vehicleMarkerCustomization =
  (params) => {
    var distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    const distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
};

Menambahkan penanganan klik ke penanda

Contoh berikut menunjukkan cara menambahkan penanganan klik ke penanda kendaraan. Ikuti pola ini untuk menambahkan penanganan klik ke penanda menggunakan penanda mana pun parameter penyesuaian yang tercantum dalam Opsi penyesuaian penanda.

JavaScript

vehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

Langkah berikutnya