Repères

Utilisez des repères pour attirer l'attention d'un utilisateur sur un emplacement sur une carte. Ce guide explique comment utiliser et personnaliser les repères dans les cartes 3D. Vous pouvez contrôler la forme, la taille et la couleur des repères, ainsi que l'altitude à laquelle ils apparaissent.

Utilisez des repères pour afficher des lieux sur des cartes. L'exemple ci-dessus montre un seul repère simple sans personnalisation appliquée.

Personnaliser la couleur, la taille et l'image de l'icône

Personnalisez la couleur de l'arrière-plan, du glyphe, de la bordure et de la taille du repère par défaut.

Repères personnalisés

Essayer l'exemple

Remplacez l'icône du repère par défaut par une ressource SVG personnalisée.

Repères avec des graphiques

Essayer l'exemple

Définir l'altitude du repère

Vous pouvez définir l'altitude du repère en l'extrudant et en définissant l'altitude.

Repère extrudé

Essayer l'exemple

Contrôler le comportement en cas de collision

Le comportement en cas de collision détermine comment un repère s'affiche s'il entre en collision avec un autre repère (s'ils se chevauchent).

Pour définir le comportement en cas de collision, définissez collisionBehavior sur l'une des valeurs suivantes:

  • REQUIRED: le repère s'affiche toujours, quelle que soit la collision.
  • REQUIRED_AND_HIDES_OPTIONAL: le repère s'affiche toujours peu importe le cas de collision. Les repères ou libellés OPTIONAL_AND_HIDES_LOWER_PRIORITY qui chevauchent le repère sont masqués.
  • OPTIONAL_AND_HIDES_LOWER_PRIORITY: le repère s'affiche uniquement s'il n'en chevauche pas d'autres. Si deux repères de ce type se chevauchent, celui avec le zIndex le plus élevé est affiché. S'ils ont le même zIndex, celui dont la position verticale à l'écran est la plus basse est affiché.