AltitudeMode ist die Eigenschaft, mit der die vertikale Platzierung eines Kartenelements definiert wird.
Sie bestimmt, ob ein Objekt relativ zum Gelände, relativ zu oberirdischen Elementen (z. B. Gebäuden) oder in einer absoluten Höhe über dem Meeresspiegel gerendert wird.
AltitudeMode ist die Eigenschaft, mit der festgelegt wird, wo Elemente, die Sie der 3D-Karte hinzufügen, z. B. Markierungen, Polylinien, Polygone und Modelle, relativ zur Erdoberfläche gerendert werden. Außerdem steuert AltitudeMode, wo sich die Kamera bei flyCameraTo- und flyCameraAround-Animationen befindet.
AltitudeMode
In der folgenden Anleitung finden Sie Informationen zur effektiven Verwendung von AltitudeMode und zu Faktoren, die sich auf die Darstellung von Elementen auswirken.
Digitale Höhenmodelle
Die Platzierung von Features wird durch zwei zugrunde liegende digitale Höhenmodelle (Digital Elevation Models, DEMs) bestimmt, auf die in der API zugegriffen werden kann:
- Digitales Geländemodell (Digital Terrain Model, DTM) / „Ground“: Eine Ansicht der Erdoberfläche, die die Höhe des zugrunde liegenden Geländes zeigt, wobei oberirdische Objekte entfernt wurden.
- Digitales Oberflächenmodell (Digital Surface Model, DSM) / „Mesh“: Eine Darstellung der Oberfläche, die die Geländeerhebung sowie oberirdische Elemente wie Gebäude und Bäume umfasst.
Das folgende Bild zeigt den Unterschied zwischen den DTM- und DSM-Renderings eines städtischen Gebiets:

AltitudeMode-Optionen
Die Wahl von AltitudeMode bestimmt, wie der Höhenwert des Features (falls angegeben) relativ zu den digitalen Höhenmodellen interpretiert wird.
ABSOLUTE: Rendert das Objekt relativ zum mittleren Meeresspiegel, berechnet mit EGM96.CLAMP_TO_GROUND: Rendert das Objekt direkt auf dem DTM (Ground), wobei die angegebene Höhe ignoriert und dem Gelände gefolgt wird.RELATIVE_TO_GROUND: Rendert das Objekt relativ zur DTM-Oberfläche (Ground).RELATIVE_TO_MESH: Rendert das Objekt relativ zum DSM (Mesh), der höchsten Oberfläche, einschließlich Boden, Gebäuden und Wasser.
Höhenwerte in relativen Modi
Bei Verwendung relativer Modi (RELATIVE_TO_GROUND oder RELATIVE_TO_MESH) ist der angegebene Höhenwert ein Offset von der ausgewählten Basisoberfläche und keine feste Höhe über dem Meeresspiegel. Bei einer Höhe von 100 wird das Feature beispielsweise 100 Meter über dem DTM oder DSM platziert.
Wenn die Feature-Daten keine Höhe enthalten, wird das Feature in einem relativen Modus wie RELATIVE_TO_MESH direkt auf dem Mesh/der Oberfläche platziert.
Bei Polylinien und Polygonen sind die Verbindungen zwischen den Punkten jedoch gerade Linien, was dazu führen kann, dass die Linie zwischen den Punkten durch das Mesh verläuft, wenn Sie keine Interpolation verwenden.