Comprendre et utiliser les modes d'altitude

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

AltitudeMode est la propriété qui détermine l'emplacement des éléments que vous ajoutez à la carte 3D (repères, polylignes, polygones et modèles, par exemple) par rapport à la surface de la Terre.

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

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

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

  • Modèle numérique de terrain (MNT) / "Sol" : vue "sans végétation" montrant l'élévation du terrain sous-jacent, sans les objets au-dessus du sol.
  • Modèle numérique de surface (MNS) / "maillage" : représentation de surface qui inclut l'élévation du terrain ainsi que les éléments au-dessus du sol, comme les bâtiments et les arbres.

L'image suivante montre la différence entre le rendu du MNT et du MSD 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 de AltitudeMode détermine la façon dont la valeur d'altitude de la fonctionnalité (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 de EGM96.
  • CLAMP_TO_GROUND : affiche l'objet directement sur le MNT (sol), en ignorant toute altitude fournie et en suivant le terrain.
  • RELATIVE_TO_GROUND : affiche l'objet par rapport à la surface du MNT (sol).
  • RELATIVE_TO_MESH : affiche l'objet par rapport au MNS (maillage), c'est-à-dire la surface la plus élevée, y compris le sol, les bâtiments et l'eau.

L'exemple suivant vous permet de modifier le AltitudeMode d'une polyligne pour observer l'impact des différents modes sur le rendu 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'entité n'incluent pas d'altitude, un mode relatif tel que RELATIVE_TO_MESH placera l'entité 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 l'interpolation.

Étapes suivantes

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