Menyesuaikan penanda

Pilih platform: Android iOS JavaScript

Class ConsumerMapStyle menyediakan metode penyetel dan pengambil dengan penyesuaian dinamis untuk penanda dan polyline. Anda mengekspos class ini secara asinkron menggunakan metode ConsumerController.getConsumerMapStyle().

Penyesuaian UI akan tetap ada di seluruh rotasi perangkat dan akan tetap berlaku hingga Anda melepaskan ConsumerController.

Menyesuaikan penanda

Untuk menetapkan jenis penanda dan propertinya, gunakan metode ConsumerMapStyle.setMarkerStyleOptions(). Opsi penanda kustom Anda akan menggantikan nilai default yang disediakan oleh Consumer SDK. Untuk memulihkan nilai default, panggil setMarkerStyleOptions() menggunakan null untuk parameter MarkerOptions. Ambil MarkerOptions aktif menggunakan getMarkerStyleOptions().

Pilih jenis penanda

Anda dapat menggunakan dan menyesuaikan ikon penanda berikut:

• TRIP_PICKUP_POINT - Ditampilkan saat mengikuti perjalanan
• TRIP_DROPOFF_POINT - Ditampilkan saat mengikuti perjalanan
• TRIP_INTERMEDIATE_DESTINATION

• TRIP_VEHICLE - Ditampilkan saat mengikuti perjalanan

  Consumer SDK memperbarui rotasi ikon TRIP_VEHICLE selama pemantauan perjalanan untuk meniru perilaku kendaraan yang sebenarnya saat melaju di rute.

Catatan: Untuk hasil animasi yang paling realistis, gunakan perspektif tampilan atas untuk TRIP_VEHICLE, dengan bagian depan kendaraan diorientasikan ke atas.

Catatan: Ikon penanda tidak berubah sesuai dengan jenis kendaraan sebenarnya untuk perjalanan.

Pilih opsi penanda

Anda dapat menyesuaikan penanda untuk aplikasi konsumen dengan mengikuti langkah-langkah berikut:

1. Gunakan properti untuk setiap penanda yang diberikan oleh Google Maps MarkerOptions.

2. Build MarkerOptions menggunakan konstruktornya.

3. Tentukan properti khusus menggunakan metode gaya 'Setter'.

   Catatan: Karena SDK menyediakan nilai default untuk setiap properti penanda, hanya tentukan properti kustom untuk nilai yang ingin Anda ubah.

4. Jika ingin, gunakan elemen UI Anda sendiri dengan meniru pola yang disediakan oleh konstruktor MarkerOptions.

5. Untuk menonaktifkan penanda, tetapkan properti visible ke false. Anda kemudian dapat menggunakan elemen UI sebagai penggantinya.

Untuk informasi selengkapnya, lihat MarkerOptions Google Maps.

Contoh penyesuaian penanda

Java

// Initializing marker options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setMarkerStyleOptions(
              MarkerType.TRIP_VEHICLE,
              new MarkerOptions()
                  .visible(false));
        });

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null);

Kotlin

// Initializing marker options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, MarkerOptions().visible(false))
  })

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null)

Langkah berikutnya

• Menyesuaikan polyline rute