Comprendre et utiliser les modes d'altitude

AltitudeMode est la propriété qui définit le positionnement vertical d'un élément de carte. Elle détermine si un objet est affiché par rapport au terrain, par rapport à des éléments au-dessus du sol (comme des bâtiments) ou à une hauteur absolue au-dessus du niveau de la mer.

AltitudeMode est la propriété qui détermine où les éléments que vous ajoutez à la carte 3D, tels que les repères, les polylignes, les polygones et les modèles, sont affichés par rapport à la surface de la Terre. De plus, AltitudeMode contrôle l'emplacement de la caméra lors des animations flyTo et flyAround.

Le guide suivant fournit des informations sur l'utilisation efficace d'AltitudeMode et sur les facteurs qui ont un impact sur l'affichage des éléments.

Modèles numériques d'élévation

Le placement des éléments est régi par deux modèles numériques d'élévation (MNE) sous-jacents accessibles dans l'API :

  • Modèle numérique de terrain (MNT) / "Ground" : vue "terre nue" montrant l'altitude du terrain sous-jacent, sans les objets au-dessus du sol.
  • Modèle numérique de surface (MNS) / "Mesh" : représentation de la surface qui inclut l'élévation du terrain, ainsi que des éléments au-dessus du sol, tels que les bâtiments et les arbres.

L'image suivante montre la différence entre les rendus MNT et MNS d'une zone urbaine :

Image montrant les vues côte à côte du MNT et du MNS de la tour Eiffel et de Paris

Options AltitudeMode

Le choix d'AltitudeMode détermine comment la valeur d'altitude de l'élément (si elle est fournie) est interprétée par rapport aux modèles numériques d'élévation.

  • ABSOLUTE : affiche l'objet par rapport au niveau moyen de la mer, calculé à l'aide d' EGM96.
  • CLAMP_TO_GROUND: affiche l'objet directement sur le MNT (Ground), en ignorant toute altitude fournie et en suivant le terrain.
  • RELATIVE_TO_GROUND: affiche l'objet par rapport à la surface du MNT (Ground).
  • RELATIVE_TO_MESH: affiche l'objet par rapport au MNS (Mesh), la surface la plus élevée, y compris le sol, les bâtiments et l'eau.

L'exemple suivant vous permet de modifier l'AltitudeMode d'une polyligne pour observer l'impact des différents modes sur l'affichage de la polyligne sur une géométrie complexe dans un environnement semi-urbain :

Valeurs d'altitude dans les modes relatifs

Lorsque vous utilisez des modes relatifs (RELATIVE_TO_GROUND ou RELATIVE_TO_MESH), la valeur d'altitude fournie est un décalage par rapport à la surface de base choisie, et non une hauteur fixe au-dessus du niveau de la mer. Par exemple, une altitude de 100 placera l'élément 100 mètres au-dessus du MNT ou du MNS.

Si les données de l'élément n'incluent pas d'altitude, un mode relatif tel que RELATIVE_TO_MESH placera l'élément directement au-dessus du maillage/de la surface. Toutefois, pour les polylignes et les polygones, les connexions entre les points seront des lignes droites, ce qui peut entraîner le passage de la ligne à travers le maillage entre les points si vous n'utilisez pas d'interpolation.

Étapes suivantes

  • Consultez la section du Centre d'architecture topic pour obtenir une présentation plus détaillée de AltitudeMode, y compris des informations sur AltitudeMode et les repères.