Personnaliser les repères

Sélectionnez une plate-forme : Android iOS JavaScript

La classe ConsumerMapStyle fournit des méthodes de setter et de getter avec une 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 dissociiez ConsumerController.

Personnaliser les repères

Pour définir le type de repère et ses propriétés, utilisez la méthode ConsumerMapStyle.setMarkerStyleOptions(). Vos options de repère personnalisées remplacent les valeurs par défaut fournies par le SDK Consumer. Pour restaurer les valeurs par défaut, appelez setMarkerStyleOptions() à l'aide de null pour le paramètre MarkerOptions. Récupérez le MarkerOptions actif à l'aide de 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 lorsque vous suivez un trajet
• TRIP_DROPOFF_POINT : s'affiche lorsque vous suivez un trajet
• TRIP_INTERMEDIATE_DESTINATION

• TRIP_VEHICLE : s'affiche lorsque vous suivez un trajet

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

Remarque:Pour obtenir des résultats d'animation les plus réalistes possible, utilisez une perspective en vue du dessus pour TRIP_VEHICLE, avec l'avant du véhicule orienté vers le haut.

Remarque:L'icône du repère ne change pas en fonction du type de véhicule utilisé pour le trajet.

Sélectionner des options de repère

Pour personnaliser les repères de votre application grand public, procédez comme suit:

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

2. Créez MarkerOptions à l'aide de son constructeur.

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

   Remarque :Étant donné que le SDK fournit des valeurs par défaut pour chaque propriété de repère, ne spécifiez des propriétés personnalisées que pour les valeurs que vous souhaitez modifier.

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'interface utilisateur à la place.

Pour en savoir plus, consultez Google Maps MarkerOptions.

Exemples de personnalisations de repères

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

• Personnaliser les polylignes de parcours