Mode Ketinggian

Banyak fitur KML dapat berisi elemen atau koordinat <altitude>, yang menentukan jarak di atas permukaan tanah, permukaan laut, atau dasar laut untuk fitur tertentu tersebut. Elemen <AbstractView> juga dapat berisi ketinggian.

Setiap nilai ketinggian harus disertai dengan elemen <altitudeMode>, yang memberi tahu Google Earth cara membaca nilai ketinggian. Ketinggian dapat diukur:

  • dari permukaan bumi (relativeToGround),
  • di atas permukaan laut (absolute), atau
  • dari bagian bawah perairan utama (relativeToSeaFloor).

Hal ini juga dapat diabaikan (clampToGround dan clampToSeaFloor)

Mode ketinggian laut dan namespace ekstensi KML

Mode ketinggian terkait laut dasar terdapat dalam kumpulan ekstensi ke standar KML, menggunakan awalan gx. Untuk menggunakannya, Anda harus menambahkan URI namespace yang benar terlebih dahulu ke elemen <kml> pembuka di file KML Anda:

<kml xmlns="http://www.opengis.net/kml/2.2"
     xmlns:gx="http://www.google.com/kml/ext/2.2">

Lalu, ganti <gx:altitudeMode> dengan <altitudeMode> saat menggunakan clampToSeaFloor atau relativeToSeaFloor.

Perlu diketahui bahwa namespace ekstensi berawalan gx mungkin tidak didukung oleh semua browser geografis. Fitur ini didukung oleh Google Earth 5.0.

Referensi mode ketinggian

mutlak

Mode ketinggian mutlak mengukur ketinggian relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah fitur. Dengan cara ini, fitur dapat ditempatkan di bawah tanah, dan tidak akan terlihat. Sebagian fitur dapat diperluas ke bawah tanah, seperti dalam contoh di bawah. Nilai negatif diterima untuk menempatkan fitur di bawah permukaan laut.

Mode ketinggian ini berguna dalam situasi saat nilai ketinggian diketahui dengan tepat. Lacak GPS, misalnya, dapat menggunakan mode ketinggian absolut untuk menampilkan jalur yang dibuat saat terbang atau menyelam.

Contoh

<?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>

PenjepitToGround

Mode ini mengabaikan nilai ketinggian apa pun, dan menempatkan fitur KML di permukaan tanah, mengikuti medan. Dengan cara ini, GroundOverlays dapat, misalnya, 'terbungkus' di atas permukaan bumi. Jika fitur diposisikan di atas perairan utama, clampToGround akan menempatkan fitur tersebut di permukaan laut.

Semua fitur KML yang tidak menetapkan mode ketinggian akan ditetapkan secara default ke clampToGround.

Contoh

<?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>

penjepitToSeaFloor

Berisi dalam namespace ekstensi. Lihat Mode ketinggian laut dan namespace ekstensi KML untuk mengetahui informasi penting.

Seperti clampToGround, mode ini mengabaikan nilai ketinggian. Fitur ini menempatkan fitur tersebut di dasar perairan utama; jika fitur tersebut terletak di luar perairan, fitur ini akan dikunci ke permukaan tanah.

Contoh

<?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>

ToToround

Mengukur ketinggian dari permukaan tanah langsung di bawah koordinat.

Sebagai contoh, mode ketinggian ini dapat digunakan untuk menempatkan bagian atas tiang listrik saat mereka mendaki dan melewati bukit. Jika setiap tiang setinggi 20 m, lokasi setiap puncak tiang akan bergerak ke atas dan ke bawah dengan ketinggian Bumi.

Contoh

<?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>

LantaiToSeaFloor

Berisi dalam namespace ekstensi. Lihat Mode ketinggian laut dan namespace ekstensi KML untuk mengetahui informasi penting.

Mengukur ketinggian dari dasar laut langsung di bawah fitur, jika fitur ditempatkan di atas perairan utama. Jika tidak di atas air, ketinggian akan diukur dari permukaan tanah.

Contoh

<?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>