De nombreux éléments géographiques KML peuvent contenir un élément ou des coordonnées <altitude>, qui spécifie une distance au-dessus du niveau du sol, du niveau de la mer ou du fond marin pour cet élément géographique particulier. Les éléments <AbstractView> peuvent également contenir l'altitude.
Toute valeur d'altitude doit être accompagnée d'un élément <altitudeMode> qui indique à Google Earth comment lire la valeur d'altitude. Les altitudes peuvent être mesurées:
- de la surface de la Terre (
relativeToGround), - au-dessus du niveau de la mer (
absolute), ou - au niveau des plans d'eau majeurs (
relativeToSeaFloor).
Vous pouvez également l'ignorer (clampToGround et clampToSeaFloor).
Modes d'altitude SeaFloor et espace de noms de l'extension KML
Les modes d'altitude liés au fond marin sont contenus dans un ensemble d'extensions de la norme KML, à l'aide du préfixe gx. Pour les utiliser, vous devez d'abord ajouter l'URI d'espace de noms approprié à l'élément d'ouverture <kml> dans votre fichier KML:
<kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2">
Remplacez <altitudeMode> par <gx:altitudeMode> lorsque vous utilisez clampToSeaFloor ou relativeToSeaFloor.
Notez que l'espace de noms de l'extension avec préfixe gx peut ne pas être compatible avec tous les navigateurs géographiques. Google Earth 5.0 est compatible.
Référence du mode Altitude
Absolu
Le mode d'altitude absolu mesure l'altitude par rapport au niveau de la mer, quelle que soit l'altitude réelle du relief sous l'élément géographique. De cette manière, les éléments géographiques peuvent être placés sous terre et ne seront pas visibles. Certaines parties d'un élément géographique peuvent être souterraines, comme dans l'exemple ci-dessous. Les valeurs négatives sont acceptées pour placer des éléments géographiques sous le niveau de la mer.
Ce mode est utile lorsque la valeur de l'altitude est connue avec précision. Les parcours GPS, par exemple, peuvent utiliser le mode "altitude absolue" pour afficher les tracés créés lors des vols ou de la plongée.
Exemple
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<GroundOverlay>
<name>absolute Example</name>
<Icon>
<href>rectangle.jpg</href>
<viewBoundScale>0.75</viewBoundScale>
</Icon>
<altitude>2744.0</altitude>
<altitudeMode>absolute</altitudeMode>
<LatLonBox>
<north>48.783</north>
<south>48.751</south>
<east>-121.75</east>
<west>-121.89</west>
<rotation>-30</rotation>
</LatLonBox>
</GroundOverlay>
</kml>
clampToGround
Ce mode ignore les valeurs d'altitude et place l'élément KML à la surface du sol, après le relief. De cette manière, les superpositions au sol peuvent, par exemple, être "drapées" sur la surface de la Terre. Si l'élément géographique est placé sur une étendue majeure d'eau, clampToGround le place au niveau de la mer.
Tout élément KML pour lequel aucun mode d'altitude n'est spécifié est défini par défaut sur "clampToGround".
Exemple
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"> <GroundOverlay> <name>clampToGround example</name> <Icon> <href>rectangle.jpg</href> <viewBoundScale>0.75</viewBoundScale> </Icon> <altitude>2744.0</altitude> <altitudeMode>clampToGround</altitudeMode> <LatLonBox> <north>48.783</north> <south>48.751</south> <east>-121.75</east> <west>-121.89</west> <rotation>-30</rotation> </LatLonBox> </GroundOverlay> </kml>
clampToSeaFloor
Il se trouve dans l'espace de noms de l'extension. Pour en savoir plus, consultez Modes d'altitude du SeaFloor et espace de noms de l'extension KML.
Comme pour clampToGround, ce mode ignore la valeur d'altitude. Il est placé à la base d'une étendue d'eau majeure. S'il est situé à l'écart d'une étendue d'eau, il est fixé au niveau du sol.
Exemple
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2"> <!-- required when using gx-prefixed elements -->
<Placemark>
<name>clampToSeaFloor example</name>
<Polygon>
<tessellate>1</tessellate>
<gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
<outerBoundaryIs>
<LinearRing>
<coordinates>
146.793,12.213,0
146.803,12.202,0
146.829,12.218,0
146.807,12.226,0
146.793,12.213,0
</coordinates>
</LinearRing>
</outerBoundaryIs>
</Polygon>
</Placemark>
</kml>
relativeToGround
Mesure l'altitude par rapport au niveau du sol, directement sous les coordonnées.
Par exemple, ce mode d'altitude permet de placer les sommets des mâts de la ligne électrique lorsqu'ils montent ou descendent une colline. Si chaque pôle mesure 20 m de haut, l'emplacement de sa partie supérieure se déplace vers le haut et vers le bas en fonction de l'élévation de la Terre.
Exemple
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"> <Placemark> <name>relativeToGround Example</name> <LineString> <extrude>1</extrude> <altitudeMode>relativeToGround</altitudeMode> <coordinates> -121.835,48.754,700 -121.828,48.764,700 -121.818,48.776,700 -121.794,48.787,700 -121.778,48.781,700 -121.766,48.771,700 -121.768,48.757,700 -121.773,48.747,700 </coordinates> </LineString> </Placemark> </kml>
relativeToSeaFloor
Il se trouve dans l'espace de noms de l'extension. Pour en savoir plus, consultez Modes d'altitude du SeaFloor et espace de noms de l'extension KML.
Mesure l'altitude par rapport au fond marin juste en dessous de l'élément géographique, si celui-ci est placé sur une étendue d'eau majeure. Si elle n'est pas sur l'eau, l'altitude sera mesurée à partir du sol.
Exemple
<?xml version="1.0" encoding="UTF-8"?> <kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2"> <!-- required when using gx-prefixed elements -->
<Placemark>
<name>relativeToSeaFloor Example</name>
<LineString>
<extrude>1</extrude>
<gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
<coordinates>
146.825,12.233,400
146.820,12.222,400
146.812,12.212,400
146.796,12.209,400
146.788,12.205,400
</coordinates>
</LineString>
</Placemark>
</kml>