Personnaliser les repères

Sélectionnez une plate-forme : Android iOS JavaScript

La classe ConsumerMapStyle fournit des méthodes setter et getter avec personnalisation dynamique pour les repères et les polylignes. Vous exposez cette classe de manière asynchrone à l'aide de la méthode ConsumerController.getConsumerMapStyle().

La personnalisation de l'UI persiste lors des rotations de l'appareil et reste en vigueur jusqu'à ce que vous détachiez ConsumerController.

Personnaliser les repères

Pour définir le type de marqueur et ses propriétés, utilisez la méthode ConsumerMapStyle.setMarkerStyleOptions(). Vos options de marqueurs personnalisés remplacent les valeurs par défaut fournies par le SDK consommateur. Pour restaurer les valeurs par défaut, appelez setMarkerStyleOptions() en utilisant null pour le paramètre MarkerOptions. Récupérez l'élément actif MarkerOptions en utilisant getMarkerStyleOptions().

Sélectionnez un type de repère

Vous pouvez utiliser et personnaliser les icônes de repère suivantes :

  • TRIP_PICKUP_POINT - S'affiche pendant le suivi d'un trajet
  • TRIP_DROPOFF_POINT - S'affiche pendant le suivi d'un trajet
  • TRIP_INTERMEDIATE_DESTINATION

  • TRIP_VEHICLE - S'affiche pendant le suivi d'un trajet

    Le SDK Consumer met à jour la rotation de l'icône TRIP_VEHICLE pendant la surveillance du trajet pour imiter le comportement du véhicule réel lorsqu'il parcourt l'itinéraire.

Options de sélection du marqueur

Vous pouvez personnaliser les marqueurs de votre application grand public en suivant ces étapes :

  1. Utilisez les propriétés de chaque repère fournies par Google Maps MarkerOptions.

  2. Construisez MarkerOptions en utilisant son constructeur.

  3. Spécifiez des propriétés personnalisées à l'aide de méthodes de style "Setter".

  4. Si vous préférez, utilisez votre propre élément d'interface utilisateur en imitant les modèles fournis par le constructeur MarkerOptions.

  5. Pour désactiver un repère, définissez la propriété visible sur false. Vous pouvez ensuite utiliser votre propre élément d'UI à la place.

Pour en savoir plus, consultez Google Maps MarkerOptions.

Exemples de personnalisation de marqueurs

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)

Étape suivante