Halaman ini diterjemahkan oleh Cloud Translation API.

Referensi KML

Bagian ini berisi referensi alfabet untuk semua elemen KML yang ditentukan di KML Versi 2.2, serta elemen di namespace ekstensi Google. Hierarki class untuk elemen KML ditampilkan di bawah. Dalam diagram ini, elemen di sebelah kanan pada cabang tertentu di hierarki adalah ekstensi elemen di sebelah kirinya. Misalnya, Penanda Letak adalah jenis Fitur khusus. Ini berisi semua elemen yang termasuk dalam Fitur, dan menambahkan beberapa elemen khusus untuk elemen Penanda Letak.

KML adalah standar terbuka yang secara resmi bernama OpenGIS® KML Encoding Standard (OGC KML). Dikelola oleh Open Geospatial Consortium, Inc. (OGC). Spesifikasi lengkap untuk KML OGC dapat ditemukan di http://www.opengeospatial.org/standards/kml/.

Skema XML lengkap untuk KML dapat ditemukan di http://schemas.opengis.net/kml/.

Catatan: Klik nama elemen dalam diagram ini untuk melompat ke entrinya di bagian referensi.

Perhatikan bahwa elemen abstrak (ditampilkan dalam kotak di diagram) sebenarnya tidak digunakan di file KML. Keduanya merupakan cara yang berguna agar satu elemen berfungsi sebagai dasar terprogram untuk beberapa elemen turunan yang serupa (tetapi berbeda). Memahami hierarki berorientasi objek ini juga merupakan cara yang baik bagi Anda untuk mempelajari KML, karena Anda dapat dengan mudah melihat pengelompokan elemen terkait.

Semua elemen yang berasal dari Object dapat memiliki id yang ditetapkan ke elemen tersebut. id ini digunakan oleh mekanisme pembaruan KML (lihat <Update>) untuk file yang dimuat dengan NetworkLink. ID ini juga digunakan oleh gaya bersama (lihat <Style>). id adalah ID XML standar.

Karena KML adalah tata bahasa XML dan format file, nama tag peka huruf besar/kecil dan harus muncul persis seperti yang ditampilkan di sini. Jika Anda terbiasa dengan XML, Anda juga akan tertarik dengan Skema KML 2.2. Saat mengedit file teks KML, Anda dapat memuat Skema ini ke editor XML apa pun dan memvalidasi kode KML Anda dengannya.

Tips: Melihat KML untuk Fitur Google Earth

Berikut adalah fitur berguna Google Earth yang memudahkan pengguna melihat file KML untuk Fitur apa pun. Di Google Earth, Anda dapat mengklik kanan Fitur di panel Tempat dan menyalinnya. Untuk melihat KML yang sesuai untuk objek yang disalin, buka editor teks favorit Anda dan tempelkan pilihan ke dalamnya.

Kompatibilitas

Versi KML memiliki sistem penomoran ganda: majorVersion.minorVersion. Semua versi dengan majorVersion yang sama kompatibel. Oleh karena itu, jika Anda mengubah namespace menjadi "2.2" (yaitu xmlns="http://www.opengis.net/kml/2.2"), semua file KML 2.1 akan divalidasi dalam skema KML 2.2.

Tentang referensi ini

Setiap entri referensi menyertakan bagian Sintaksis yang mencantumkan elemen yang terdapat dalam elemen utama. Bagian Sintaksis ini adalah listingan informal dan menggunakan singkatan sederhana untuk meringkas elemen. Bagian ini juga berisi hal berikut:

nilai default untuk setiap elemen (atau elips jika merupakan elemen kompleks atau jika tidak ada nilai default)
jenis nilai (lihat Kolom KML)

Bagian Sintaksis dapat disalin dan digunakan sebagai template untuk elemen non-abstrak di file KML.

Namespace Ekstensi KML dan awalan gx

Standar KML OGC menyediakan mekanisme untuk ekstensi - elemen tambahan yang berisi informasi selain yang tersedia dalam standar (pelajari lebih lanjut namespace XML di w3.org). Dengan diluncurkannya Google Earth 5.0, Google telah menyediakan ekstensi untuk KML guna mendukung sejumlah fitur baru. Ekstensi ini menggunakan awalan gx dan URI namespace berikut:

xmlns:gx="http://www.google.com/kml/ext/2.2"

URI namespace ini harus ditambahkan ke elemen <kml> di file KML apa pun menggunakan elemen berawalan gx-:

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

Ekstensi untuk KML mungkin tidak didukung di semua browser geografis. Jika browser Anda tidak mendukung ekstensi tertentu, data dalam ekstensi tersebut harus diabaikan secara diam-diam, dan file KML lainnya akan dimuat tanpa error.

Elemen yang saat ini menggunakan awalan gx adalah:

gx:heightMode
gx:heightOffset
gx:sudut
gx:PembaruanPembaruan
gx:balloonVisibility
gx:coord
gx:delayedStart
gx:drawOrder
gx:durasi
gx:FlyTo
gx:flyToMode
gx:j
gx:horizFov
gx:interpolate
gx:labelVisibilitas
gx:LatLonQuad
gx:MultiTrack
Opsi gx:viewer
gx:WarnaLuar
gx:OuterWidth
gx:physicalWidth
gx:Playlist
gx:playMode
gx:SuaraCue
gx:Rentang Waktu
gx:Stempel Waktu
gx:Tur
gx:TourControl
gx:TourPrimitive
gx:Pelacakan
gx:ViewerOptions
gx:w
gx:Tunggu
gx.x
gx:y

Skema XML lengkap untuk elemen dalam namespace ekstensi ini berada di http://developers.google.com/kml/schema/kml22gx.xsd.

Kolom KML

KML menggunakan jenis XML umum seperti boolean, string, double, float, dan int. Selain itu, KML menentukan sejumlah jenis elemen kolom. Tabel berikut mencantumkan beberapa jenis yang paling sering digunakan dalam KML dan link ke elemen contoh yang menggunakannya:

Jenis Kolom	Nilai	Contoh Penggunaan
heightModeEnum	clampToGround, relatifToGround, absolut	Lihat <LookAt> dan <Region>
sudut90	nilai ≥ {/6}90 dan ≤90	Lihat <latitude> di <Model>
anglepos90	nilai ≥0 dan ≤90	Lihat <tilt> di <LookAt>
sudut180	nilai ≥ {/6}180 dan ≤180	Lihat <bujur> dalam <Model>
sudut360	nilai ≥‐360 dan ≤360	Lihat <heading> di <Orientation>
warna	Nilai hexBinary: aabbggrr	Lihat elemen apa pun yang memperluas <ColorStyle>
colorModeEnum	normal, acak	Lihat elemen apa pun yang memperluas <ColorStyle>
tanggalwaktu	dateTime, date, gYearMonth, gYear	Lihat <TimeSpan> dan <TimeStamp>
displayModeEnum	default, sembunyikan	Lihat <BalloonStyle>
gridOrigin	Kiri bawah, kiri atas	Lihat <PhotoOverlay>
muat ulangModeEnum	onChange, onInterval, onExpire	Lihat <Link>
bentukEnum	persegi panjang, silinder, bola	Lihat <PhotoOverlay>
gayaStatusEnum	normal, sorot	Lihat <StyleMap>
unitEnum	pecahan, piksel, insetPixel	Lihat <hotSpot> di <IconStyle>, <ScreenOverlay>
vec2	x=double xunits=kml:unitsEnum y=double yunits=kml:unitsEnum	Lihat <hotSpot> di <IconStyle>, <ScreenOverlay>
viewRefreshEnum	Never, onRequest, onStop, onRegion	Lihat <Link>

<AbstractView>

Sintaksis

<!-- abstract element; do not create -->
<!-- AbstractView -->                       <!-- Camera, LookAt -->
  <!-- extends Object -->
  <TimePrimitive>...</TimePrimitive>        <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <gx:option name="" enabled=boolean />   <!-- name="streetview",
                                                      "historicalimagery",
                                                   or "sunlight" -->
  </gx:ViewerOptions>
<-- /AbstractView -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Elemen ini diperluas dengan elemen <Camera> dan <LookAt>.

Memperluas

<Objek>

Elemen Khusus untuk AbstractView

<gx:ViewerOptions>: Elemen ini memungkinkan mode tampilan khusus di Google Earth 6.0 dan yang lebih baru. Class ini memiliki satu atau beberapa elemen turunan <gx:option>. Elemen <gx:option> memiliki atribut name dan atribut enabled. name menentukan salah satu dari yang berikut: gambar Street View ("streetview"), citra historis ("historis citra"), dan efek sinar matahari untuk waktu tertentu ("sinar matahari"). Atribut enabled digunakan untuk mengaktifkan atau menonaktifkan mode tampilan tertentu.
<gx:horizFov>: Menentukan ruang pandang horizontal AbstractView selama tur. Elemen ini tidak memengaruhi AbstractView di luar tur. <gx:horizFov> disisipkan secara otomatis oleh klien Google Earth (versi 6.1+) selama perekaman tur. AbstractView reguler diberi nilai 60; tampilan dalam Street View diberi nilai 85 agar sesuai dengan bidang tampilan Street View standar di Google Earth. Setelah ditetapkan, nilai akan diterapkan ke tampilan berikutnya, hingga nilai baru ditentukan.

<gx:ElevationMode>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:altitudeMode>clampToGround</gx:altitudeMode>
  <!-- gx:altitudeModeEnum: relativeToSeaFloor, clampToSeaFloor, relativeToGround, clampToGround, absolute -->

Deskripsi

Dapat digunakan sebagai ganti elemen <altitudeMode> standar KML OGC, dan menerima nilai berikut selain nilai ElevationMode standar:

relativeToSeaFloor - Menafsirkan ketinggian sebagai nilai dalam meter di atas dasar laut. Jika fitur KML berada di atas daratan dan bukan laut, ketinggian akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi ketinggian akan diabaikan dan fitur KML akan diposisikan di dasar laut. Jika fitur KML berada di darat, bukan di laut, clampToSeaFloor akan dibulatkan ke tanah.

Seperti halnya <altitudeMode>, <gx:altitudeMode> memengaruhi:

koordinat ketinggian dalam elemen <coordinates>
<minAltitude> dan <maxAltitude> dalam <LatLonAltBox>
<altitude> dalam <Location>, <GroundOverlay>, dan AbstractView (<LookAt> dan <Camera>).

Informasi selengkapnya tentang mode ketinggian tersedia dalam bab Mode Ketinggian dalam Panduan Developer KML.

Contoh

heightmode_reference.kml

<?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>gx:altitudeMode Example</name>
  <LookAt>
    <longitude>146.806</longitude>
    <latitude>12.219</latitude>
    <heading>-60</heading>
    <tilt>70</tilt>
    <range>6300</range>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
  </LookAt>
  <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>

<gx:PembaruanPembaruan>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:AnimatedUpdate id="ID">
  <gx:duration>0.0</gx:duration>     <!-- double, specifies time in seconds -->
  <Update>
    <targetHref>...</targetHref>     <!-- required; can contain a URL or be left blank -->
                                      <!-- (to target elements within the same file) -->
    <Change>...</Change>
    <Create>...</Create>
    <Delete>...</Delete>
  </Update>
  <gx:delayedStart>0</gx:delayedStart>  <!-- double, specifies time in seconds -->
</gx:AnimatedUpdate>

Deskripsi

<gx:AnimatedUpdate> mengontrol perubahan selama tur ke fitur KML, menggunakan <Update>. Perubahan pada fitur KML tidak akan mengubah DOM - yaitu, setiap perubahan akan dikembalikan saat tur berakhir, dan tidak akan disimpan dalam KML kapan saja.

<gx:AnimatedUpdate> juga harus berisi nilai <gx:duration> untuk menentukan durasi waktu dalam detik saat update berlangsung. Kolom bilangan bulat, float, dan warna dianimasikan dengan lancar dari nilai asli ke nilai baru di seluruh durasi; boolean, string, dan nilai lain yang tidak digunakan untuk interpolasi diperbarui pada akhir durasi.

Lihat Linimasa tur di bab Tur pada Panduan Developer KML untuk mengetahui informasi tentang <gx:AnimatedUpdate> dan linimasa tur.

<gx:durasi>: Menentukan durasi waktu, dalam detik, saat update dilakukan.
<gx:delayedStart>: Menentukan jumlah detik untuk menunggu (setelah posisi awal inline) sebelum memulai update.

Contoh

Contoh di bawah ini menunjukkan perubahan ukuran ikon. Perubahan ini akan dianimasikan selama durasi 5 detik.

animasiupdate_example.kml

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

<Document>
  <name>gx:AnimatedUpdate example</name>

  <Style id="pushpin">
    <IconStyle id="mystyle">
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href>
        <scale>1.0</scale>
      </Icon>
    </IconStyle>
  </Style>

  <Placemark id="mountainpin1">
    <name>Pin on a mountaintop</name>
    <styleUrl>#pushpin</styleUrl>
    <Point>
      <coordinates>170.1435558771009,-43.60505741890396,0</coordinates>
    </Point>
  </Placemark>

  <gx:Tour>
    <name>Play me!</name>

    <gx:Playlist>

      <gx:FlyTo>
        <gx:flyToMode>bounce</gx:flyToMode>
        <gx:duration>3</gx:duration>
        <Camera>
          <longitude>170.157</longitude>
          <latitude>-43.671</latitude>
          <altitude>9700</altitude>
          <heading>-6.333</heading>
          <tilt>33.5</tilt>
        </Camera>
      </gx:FlyTo>

      <gx:AnimatedUpdate>
        <gx:duration>5</gx:duration>
        <Update>
          <targetHref></targetHref>
          <Change>
            <IconStyle targetId="mystyle">
              <scale>10.0</scale>
            </IconStyle>
          </Change>
        </Update>
      </gx:AnimatedUpdate>

      <gx:Wait>
        <gx:duration>5</gx:duration>
      </gx:Wait>

    </gx:Playlist>
  </gx:Tour>

</Document>
</kml>

Memperluas

<gx:TourPrimitive>

Berisi

<gx:durasi>
<Pembaruan>

<Gaya Balon>

Sintaksis

<BalloonStyle id="ID">
  <!-- specific to BalloonStyle -->
  <bgColor>ffffffff</bgColor>            <!-- kml:color -->
  <textColor>ff000000</textColor>        <!-- kml:color -->
  <text>...</text>                       <!-- string -->
  <displayMode>default</displayMode>     <!-- kml:displayModeEnum -->
</BalloonStyle>

Deskripsi

Menentukan cara balon deskripsi untuk penanda letak. <bgColor>, jika ditentukan, digunakan sebagai warna latar belakang balon. Lihat <Fitur> untuk diagram yang menggambarkan tampilan balon deskripsi default di Google Earth.

Elemen Khusus untuk BalloonStyle

<bgColor>: Warna latar belakang balon (opsional). Nilai warna dan opasitas (alfa) dinyatakan dalam notasi heksadesimal. Rentang nilai untuk satu warna apa pun adalah 0 hingga 255 (00 hingga ff). Urutan ekspresi adalah aabbggrr, dengan aa=alpha (00 hingga ff); bb=blue (00 hingga ff); gg=green (00 hingga ff); rr=red (00 hingga ff). Untuk alfa, 00 sepenuhnya transparan dan ff sepenuhnya buram. Misalnya, jika ingin menerapkan warna biru dengan opasitas 50 persen ke overlay, Anda akan menentukan hal berikut: <bgColor>7fff0000</bgColor>, dengan alpha=0x7f, blue=0xff, green=0x00, dan red=0x00. Defaultnya adalah putih buram (ffffffff).
<textColor>: Warna latar depan untuk teks. Defaultnya adalah hitam (ff000000).
<text>: Teks yang ditampilkan dalam balon. Jika tidak ada teks yang ditentukan, Google Earth menggambar balon default (dengan Fitur <nama> dicetak tebal, Fitur <deskripsi>, link untuk rute mobil, latar belakang putih, dan ekor yang dilampirkan ke koordinat titik Fitur, jika ditentukan).; Anda dapat menambahkan entitas ke tag <text> menggunakan format berikut untuk merujuk ke elemen turunan Fitur: $[name], $[description], $[address], $[id], $[Cuplikan]. Google Earth mencari Fitur string yang sesuai di entitas saat ini, dan mengganti informasi tersebut dalam balon. Untuk menyertakan rute Buka di sini - Dari sini, gunakan tag $[geDirections] dari balon. Agar link rute mobil tidak muncul dalam balon, sertakan elemen <text> dengan konten tertentu, atau dengan $[description] untuk mengganti Fitur dasar <description>.; Misalnya, dalam kutipan KML berikut, kolom $[name] dan $[description] akan diganti dengan kolom <name> dan <description> yang ditemukan di elemen Fitur yang menggunakan BalloonStyle ini
<displayMode>: Jika <displayMode> default, Google Earth akan menggunakan informasi yang diberikan dalam <text> untuk membuat balon . Jika <displayMode> sembunyikan, Google Earth tidak akan menampilkan balon. Di Google Earth, mengklik ikon Tampilan Daftar untuk Penanda Letak yang <displayMode> balonnya sembunyikan akan menyebabkan Google Earth terbang ke Penanda Letak.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>BalloonStyle.kml</name>
  <open>1</open>
  <Style id="exampleBalloonStyle">
    <BalloonStyle>
      <!-- a background color for the balloon -->
      <bgColor>ffffffbb</bgColor>
      <!-- styling of the balloon text -->
      <text><![CDATA[
      <b><font color="#CC0000" size="+3">$[name]</font></b>
      <br/><br/>
      <font face="Courier">$[description]</font>
      <br/><br/>
      Extra text that will appear in the description balloon
      <br/><br/>
      <!-- insert the to/from hyperlinks -->
      $[geDirections]
      ]]></text>
    </BalloonStyle>
  </Style>
  <Placemark>
    <name>BalloonStyle</name>
    <description>An example of BalloonStyle</description>
    <styleUrl>#exampleBalloonStyle</styleUrl>
    <Point>
      <coordinates>-122.370533,37.823842,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Memperluas

<WarnaGaya>

Dimuat Oleh

<Gaya>

Kembali ke atas

<gx:balloonVisibility>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:balloonVisibility>0</gx:balloonVisibility>    <!-- 0 (not visible) or 1 (visible) -->

Deskripsi

Mengalihkan visibilitas balon deskripsi. Balon yang akan diperbarui harus diidentifikasi dengan ID XML objek (misalnya <Placemark targetId="xxx">).

Contoh

Contoh pertama menunjukkan <gx:balloonVisibility> dengan Penanda Letak. Saat penanda letak dimuat, balon deskripsi akan terbuka.
balloonVisibility_example.kml

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

  <Placemark>
    <name>Eiffel Tower</name>
    <description>
        Located in Paris, France. 
        
        This description balloon opens 
        when the Placemark is loaded.
    </description>
    <gx:balloonVisibility>1</gx:balloonVisibility>
    <Point>
      <coordinates>2.294785,48.858093,0</coordinates>
    </Point>
  </Placemark>

</kml>

Contoh kedua menunjukkan penggunaan <gx:balloonVisibility> dalam tur. Sejumlah balon dibuka dan ditutup selama tur, yang memberikan informasi kepada penonton.
balloonVisibility_turexample.kml

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

  <Document>
    <name>balloonVisibility Example</name>
    <open>1</open>

    <gx:Tour>
      <name>Play me</name>
      <gx:Playlist>

        <gx:FlyTo>
          <gx:duration>8.0</gx:duration>
          <gx:flyToMode>bounce</gx:flyToMode>
          <LookAt>
            <longitude>-119.748584</longitude>
            <latitude>33.736266</latitude>
            <altitude>0</altitude>
            <heading>-9.295926</heading>
            <tilt>84.0957450</tilt>
            <range>4469.850414</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.782630</longitude>
            <latitude>33.862855</latitude>
            <altitude>0</altitude>
            <heading>-9.314858</heading>
            <tilt>84.117317</tilt>
            <range>6792.665540</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.849578</longitude>
            <latitude>33.968515</latitude>
            <altitude>0</altitude>
            <heading>-173.948935</heading>
            <tilt>23.063392</tilt>
            <range>3733.666023</range>
            <altitudeMode>relativeToGround</altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="onland">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>

    <Placemark id="underwater1">
      <name>Underwater off the California Coast</name>
      <description>
        The tour begins near the Santa Cruz Canyon,
        off the coast of California, USA.
      </description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.749531,33.715059,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="underwater2">
      <name>Still swimming...</name>
      <description>We're about to leave the ocean, and visit the coast...</description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.779550,33.829268,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="onland">
      <name>The end</name>
      <description>
        <![CDATA[The end of our simple tour.
        Use <gx:balloonVisibility>1</gx:balloonVisibility>
        to show description balloons.]]>
      </description>
      <Point>
        <coordinates>-119.849578,33.968515,0</coordinates>
      </Point>
    </Placemark>


  </Document>
</kml>

Memperluas

<Fitur>

<Kamera>

Sintaksis

<Camera id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to Camera -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos180 -->
  <roll>0</roll>                      <!-- kml:angle180 -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: relativeToGround, clampToGround, or absolute -->
        <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->
</Camera>

Deskripsi

Menentukan kamera virtual yang melihat tampilan. Elemen ini menentukan posisi kamera relatif terhadap permukaan bumi serta arah tampilan kamera. Posisi kamera ditentukan oleh <bujur>, <garis lintang>, < ketinggian>, dan <heightMode> atau <gx:heightMode>. Arah melihat kamera ditentukan oleh <heading>, <tilt>, dan <roll>. <Camera> bisa menjadi elemen turunan dari Fitur apa pun atau <NetworkLinkControl>. Elemen induk tidak dapat berisi keduanya pada satu <Network>

<Camera> memberikan kontrol enam derajat kebebasan penuh atas tampilan, sehingga Anda dapat memosisikan Kamera di ruang, lalu memutarnya di sekitar sumbu X, Y, dan Z. Yang terpenting, Anda dapat memiringkan tampilan kamera sehingga Anda melihat ke atas cakrawala ke langit.

<Camera> juga dapat berisi TimePrimitive (<gx:TimeSpan> atau <gx:TimeStamp>). Nilai waktu di Camera memengaruhi citra historis, sinar matahari, dan tampilan fitur yang diberi stempel waktu. Untuk informasi selengkapnya, baca Waktu dengan AbstractViews dalam bab Waktu dan Animasi pada Panduan Developer.

Menentukan Tampilan

Dalam Fitur atau <NetworkLinkControl>, gunakan objek <Camera> atau objek <LookAt> (tetapi tidak keduanya dalam objek yang sama). Objek <Camera> menentukan sudut pandang dalam hal posisi dan orientasi penampil. Objek <Camera> memungkinkan Anda menetapkan tampilan yang tidak berada di permukaan bumi. Objek <LookAt> mendefinisikan sudut pandang dari segi apa yang sedang dilihat. Objek <LookAt> memiliki cakupan yang lebih terbatas daripada <Camera> dan umumnya mengharuskan arah tampilan berpotongan dengan permukaan bumi.

Diagram berikut menunjukkan sumbu X, Y, dan Z, yang terpasang ke kamera virtual.

Sumbu X mengarah ke kanan kamera dan disebut vektor kanan.
Sumbu Y menentukan arah "atas" relatif ke layar dan disebut vektor naik.
Sumbu Z menunjuk dari bagian tengah layar ke titik mata. Kamera melihat ke bawah sumbu ÖZ, yang disebut vektor tampilan.

Urutan Transformasi

Urutan rotasi penting. Secara default, kamera melihat lurus ke bawah sumbu z menuju Bumi. Sebelum rotasi dilakukan, kamera diterjemahkan di sepanjang sumbu Z ke <height>. Urutan transformasi adalah sebagai berikut:

<altitude> - terjemahkan di sepanjang sumbu Z ke <height>
<heading> - putar di sekitar sumbu Z.
<tilt> - putar pada sumbu X.
<roll> - putar di sekitar sumbu Z (lagi).

Perhatikan bahwa setiap kali rotasi diterapkan, dua sumbu kamera akan mengubah orientasinya.

Elemen Khusus Kamera

<longitude>

Bujur kamera virtual (titik mata). Jarak sudut dalam derajat, relatif terhadap Prime Meridian. Nilai barat Meridian berkisar dari 180 hingga 0 derajat. Nilai timur Meridian berkisar dari 0 hingga 180 derajat.

<latitude>

Latitude kamera virtual. Derajat utara atau selatan Khatulistiwa (0 derajat). Nilainya berkisar dari 90 derajat hingga 90 derajat.

<altitude>

Jarak kamera dari permukaan bumi, dalam meter. Diinterpretasikan berdasarkan <heightMode> atau <gx:heightMode> Kamera.

<heading>

Arah (azimuth) kamera, dalam derajat. Default=0 (Utara sebenarnya). (Lihat diagram.) Nilai berkisar dari 0 hingga 360 derajat.

<tilt>

Rotasi, dalam derajat, dari kamera di sekitar sumbu X. Nilai 0 menunjukkan bahwa tampilan diarahkan lurus ke bawah menuju bumi (kasus yang paling umum). Nilai 90 untuk <tilt> menunjukkan bahwa tampilan mengarah ke arah cakrawala. Nilai yang lebih besar dari 90 menunjukkan bahwa tampilan mengarah ke langit. Nilai untuk <tilt> dikunci pada +180 derajat.

<roll>

Rotasi, dalam derajat, dari kamera di sekitar sumbu Z. Nilainya berkisar dari 180 hingga +180 derajat.

<altitudeMode>

Menentukan cara <height> yang ditentukan untuk Kamera diinterpretasikan. Nilai yang memungkinkan adalah sebagai berikut:

relativeToGround - (Default) Menafsirkan <height> sebagai nilai dalam meter di atas permukaan tanah. Jika titik tersebut berada di atas air, <height> akan ditafsirkan sebagai nilai dalam meter di atas permukaan laut. Lihat <gx:heightMode> di bawah untuk menentukan titik yang relatif terhadap dasar laut.
clampToGround - Untuk kamera, setelan ini juga menempatkan kamera RelativeToGround, karena menempatkan kamera tepat pada ketinggian medan akan berarti mata akan berpotongan dengan medan (dan tampilan akan diblokir).
absolute - Menafsirkan <height> sebagai nilai dalam meter di atas permukaan laut.

<gx:ElevationMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, <Ketinggian> akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi <height> diabaikan, dan Kamera akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, Kamera akan diposisikan di daratan.

Memperluas

<AbstractView>

Dimuat Oleh

Elemen apa pun yang berasal dari <Feature>
<NetworkLinkControl>

Kembali ke atas

<WarnaGaya>

Sintaksis

<!-- abstract element; do not create -->
<!-- ColorStyle id="ID" -->          <!-- IconStyle,LabelStyle,LineStyle,PolyStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->
<!-- /ColorStyle -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Ini menyediakan elemen untuk menentukan mode warna dan warna dari jenis gaya yang diperluas.

Elemen Khusus untuk ColorStyle

<color>: Nilai warna dan opasitas (alfa) dinyatakan dalam notasi heksadesimal. Rentang nilai untuk satu warna apa pun adalah 0 hingga 255 (00 hingga ff). Untuk alfa, 00 sepenuhnya transparan dan ff sepenuhnya buram. Urutan ekspresi adalah aabbggrr, dengan aa=alpha (00 sampai ff); bb=blue (00 sampai ff); gg=green (00 sampai ff); rr=red (00 sampai ff). Misalnya, jika ingin menerapkan warna biru dengan opasitas 50 persen ke overlay, Anda akan menentukan hal berikut: <color>7fff0000</color>, dengan alpha=0x7f, blue=0xff, green=0x00, dan red=0x00.
<colorMode>: Nilai untuk <colorMode> bersifat normal (tidak ada efek) dan acak. Nilai random menerapkan skala linear acak ke dasar <color> sebagai berikut.

Untuk memperoleh pilihan warna yang benar-benar acak, tentukan <color> dasar putih (ffffffff).
Jika Anda menentukan komponen warna tunggal (misalnya, nilai ff0000ff untuk merah), nilai warna acak untuk satu komponen tersebut (merah) akan dipilih. Dalam kasus ini, nilainya akan berkisar dari 00 (hitam) hingga ff (merah penuh).
Jika Anda menentukan nilai untuk dua atau ketiga komponen warna, skala linear acak akan diterapkan pada setiap komponen warna, dengan hasil mulai dari hitam hingga nilai maksimum yang ditentukan untuk setiap komponen.
Opasitas warna berasal dari komponen alfa <color> dan tidak pernah diacak.

Memperluas

<Objek>

Diperluas Oleh

<IconStyle>
<LabelStyle>
<BarisStyle>
<PolyStyle>

Kembali ke atas

<Penampung>

Sintaksis

<!-- abstract element; do not create -->
<!-- Container id="ID" -->              <!-- Document,Folder -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <address>...</address>                <!-- string -->
  <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">...
      </AddressDetails>                 <!-- string -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- LookAt or Camera -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>
  <atom:author>...<atom:author>   <!-- xmlns:atom="http://www.w3.org/2005/Atom" -->
  <atom:link href=" "/>

  <!-- specific to Container --> 
  <!-- 0 or more Features -->
<!-- /Container -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Elemen Penampung berisi satu atau beberapa Fitur dan memungkinkan pembuatan hierarki bertingkat.

Memperluas

<Fitur>

Diperluas Oleh

<Dokumen>
<Folder>

Kembali ke atas

<Document>

Sintaksis

<Document id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                 <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- specific to Document -->
  <!-- 0 or more Schema elements -->
  <!-- 0 or more Feature elements -->
</Document>

Deskripsi

Dokumen adalah penampung untuk fitur dan gaya. Elemen ini wajib ada jika file KML Anda menggunakan gaya bersama. Sebaiknya gunakan gaya bersama, yang memerlukan langkah-langkah berikut:

Menentukan semua Gaya dalam Dokumen. Tetapkan ID unik untuk setiap Gaya.

Dalam Feature atau StyleMap yang diberikan, referensikan ID Gaya menggunakan elemen <styleUrl>.

Perhatikan bahwa gaya bersama tidak diwarisi oleh Fitur dalam Dokumen.

Setiap Fitur harus secara eksplisit merujuk gaya yang digunakannya dalam elemen <styleUrl>. Untuk Gaya yang berlaku untuk Dokumen (seperti ListStyle), Dokumen itu sendiri harus secara eksplisit merujuk ke <styleUrl>. Misalnya:

<Document>
  <Style id="myPrettyDocument">
   <ListStyle> ... </ListStyle>

  </Style>
  <styleUrl#myPrettyDocument">
  ...
</Document>

Jangan tempatkan gaya bersama dalam Folder.

Contoh berikut menggambarkan penggunaan gaya bersama.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>Document.kml</name>
  <open>1</open>
  <Style id="exampleStyleDocument">
    <LabelStyle>
      <color>ff0000cc</color>
    </LabelStyle>
  </Style>
  <Placemark>
    <name>Document Feature 1</name>
    <styleUrl>#exampleStyleDocument</styleUrl>
    <Point>
      <coordinates>-122.371,37.816,0</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <name>Document Feature 2</name>
    <styleUrl>#exampleStyleDocument</styleUrl>
    <Point>
      <coordinates>-122.370,37.817,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Memperluas

<Penampung>

Berisi

0 atau beberapa elemen yang berasal dari <Feature>
0 atau beberapa elemen yang berasal dari <StyleSelector>
0 atau beberapa elemen yang berasal dari <Schema>

Kembali ke atas

<gx:durasi>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:duration>0.0</gx:duration>            <!-- double -->

Deskripsi

<gx:duration> memperluas gx:TourPrimitive dengan menentukan rentang waktu untuk peristiwa. Waktu ditulis sebagai detik menggunakan jenis data double XML.

Durasi dan <gx:FlyTo>

Jika durasi disertakan dalam elemen <gx:FlyTo>, durasi akan menentukan durasi yang diperlukan browser untuk terbang dari titik sebelumnya ke titik yang ditentukan.

<gx:FlyTo>
  <gx:flyToMode>bounce</gx:flyToMode>
  <gx:duration>10.2</gx:duration>

  <!-- AbstractView -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

Durasi dan <gx:AnimatedUpdate>

Menentukan durasi pembaruan berlangsung. Kolom bilangan bulat, float, dan warna dianimasikan dengan lancar dari nilai asli ke nilai baru di seluruh durasi; boolean, string, dan nilai lain yang tidak digunakan untuk interpolasi diperbarui pada akhir durasi.

<gx:AnimatedUpdate>
  <gx:duration>5.0</gx:duration>
  <Update>

    ....

  </Update>
</gx:AnimatedUpdate>

<ExtendedData>

Sintaksis

<ExtendedData>                       
  <Data name="string">
    <displayName>...</displayName>    <!-- string -->
    <value>...</value>                <!-- string -->
  </Data>
  <SchemaData schemaUrl="anyURI">
    <SimpleData name=""> ... </SimpleData>   <!-- string -->
  </SchemaData>
  <namespace_prefix:other>...</namespace_prefix:other>
</ExtendedData>

Deskripsi

Elemen ExtendedData menawarkan tiga teknik untuk menambahkan data khusus ke Fitur KML (NetworkLink, Penanda Letak, GroundOverlay, PhotoOverlay, ScreenOverlay, Dokumen, Folder). Teknik ini

Menambahkan pasangan data/nilai tanpa jenis menggunakan elemen <Data> (dasar)
Mendeklarasikan kolom jenis baru menggunakan elemen <Schema>, lalu membuat instance kolom tersebut menggunakan elemen <SchemaData> (lanjutan)
Merujuk ke elemen XML yang didefinisikan dalam namespace lain dengan mengacu ruang nama eksternal dalam file KML (dasar)

Teknik ini dapat digabungkan dalam satu file KML atau Fitur untuk bagian data yang berbeda.

Untuk informasi selengkapnya, lihat Menambahkan Data Khusus di "Topik di KML".

Elemen Khusus untuk ExtendedData

<Nama data ="string">

Membuat pasangan name/value yang tidak berjenis. Nama dapat memiliki dua versi: name dan displayName. Atribut name digunakan untuk mengidentifikasi pasangan data dalam file KML. Elemen displayName digunakan saat nama yang diformat dengan benar, dengan spasi dan pemformatan HTML, ditampilkan di Google Earth. Dalam elemen <text> <BalloonStyle>, notasi $[name/displayName] diganti dengan <displayName>. Jika Anda mengganti nilai atribut name dari elemen <Data> dalam format ini (misalnya, $[holeYardage], nilai atribut akan diganti dengan <value>. Secara default, balon Penanda Letak menampilkan pasangan nama/nilai yang terkait dengannya.

<displayName>

Versi nama berformat opsional, yang akan digunakan untuk tujuan tampilan.

<nilai>

Nilai pasangan data.

<Placemark>
  <name>Club house</name>
  <ExtendedData>
    <Data name="holeNumber">
      <value>1</value>
    </Data>
    <Data name="holeYardage">
      <value>234</value>
    </Data>
    <Data name="holePar">
      <value>4</value>
    </Data>
  </ExtendedData>
</Placemark>

<SchemaData schemaUrl="anyURI">

Elemen ini digunakan bersama dengan <Schema> untuk menambahkan data kustom yang diketik ke Fitur KML. Elemen skema (yang diidentifikasi oleh atribut schemaUrl) mendeklarasikan jenis data kustom. Objek data aktual ("instance" dari data kustom) ditentukan menggunakan elemen SchemaData.

<schemaURL> dapat berupa URL lengkap, referensi ke ID Skema yang ditentukan dalam file KML eksternal, atau referensi ke ID Skema yang ditentukan dalam file KML yang sama. Semua spesifikasi berikut dapat diterima:

schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"

schemaUrl="AnotherFile.kml#my-schema-id"

schemaUrl="#schema-id"   <!-- same file -->

Elemen Skema selalu berupa turunan Dokumen. Elemen ExtendedData adalah turunan dari Fitur yang berisi data kustom.

<Nama SederhanaData="string">: Elemen ini menetapkan nilai ke kolom data kustom yang diidentifikasi oleh atribut name. Jenis dan nama kolom data kustom ini dideklarasikan dalam elemen <Schema>.; Berikut contoh cara menentukan dua elemen data kustom:

<namespace_prefix:other>: Dengan elemen ini, Anda dapat menambahkan data kustom tanpa jenis. Pastikan untuk mereferensikan awalan namespace di elemen <kml> file Anda atau sebagai atribut elemen <ExtendedData> dan untuk awalan nama setiap elemen data dengan awalan namespace. Data kustom yang ditambahkan dengan cara ini akan disimpan di file KML, tetapi tidak digunakan oleh Google Earth dengan cara apa pun. ID ini selalu disimpan bersama file.; Contoh berikut menunjukkan penggunaan awalan namespace "camp":

Dimuat Oleh

Elemen apa pun yang berasal dari <Feature>

Lihat Juga

Skema

<Fitur>

Sintaksis

<!-- abstract element; do not create -->
<!-- Feature id="ID" -->                <!-- Document,Folder,
                                             NetworkLink,Placemark,
                                             GroundOverlay,PhotoOverlay,ScreenOverlay -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>    <!-- TimeStamp or TimeSpan -->
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->
<-- /Feature -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Diagram berikut menunjukkan bagaimana sebagian elemen Fitur muncul di Google Earth.

Elemen Khusus untuk Fitur

<name>

Teks buatan pengguna yang ditampilkan dalam penampil 3D sebagai label untuk objek (misalnya, untuk Penanda Letak, Folder, atau NetworkLink).

<visibility>

Nilai Boolean. Menentukan apakah fitur digambar di penampil 3D saat pertama kali dimuat. Agar fitur terlihat, tag <visibilitas> semua ancestornya juga harus ditetapkan ke 1. Dalam Tampilan Daftar Google Earth, setiap Fitur memiliki kotak centang yang memungkinkan pengguna mengontrol visibilitas Fitur.

<open>

Nilai Boolean. Menentukan apakah Dokumen atau Folder tampak ditutup atau terbuka saat pertama kali dimuat ke panel Tempat. 0=diciutkan (default), 1=diperluas. Lihat juga <ListStyle>. Elemen ini hanya berlaku untuk Dokumen, Folder, dan NetworkLink.

<atom:author>

KML 2.2 mendukung elemen baru untuk menyertakan data tentang penulis dan situs terkait dalam file KML Anda. Informasi ini ditampilkan di hasil penelusuran geografis, baik di browser Earth seperti Google Earth, serta di aplikasi lain seperti Google Maps. Elemen skrip yang digunakan di KML adalah sebagai berikut:

Elemen atom:author - elemen induk untuk atom:name
Elemen atom:name - nama penulis
Elemen atom:link - berisi atribut href
Atribut href - URL halaman web yang berisi file KML/KMZ

Elemen ini ditentukan dalam Format Sindikasi Atom. Spesifikasi lengkapnya dapat ditemukan di http://atompub.org. (lihat contoh yang mengikuti).

Elemen <atom:author> adalah elemen induk untuk <atom:name>, yang menentukan penulis fitur KML.

<atom:link href="..." >

Menentukan URL situs yang berisi file KML atau KMZ ini. Pastikan untuk menyertakan namespace untuk elemen ini dalam file KML apa pun yang menggunakannya: xmlns:atom="http://www.w3.org/2005/Atom" (lihat contoh yang mengikuti).

<address>

Nilai string yang mewakili alamat tidak terstruktur yang ditulis sebagai jalan standar, kota, alamat negara bagian, dan/atau sebagai kode pos. Anda dapat menggunakan tag <address> untuk menentukan lokasi titik, bukan menggunakan koordinat lintang dan bujur. (Namun, jika diberikan, <Point> akan lebih diutamakan daripada <address>.) Untuk mengetahui lokalitas yang didukung untuk tag ini di Google Earth, buka Bantuan Google Maps.

<xal:AlamatDetail>

Alamat terstruktur, yang diformat sebagai xAL, atau eXtensible Address Language, sebuah standar internasional untuk pemformatan alamat. <xal:AddressDetails> digunakan oleh KML untuk geocoding di Google Maps saja. Untuk detailnya, lihat dokumentasi Google Maps API. Saat ini, Google Earth tidak menggunakan elemen ini; sebagai gantinya, gunakan <address>. Pastikan untuk menyertakan namespace untuk elemen ini dalam file KML apa pun yang menggunakannya: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<phoneNumber>

Nilai string yang mewakili nomor telepon. Elemen ini hanya digunakan oleh Google Maps Seluler. Standar industri untuk ponsel yang mendukung Java adalah RFC2806.
Untuk informasi selengkapnya, lihat http://www.schemas.org/RFC /RFC2806.txt.

<Cuplikan maxLines="2" >

Deskripsi singkat fitur. Di Google Earth, deskripsi ini ditampilkan di panel Tempat pada nama fitur. Jika Cuplikan tidak diberikan, dua baris pertama <description> akan digunakan. Di Google Earth, jika Penanda Letak berisi deskripsi dan Cuplikan, <Cuplikan> akan muncul di bawah Penanda Letak di panel Tempat, dan <deskripsi> muncul di balon deskripsi Penanda Letak. Tag ini tidak mendukung markup HTML. <Cuplikan> memiliki atribut maxLines, bilangan bulat yang menentukan jumlah maksimum baris untuk ditampilkan.

<description>

Konten yang disediakan pengguna yang muncul di balon deskripsi.

Konten yang didukung untuk elemen <description> diubah dari Google Earth 4.3 menjadi 5.0. Informasi spesifik untuk setiap versi tercantum di bawah, diikuti dengan informasi yang sama untuk keduanya.

Google Earth 5.0

Google Earth 5.0 (dan yang lebih baru) mendukung konten teks biasa, serta HTML dan JavaScript lengkap, dalam balon deskripsi. Konten dari tag deskripsi dirender oleh mesin browser web open source WebKit, dan ditampilkan seperti dalam browser berbasis WebKit apa pun.

Batasan umum

Link ke file lokal umumnya tidak diizinkan. Langkah ini mencegah kode berbahaya merusak sistem atau mengakses data Anda. Jika Anda ingin mengizinkan akses ke sistem file lokal Anda, pilih Preferensi > Izinkan akses ke file lokal dan data pribadi. Link ke file gambar di sistem file lokal selalu diizinkan, jika berada dalam tag <img>.

Konten yang telah dikompresi ke dalam file KMZ dapat diakses, meskipun pada sistem file lokal.

Cookie diaktifkan, tetapi untuk tujuan kebijakan asal yang sama, konten lokal tidak membagikan domain dengan konten lain (termasuk konten lokal lainnya).

HTML

Sebagian besar HTML dirender seperti di browser WebKit mana pun.

Target akan diabaikan jika disertakan dalam HTML yang ditulis langsung ke KML; semua link tersebut akan dibuka seolah-olah target ditetapkan ke _blank. Semua target yang ditentukan akan diabaikan.

Namun, HTML yang terdapat dalam iFrame, atau dibuat secara dinamis dengan JavaScript atau DHTML, akan menggunakan target="_self" sebagai default. Target lainnya dapat ditentukan dan didukung.

Konten file KMZ, link anchor lokal, dan metode ;flyto tidak dapat ditargetkan dari HTML yang dimuat dalam iFrame.

Jika pengguna menentukan width="100%" untuk lebar iFrame, lebar iFrame akan bergantung pada semua konten lain dalam balon—hal ini pada dasarnya harus diabaikan saat menghitung ukuran tata letak. Aturan ini juga berlaku untuk elemen blok lain di dalam balon.

JavaScript

Sebagian besar JavaScript didukung. Kotak dialog tidak dapat dibuat. Fungsi seperti alert() dan prompt() tidak akan ditampilkan. Namun, error tersebut akan ditulis ke konsol sistem, seperti halnya error dan pengecualian lainnya.

CSS

CSS diizinkan. Seperti CSS di browser web biasa, CSS dapat digunakan untuk menata gaya teks, elemen halaman, serta mengontrol ukuran dan tampilan balon deskripsi.

Google Earth 4.3

Elemen <description> mendukung teks biasa serta subset elemen pemformatan HTML, termasuk tabel (lihat contoh KML di bawah). Ini tidak mendukung teknologi berbasis web lainnya, seperti markup halaman dinamis (PHP, JSP, ASP), bahasa skrip (VBScript, JavaScript), atau bahasa aplikasi (Java, Python). Pada rilis Google Earth 4.2, video didukung. (Lihat Contoh di bawah.)

Informasi umum

Jika deskripsi Anda tidak berisi markup HTML, Google Earth akan mencoba memformatnya, mengganti baris baru dengan <br> dan menggabungkan URL dengan tag anchor. String URL yang valid untuk World Wide Web akan otomatis dikonversi menjadi hyperlink ke URL tersebut (misalnya, http://www.google.com). Oleh karena itu, Anda tidak perlu mengapit URL dengan tag <a href="http://.."></a> untuk mencapai link sederhana.

Saat menggunakan HTML untuk membuat hyperlink di sekitar kata tertentu, atau saat menyertakan gambar dalam HTML, Anda harus menggunakan referensi entitas HTML atau elemen CDATA untuk meng-escape tanda kurung sudut, apostrof, dan karakter khusus lainnya. Elemen CDATA memberi tahu parser XML untuk mengabaikan karakter khusus yang digunakan dalam tanda kurung. Elemen ini berbentuk:

<![CDATA[
  special characters here
]]>

Jika memilih untuk tidak menggunakan elemen CDATA, Anda dapat menggunakan referensi entitas untuk mengganti semua karakter khusus.

<description>
  <![CDATA[
This is an image
<img src="icon.jpg">
  ]]>
</description>

Perilaku Lain yang Ditentukan Melalui Penggunaan Elemen <a>

KML mendukung penggunaan dua atribut dalam elemen <a>: href dan type.

Elemen anchor <a> berisi atribut href yang menentukan URL.

Jika href adalah file KML dan memiliki ekstensi file .kml atau .pubsub, Google Earth akan memuat file tersebut secara langsung saat pengguna mengkliknya. Jika URL diakhiri dengan ekstensi yang tidak dikenal oleh Google Earth (misalnya, .html), URL dikirimkan ke browser.

href dapat berupa URL fragmen (yaitu URL dengan tanda #, diikuti dengan ID KML). Saat pengguna mengklik link yang menyertakan URL fragmen, browser akan terbang ke Fitur yang ID-nya secara default cocok dengan fragmen tersebut. Jika Fitur memiliki elemen LookAt atau Camera, Fitur akan dilihat dari sudut pandang yang ditentukan.

Perilaku tersebut dapat ditentukan lebih lanjut dengan menambahkan salah satu dari tiga string berikut ke URL fragmen:

;flyto (default) - terbang ke Fitur
;balloon - buka balon Fitur namun jangan terbang ke Fitur
;balloonFlyto - buka balon Fitur dan terbang ke Fitur

Misalnya, kode berikut menunjukkan untuk membuka file CraftsFairs.kml, terbang ke Penanda Letak yang ID-nya adalah "Albuquerque", dan buka balonnya:

<description>
  <![CDATA[ 
    <a href="http://myServer.com/CraftsFairs.kml#Albuquerque;balloonFlyto">
      One of the Best Art Shows in the West</a>
  ]]>
</description>

Atribut type digunakan dalam elemen <a> jika href tidak diakhiri dengan .kml atau .pubsub, tetapi referensi harus ditafsirkan dalam konteks KML. Tentukan nilai berikut:

type="application/vnd.google-earth.kml+xml"

Misalnya, URL berikut menggunakan atribut type untuk memberi tahu Google Earth bahwa URL harus mencoba memuat file, meskipun ekstensi file adalah .php:

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">

<AbstractView>

Menentukan sudut pandang yang terkait dengan elemen apa pun yang berasal dari Fitur. Lihat <Camera> dan <LookAt>.

<TimePrimitive>

Mengaitkan Fitur ini dengan jangka waktu tertentu (<TimeSpan>) atau titik waktu (<TimeStamp>).

<styleUrl>

URL <Style> atau <StyleMap> ditentukan dalam Dokumen. Jika gaya berada di file yang sama, gunakan referensi #. Jika gaya ditentukan dalam file eksternal, gunakan URL lengkap bersama # referensi. Contohnya adalah

<styleUrl>#myIconStyleID</styleUrl>

<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>

<styleUrl>eateries.kml#my-lunch-spot</styleUrl>

<PemilihPilih>

Satu atau beberapa Gaya dan GayaMaps dapat ditentukan untuk menyesuaikan tampilan elemen apa pun yang berasal dari Fitur atau Geometri dalam Penanda Letak. (Lihat <BalloonStyle>, <ListStyle>, <StyleSelector>, dan gaya yang berasal dari <ColorStyle>.) Gaya yang didefinisikan dalam Fitur disebut "gaya inline" dan hanya berlaku untuk Fitur yang ada di dalamnya. Gaya yang didefinisikan sebagai turunan dari <Document> disebut "gaya bersama". Gaya bersama harus memiliki id yang ditentukan. ID ini direferensikan oleh satu atau beberapa Fitur dalam <Dokumen>. Jika elemen gaya ditentukan dalam gaya bersama dan dalam gaya inline untuk Fitur—yaitu, Folder, GroundOverlay, NetworkLink, Penanda Letak, atau ScreenOverlay—nilai untuk gaya inline Fitur lebih diprioritaskan daripada nilai untuk gaya bersama.

<Region>

Fitur dan geometri yang terkait dengan Region hanya digambar saat Region aktif. Lihat <Region>.

<Metadata>

<ExtendedData>

Memungkinkan Anda menambahkan data kustom ke file KML. Data ini dapat berupa (1) data yang mereferensikan skema XML eksternal, (2) pasangan data/nilai yang tidak berjenis, atau (3) data yang diketik. Fitur KML yang diberikan dapat berisi kombinasi jenis data kustom ini.

Contoh Penggunaan Elemen HTML dalam Deskripsi

Contoh ini menggambarkan rangkaian lengkap elemen HTML yang didukung oleh elemen <description> di Google Earth 4.3. Google Earth 5.0 dan yang lebih baru mendukung HTML dan JavaScript lengkap.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
  <name>Feature.kml</name>
  <Snippet maxLines="4">
    The snippet is a way of
    providing an alternative
    description that will be
    shown in the List view.
  </Snippet> 
  <description>
    <![CDATA[
      Styles: <i>Italics</i>, <b>Bold</b>, <u>Underlined</u>, 
      <s>Strike Out</s>, subscript<sub>subscript</sub>,
      superscript<sup>superscript</sup>,  
      <big>Big</big>, <small>Small</small>, <tt>Typewriter</tt>,
      <em>Emphasized</em>, <strong>Strong</strong>, <code>Code</code>
      <hr />
      Fonts: 
      <font color="red">red by name</font>, 
      <font color="#408010">leaf green by hexadecimal RGB</font>, 
      <font size=1>size 1</font>, <font size=2>size 2</font>,
      <font size=3>size 3</font>, <font size=4>size 4</font>,
      <font size=5>size 5</font>, <font size=6>size 6</font>, 
      <font size=7>size 7</font>,
      <font face=times>Times</font>, 
      <font face=verdana>Verdana</font>, 
      <font face=arial>Arial</font>
      <br/>
      <hr />
      Links:
      <a href="http://doc.trolltech.com/3.3/qstylesheet.html">
      QT Rich Text Rendering
      </a>
      <br />
      <hr />
      Alignment:
      <br />
      <p align=left>left</p><p align=center>center</p>
      <p align=right>right</p>
      <hr />
      Ordered Lists:
      <br />
      <ol><li>First</li><li>Second</li><li>Third</li></ol>
      <ol type="a"><li>First</li><li>Second</li><li>Third</li></ol>
      <ol type="A"><li>First</li><li>Second</li><li>Third</li></ol>
      <hr />
      Unordered Lists:
      <br />
      <ul><li>A</li><li>B</li><li>C</li></ul>
      <ul type="circle"><li>A</li><li>B</li><li>C</li></ul>
      <ul type="square"><li>A</li><li>B</li><li>C</li></ul>
      <hr />
      Definitions:
      <br />
      <dl>
      <dt>Scrumpy</dt>
      <dd>Hard English cider from the west country</dd>
      <dt>Pentanque</dt>
      <dd>A form of boules where the goal is to throw metal ball as
      close as possible to a jack</dd>
      </dl>
      <hr />
      Block Quote:
      <br />
      <blockquote>
      We shall not cease from exploration<br />
      And the end of all our exploring<br />
      Will be to arrive where we started<br />
      And know the place for the first time
      </blockquote>
      <br />
      <hr />
      Centered:
      <br />
      <center>See, I have a Rhyme assisting<br />
      my feeble brain,<br />
      its tasks oft-times resisting!</center>
      <hr />
      Headings:
      <br />
      <h1>Header 1</h1>
      <h2>Header 2</h2>
      <h3>Header 3</h3>
      <h3>Header 4</h4>
      <h3>Header 5</h5>
      <hr />
      Images:
      <br />
      <img src="icon.jpg"> 
and we have a link http://www.google.com.]]>
  </description>
  <Point>
    <coordinates>-122.378927,37.826793,0</coordinates>
  </Point>
</Placemark>
</kml>

Contoh Penggunaan Elemen Skrip

Contoh ini menunjukkan penggunaan elemen <atom:author>, <atom:name>, dan <atom:link> dari namespace Atom. Perhatikan bahwa Anda perlu mereferensikan namespace ini dalam elemen <kml>.

<kml xmlns="http://www.opengis.net/kml/2.2"
     xmlns:atom="http://www.w3.org/2005/Atom"> 
  <Document>
    <atom:author>
      <atom:name>J. K. Rowling</atom:name>
    </atom:author>
    <atom:link href="http://www.harrypotter.com" />
    <Placemark>
      <name>Hogwarts</name>
      <Point>
        <coordinates>1,1</coordinates>
      </Point>
    </Placemark>
    <Placemark>
      <name>Little Hangleton</name>
      <Point>
        <coordinates>1,2</coordinates>
      </Point>
    </Placemark>
  </Document>
</kml>

Video Sampel

Contoh ini menunjukkan cara menyematkan video Flash di dalam Balon.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <name>Video Example</name>
    <Style id="sn_blue-dot_copy3">
      <IconStyle>
        <Icon>
          <href>http://www.google.com/intl/en_us/mapfiles/ms/icons/blue-dot.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <Placemark>
      <name>Placemark</name>
      <description>
        <![CDATA[<div style="font-size:larger">
          <div>
            <div style="width: 212px; font-size: 12px;">
              <b>The Spaghetti Film</b>
            </div>
            <div style="font-size: 11px;">
              <a target="_blank" href="http://www.youtube.com/?v=FICUvrVlyXc">
                http://www.youtube.com/?v=FICUvrVlyXc</a><br>
            </div><br>
            <div style="margin-left: auto; margin-right:auto;">
              <object height="175" width="212">
                <param value="http://www.youtube.com/v/FICUvrVlyXc" name="movie">
                <param value="transparent" name="wmode">
                <embed wmode="transparent" type="application/x-shockwave-flash"
                   src="http://www.youtube.com/v/FICUvrVlyXc" height="175"
                   width="212">
               </object>
             </div>
           </div>
          </div>
          <div style="font-size: smaller; margin-top: 1em;">Saved from 
            <a href="http://maps.google.com/ig/add?synd=mpl&pid=mpl&moduleurl=
                http:%2F%2Fwww.google.com%2Fig%2Fmodules%2Fmapplets-youtube.xml&hl=en&gl=us">
                YouTubeVideos</a>
          </div>
         ]]>
      </description>
      <styleUrl>#sn_blue-dot_copy3</styleUrl>
      <Point>
        <coordinates>-93.47875999999999,45.083248,0</coordinates>
      </Point>
    </Placemark>
</Document>
</kml>

Memperluas

<Objek>

Diperluas Oleh

<Penampung>
<Overlay>
<Tanda Letak>
<NetworkLink>
<gx:Tur>

<gx:TerbangKe>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:FlyTo id="ID">
  <gx:duration>0.0</gx:duration>         <!-- double -->
  <gx:flyToMode>bounce</gx:flyToMode>    <!-- smooth or bounce -->
  <!-- AbstractView -->                        <!-- Camera or LookAt -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

Deskripsi

<gx:FlyTo> menentukan titik di ruang ke mana browser akan terbang selama tur. Ini harus berisi satu AbstractView, dan harus berisi elemen <gx:duration> dan <gx:flyToMode>, yang menentukan waktu yang diperlukan untuk terbang ke titik yang ditentukan dari titik saat ini, dan metode penerbangan.

<gx:flyToMode>

Ada dua nilai yang diizinkan untuk <gx:flyToMode>: smooth, dan pantulan.

FlyTo Halus memungkinkan penerbangan yang tidak terputus dari satu titik ke titik lainnya (dan seterusnya). Rangkaian FlyTo yang mulus dan tidak terputus akan dimulai dan diakhiri dengan kecepatan nol, dan tidak akan melambat di setiap titik. Serangkaian FlyTo yang lancar rusak oleh salah satu elemen berikut:
- <gx:flyToMode>bounce</gx:flyToMode>
- <gx:Wait>
Artinya, kecepatan akan bernilai nol di FlyTo yang lancar tepat sebelum salah satu elemen di atas. Serangkaian FlyTos yang lancar tidak rusak oleh elemen <gx:AnimatedUpdate>.

Pantulan FlyTos masing-masing dimulai dan berakhir pada kecepatan nol.

Contoh

<gx:FlyTo>
  <gx:duration>2.55</gx:duration>
  <gx:flyToMode>smooth</gx:flyToMode>
  <Camera>
    <longitude>-113.084448</longitude>
    <latitude>36.567081</latitude>
    <altitude>41277.571403</altitude>
    <heading>116.150227</heading>
    <altitudeMode>absolute</altitudeMode>
  </Camera>
</gx:FlyTo>

Memperluas

<gx:TourPrimitive>

Berisi

<gx:durasi>
<gx:flyToMode>
<AbstractView>

<Folder>

Sintaksis

<Folder id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>

  <!-- specific to Folder -->
  <!-- 0 or more Feature elements -->
</Folder>

Deskripsi

Folder digunakan untuk mengatur Fitur lain secara hierarkis (Folder, Penanda Letak, NetworkLink, atau Overlay). Fitur hanya dapat dilihat jika fitur tersebut dan semua ancestornya terlihat.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Folder>
  <name>Folder.kml</name>
  <open>1</open>
  <description>
    A folder is a container that can hold multiple other objects
  </description>
  <Placemark>
    <name>Folder object 1 (Placemark)</name>
    <Point>
      <coordinates>-122.377588,37.830266,0</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <name>Folder object 2 (Polygon)</name>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.377830,37.830445,0
            -122.377576,37.830631,0
            -122.377840,37.830642,0
            -122.377830,37.830445,0
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </Placemark>
  <Placemark>
    <name>Folder object 3 (Path)</name>
    <LineString>
      <tessellate>1</tessellate>
      <coordinates>
        -122.378009,37.830128,0 -122.377885,37.830379,0
      </coordinates>
    </LineString>
  </Placemark>
</Folder>
</kml>

Memperluas

<Penampung>

Berisi

Elemen apa pun yang berasal dari <Feature>

<Geometri>

Sintaksis

<!-- abstract element; do not create -->
<!-- Geometry id="ID" -->
                                              <!-- Point,LineString,LinearRing,
                                               Polygon,MultiGeometry,Model,
                                               gx:Track -->
<!-- /Geometry -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Ini menyediakan objek placeholder untuk semua objek Geometri turunan.

Memperluas

<Objek>

Diperluas Oleh

<Titik>
<BarisString>
<LinearRing>
<Poligon>
<MultiGeometri>
<gx:MultiTrack>
<Model>
<gx:Pelacakan>

<GroundOverlay>

Sintaksis

<GroundOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- inherited from Overlay element -->
  <color>ffffffff</color>                   <!-- kml:color -->
  <drawOrder>0</drawOrder>                  <!-- int -->
  <Icon>...</Icon>

  <!-- specific to GroundOverlay -->
  <altitude>0</altitude>                    <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
     <!-- kml:altitudeModeEnum: clampToGround or absolute -->
     <!-- or, substitute gx:altitudeMode: clampToSeaFloor or relativeToSeaFloor -->
  <LatLonBox>
    <north>...</north>                      <! kml:angle90 -->
    <south>...</south>                      <! kml:angle90 -->
    <east>...</east>                        <! kml:angle180 -->
    <west>...</west>                        <! kml:angle180 -->
    <rotation>0</rotation>                  <! kml:angle180 -->
  </LatLonBox>
  <gx:LatLonQuad>
    <coordinates>...</coordinates>          <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

Deskripsi

Elemen ini menggambar overlay gambar yang ditampilkan ke medan. Anak <href> dari <Icon> menentukan gambar yang akan digunakan sebagai overlay. File ini dapat berada di sistem file lokal atau di server web. Jika elemen ini dihilangkan atau tidak berisi <href>, persegi panjang akan digambar menggunakan batas warna dan LatLonBox yang ditentukan oleh overlay bumi.

Elemen Khusus untuk GroundOverlay

<altitude>

Menentukan jarak di atas permukaan bumi, dalam meter, dan ditafsirkan sesuai dengan mode ketinggian.

<altitudeMode>

Menentukan cara <height>diinterpretasikan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian dan menghamparkan overlay di atas medan.
absolut - Menetapkan ketinggian overlay relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian overlay menjadi 10 meter dengan mode ketinggian absolut, overlay akan muncul berada di permukaan tanah jika medan di bawahnya juga berada 10 meter di atas permukaan laut. Jika medannya 3 meter di atas permukaan laut, overlay akan tampak ditinggikan di atas medan sebesar 7 meter.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, <Ketinggian> akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi <height> diabaikan, dan overlay akan tertutup di atas dasar laut. Jika titik berada di darat dan bukan di laut, overlay akan diposisikan di tanah.

<LatLonBox>

Menentukan posisi bagian atas, bawah, kanan, dan kiri kotak pembatas untuk overlay bumi.

<north> Menentukan garis lintang tepi utara kotak pembatas, dalam derajat desimal dari 0 hingga ±90.
<south> Menentukan garis lintang tepi selatan kotak pembatas, dalam derajat desimal dari 0 hingga ±90.
<east> Menentukan garis bujur tepi timur kotak pembatas, dalam derajat desimal dari 0 hingga ±180. (Untuk overlay yang tumpang-tindih dengan meridian garis bujur 180°, nilai dapat melampaui rentang tersebut.)
<west> Menentukan garis bujur tepi barat kotak pembatas, dalam derajat desimal dari 0 hingga ±180. (Untuk overlay yang tumpang-tindih dengan meridian garis bujur 180°, nilai dapat melampaui rentang tersebut.)
<rotation> Menentukan rotasi overlay di sekitar pusatnya, dalam derajat. Nilainya bisa ±180. Default-nya adalah 0 (utara). Rotasi ditentukan dalam arah berlawanan arah jarum jam.

<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox>

<gx:LatLonQuad>

Digunakan untuk overlay bumi segi empat non-persegi panjang.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<GroundOverlay>
   <name>GroundOverlay.kml</name>
   <color>7fffffff</color>
   <drawOrder>1</drawOrder>
   <Icon>
      <href>http://www.google.com/intl/en/images/logo.gif</href>
      <refreshMode>onInterval</refreshMode>
      <refreshInterval>86400</refreshInterval>
      <viewBoundScale>0.75</viewBoundScale>
   </Icon>
   <LatLonBox>
      <north>37.83234</north>
      <south>37.832122</south>
      <east>-122.373033</east>
      <west>-122.373724</west>
      <rotation>45</rotation>
   </LatLonBox>
</GroundOverlay>
</kml>

Memperluas

<Fitur>
<Overlay>

Dimuat Oleh

<Dokumen>
<Folder>

<Icon>

Sintaksis

<Icon id="ID">
  <!-- specific to Icon -->
  <href>...</href>                         <!-- anyURI -->
  <gx:x>0<gx:x/>                           <!-- int -->
  <gx:y>0<gx:y/>                           <!-- int -->
  <gx:w>-1<gx:w/>                          <!-- int -->
  <gx:h>-1<gx:h/>                          <!-- int -->
  <refreshMode>onChange</refreshMode>
    <!-- kml:refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>     <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- kml:viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>     <!-- float -->
  <viewBoundScale>1</viewBoundScale>       <!-- float -->
  <viewFormat>...</viewFormat>             <!-- string -->
  <httpQuery>...</httpQuery>               <!-- string -->
</Icon>

Deskripsi

Menentukan gambar yang terkait dengan gaya Ikon atau overlay. Elemen turunan <href> yang diperlukan menentukan lokasi gambar yang akan digunakan sebagai overlay atau sebagai ikon penanda letak. Lokasi ini dapat berada di sistem file lokal atau server web jarak jauh. Elemen <gx:x>, <gx:y>, <gx:w>, dan <gx:h> digunakan untuk memilih satu ikon dari gambar yang berisi beberapa ikon (sering kali disebut sebagai palet ikon.

<Icon>
  <href>Sunset.jpg</href>   <!-- Here, the image contains only one icon -->
</Icon>

<Icon>
  <href>/home/mydir/myiconpalette.jpg</href>
  <gx:w>138</gx:w>
  <gx:h>138</gx:h>
    <!-- Since x and y values are omitted, these measurements are made starting at
    the lower-left corner of the icon palette image -->
</Icon>

Elemen Khusus untuk Ikon

<href>: Alamat HTTP atau spesifikasi file lokal yang digunakan untuk memuat ikon.
<gx.x>
<gx:y>: Jika <href> menentukan palet ikon, elemen ini mengidentifikasi offset, dalam piksel, dari sudut kiri bawah palet ikon.Jika tidak ada nilai yang ditentukan untuk x dan y, sudut kiri bawah palet ikon akan diasumsikan sebagai sudut kiri bawah ikon yang akan digunakan.
<gx:w>
<gx:j>: Jika <href> menentukan palet ikon, elemen ini menentukan lebar (<gx:w>) dan tinggi (<gx:h>), dalam piksel, dari ikon yang akan digunakan.
<refreshMode>: Untuk deskripsi <refreshMode> dan elemen lain yang tercantum di bawah, lihat <Link>.
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

Dimuat Oleh

<GroundOverlay>
<ScreenOverlay>
<IconStyle>

<IconStyle>

Sintaksis

<IconStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum:normal or random -->

  <!-- specific to IconStyle -->
  <scale>1</scale>                   <!-- float -->
  <heading>0</heading>               <!-- float -->
  <Icon>
    <href>...</href>
  </Icon>
  <hotSpot x="0.5"  y="0.5"
    xunits="fraction" yunits="fraction"/>    <!-- kml:vec2 -->
</IconStyle>

Deskripsi

Menentukan cara menggambar ikon Penanda Letak titik, baik di panel Tempat dan dalam penampil 3D Google Earth. Elemen <Icon> menentukan gambar ikon. Elemen <scale> menentukan penskalaan x, y pada ikon. Warna yang ditentukan dalam elemen <color> <IconStyle> dicampur dengan warna <Icon>.

Elemen Khusus untuk IconStyle

<scale>

Mengubah ukuran ikon.

Catatan: Tag <geomScale> tidak digunakan lagi. Gunakan <scale> sebagai gantinya.

<heading>

Arah (yaitu, Utara, Selatan, Timur, Barat), dalam derajat. Default=0 (Utara). (Lihat diagram.) Nilai berkisar dari 0 hingga 360 derajat.

<Icon>

Ikon kustom. Di <IconStyle>, satu-satunya elemen turunan <Icon> adalah <href>:

<href>: Alamat HTTP atau spesifikasi file lokal yang digunakan untuk memuat ikon.

<hotSpot x="0.5" y="0.5" xunits="fraksi" yunits="fraction">

Menentukan posisi dalam Ikon yang "ditambatkan" ke <Point> yang ditentukan dalam Penanda Letak. Nilai x dan y dapat ditentukan dengan tiga cara berbeda: sebagai piksel ("pixels"), sebagai fraksi ikon ("fraction"), atau sebagai piksel inset ("insetPixels"), yang merupakan offset dalam piksel dari sudut kanan atas ikon. Posisi x dan y dapat ditentukan dengan cara yang berbeda—misalnya, x dapat berupa piksel dan y dapat berupa pecahan. Asal sistem koordinat ada di sudut kiri bawah ikon.

x - Jumlah piksel, komponen pecahan dari ikon, atau inset piksel yang menunjukkan komponen x dari sebuah titik pada ikon.
y - Jumlah piksel, komponen pecahan dari ikon, atau inset piksel yang menunjukkan komponen y dari sebuah titik pada ikon.
xunits - Unit tempat nilai x ditentukan. Nilai fraksi menunjukkan nilai x adalah pecahan dari ikon. Nilai piksel menunjukkan nilai x dalam piksel. Nilai insetPixels menunjukkan indentasi dari tepi kanan ikon.
yunits - Unit tempat nilai y ditentukan. Nilai fraksi menunjukkan nilai y adalah pecahan dari ikon. Nilai piksel menunjukkan nilai y dalam piksel. Nilai insetPixels menunjukkan indentasi dari tepi atas ikon.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
   <Style id="randomColorIcon">
      <IconStyle>
         <color>ff00ff00</color>
         <colorMode>random</colorMode>
         <scale>1.1</scale>
         <Icon>
            <href>http://maps.google.com/mapfiles/kml/pal3/icon21.png</href>
         </Icon>
      </IconStyle>
   </Style>
   <Placemark>
      <name>IconStyle.kml</name>
      <styleUrl>#randomColorIcon</styleUrl>
      <Point>
         <coordinates>-122.36868,37.831145,0</coordinates>
      </Point>
   </Placemark>
</Document>
</kml>

Memperluas

<WarnaGaya>

Dimuat Oleh

<Gaya>

Berisi

<href> sebagai turunan dari <Icon>

<kml>

Sintaksis

<kml xmlns="http://www.opengis.net/kml/2.2" hint="target=sky"> ... </kml>

Deskripsi

Elemen root file KML. Elemen ini wajib diisi. Kode ini mengikuti deklarasi xml di awal file. Atribut hint digunakan sebagai sinyal ke Google Earth untuk menampilkan file sebagai data langit.

Elemen <kml> juga dapat menyertakan namespace untuk skema XML eksternal apa pun yang dirujuk dalam file.

Elemen <kml> dasar berisi 0 atau 1 Fitur dan 0 atau 1 NetworkLinkControl:

<kml xmlns="http://www.opengis.net/kml/2.2">
  <NetworkLinkControl> ... </NetworkLinkControl>
  <!-- 0 or 1 Feature elements -->
</kml>

<LabelStyle>

Sintaksis

<LabelStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to LabelStyle -->
  <scale>1</scale>                   <!-- float -->
</LabelStyle>

Deskripsi

Menentukan cara <name> Fitur digambar dalam penampil 3D. Warna, mode warna, dan skala kustom untuk label (nama) dapat ditentukan.

Catatan: Tag <labelColor> tidak digunakan lagi. Gunakan <LabelStyle> sebagai gantinya.

Khusus untuk <LabelStyle>

<scale>: Mengubah ukuran label.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
   <Style id="randomLabelColor">
      <LabelStyle>
         <color>ff0000cc</color>
         <colorMode>random</colorMode>
         <scale>1.5</scale>
      </LabelStyle>
   </Style>
   <Placemark>
      <name>LabelStyle.kml</name>
      <styleUrl>#randomLabelColor</styleUrl>
      <Point>
         <coordinates>-122.367375,37.829192,0</coordinates>
      </Point>
   </Placemark>
</Document>
</kml>

Memperluas

<WarnaGaya>

Dimuat Oleh

<Gaya>

<gx:LatLonQuad>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<GroundOverlay id="ID">
  ...
  <Icon>...</Icon>
  <altitude>0</altitude>
  <altitudeMode>clampToGround</altitudeMode>                   <!-- or absolute -->
         <!-- can substitute <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode> -->

  <gx:LatLonQuad>
    <coordinates>...</coordinates>              <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

Deskripsi

Mengizinkan overlay bumi segi empat non-persegi.

Menentukan koordinat empat titik sudut segi empat yang menentukan area overlay. Tepat empat tupel koordinat harus disediakan, masing-masing terdiri dari nilai floating point untuk bujur dan lintang. Masukkan spasi di antara tupel. Jangan sertakan spasi dalam tuple. Koordinat harus ditetapkan dalam urutan berlawanan arah jarum jam dengan koordinat pertama yang sesuai dengan sudut kiri bawah gambar yang dihamparkan. Bentuk yang dijelaskan oleh sudut-sudut ini harus konveks.

Jika nilai ketiga disisipkan ke dalam tuple (merepresentasikan ketinggian), nilai tersebut akan diabaikan. Ketinggian ditetapkan menggunakan <altitude> dan <altitudeMode> (atau <gx:altitudeMode>) yang memperluas <GroundOverlay>. Mode ketinggian yang diizinkan adalah absolut, clampToGround, dan clampToSeaFloor.

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">
<GroundOverlay>
  <name>gx:LatLonQuad Example</name>
  <Icon>
    <href>http://developers.google.com/kml/documentation/images/rectangle.gif</href>
    <viewBoundScale>0.75</viewBoundScale>
  </Icon>
  <gx:LatLonQuad>
    <coordinates>
      81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015
    </coordinates>
  </gx:LatLonQuad>
</GroundOverlay>
</kml>

Memperluas

<Objek>

Dimuat oleh

<GroundOverlay>

<LinearRing>

Sintaksis

<LinearRing id="ID">
  <!-- specific to LinearRing -->
  <gx:altitudeOffset>0</gx:altitudeOffset>   <!-- double -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
    <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
    <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>             <!-- lon,lat[,alt] tuples -->
</LinearRing>

Deskripsi

Mendefinisikan string garis tertutup, biasanya batas luar Poligon. Selain itu, LinearRing juga dapat digunakan sebagai batas dalam poligon untuk membuat lubang di Poligon. Poligon dapat berisi beberapa elemen <LinearRing> yang digunakan sebagai batas dalam.

Catatan: Di Google Earth, Poligon dengan <heightMode> dari clampToGround mengikuti garis bantalan konstan; namun, LinearRing (dengan sendirinya) dengan <heightMode> dari clampToGround mengikuti garis lingkaran besar.

Elemen Khusus untuk LinearRing

<gx:ElevationOffset>

Ekstensi KML, di namespace ekstensi Google, yang mengubah cara nilai ketinggian dirender. Offset ini memungkinkan Anda untuk memindahkan seluruh LinearRing ke atas atau ke bawah sebagai unit tanpa memodifikasi semua nilai koordinat individual yang membentuk LinearRing. (Meskipun LinearRing ditampilkan menggunakan nilai offset ketinggian, nilai ketinggian awal akan dipertahankan dalam file KML.) Satuan dalam meter.

<extrude>

Nilai Boolean. Menentukan apakah LinearRing akan dihubungkan ke tanah. Untuk menerapkan geometri ini, mode ketinggian harus bersifat relativeToGround, relativeToSeaFloor, atau absolute. Hanya verteks LinearRing yang diekstrusi, bukan pusat geometri. Verteks diekstrusi menuju pusat bola bumi.

<tessellate>

Nilai Boolean. Menentukan apakah akan mengizinkan LinearRing mengikuti medan. Untuk mengaktifkan tessellation, nilai untuk <heightMode> harus clampToGround atau clampToSeaFloor. LinearRing yang sangat besar harus mengaktifkan tessellation agar mengikuti kelengkungan bumi (jika tidak, mereka mungkin akan menuju ke bawah tanah dan tersembunyi).

<altitudeMode>

Menentukan cara komponen height di elemen <ordinats> ditafsirkan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, dalam tag <koordinat>).
relativeToGround - Menetapkan ketinggian elemen relatif terhadap elevasi permukaan tanah sebenarnya dari lokasi tertentu. Misalnya, jika elevasi permukaan suatu lokasi berada tepat di permukaan laut dan ketinggian suatu titik diatur ke 9 meter, maka elevasi untuk ikon elevasi tanda letak titik adalah 9 meter dengan mode ini. Namun, jika koordinat yang sama ditetapkan di atas lokasi dengan ketinggian tanah 10 meter di atas permukaan laut, maka ketinggian koordinat adalah 19 meter. Penggunaan standar mode ini adalah untuk menempatkan tiang telepon atau lift ski.
absolut - Menetapkan ketinggian koordinat relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian koordinat ke 10 meter dengan mode ketinggian absolut, ikon penanda letak titik akan tampak berada di permukaan tanah jika medan di bawahnya juga 10 meter di atas permukaan laut. Jika medan berada 3 meter di atas permukaan laut, penanda letak akan muncul di atas medan sebesar 7 meter. Penggunaan standar mode ini adalah untuk penempatan pesawat.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, <Ketinggian> akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi <height> diabaikan, dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

<ordinat>(wajib)

Empat atau lebih tupel, masing-masing terdiri dari nilai floating point untuk bujur, lintang, dan ketinggian. Komponen height bersifat opsional. Jangan sertakan spasi dalam tuple. Koordinat terakhir harus sama dengan koordinat pertama. Koordinat hanya dinyatakan dalam derajat desimal.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
  <name>LinearRing.kml</name>
  <Polygon>
    <outerBoundaryIs>
      <LinearRing>
        <coordinates>
          -122.365662,37.826988,0
          -122.365202,37.826302,0
          -122.364581,37.82655,0
          -122.365038,37.827237,0
          -122.365662,37.826988,0
        </coordinates>
      </LinearRing>
    </outerBoundaryIs>
  </Polygon>
</Placemark>
</kml>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometri>
<Tanda Letak>
<innerBoundaryIs>
<outerBoundaryIs>

<LineString>

Sintaksis

<LineString id="ID">
  <!-- specific to LineString -->
  <gx:altitudeOffset>0</gx:altitudeOffset>  <!-- double -->
  <extrude>0</extrude>                      <!-- boolean -->
  <tessellate>0</tessellate>                <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:drawOrder>0</gx:drawOrder>            <!-- integer -->
  <coordinates>...</coordinates>            <!-- lon,lat[,alt] -->
</LineString>

Deskripsi

Menentukan kumpulan segmen garis yang terhubung. Gunakan <LineStyle> untuk menentukan warna, mode warna, dan lebar garis. Ketika LineString diekstrusi, garis memanjang ke tanah, membentuk poligon yang terlihat seperti dinding atau pagar. Untuk LineStrings yang diekstrusi, baris itu sendiri menggunakan LineStyle saat ini, dan ekstrusi menggunakan PolyStyle saat ini. Lihat Tutorial KML untuk mengetahui contoh LineString (atau jalur).

Elemen Khusus untuk LineString

<gx:ElevationOffset>

Ekstensi KML, di namespace ekstensi Google, yang mengubah cara nilai ketinggian dirender. Offset ini memungkinkan Anda untuk memindahkan seluruh LineString ke atas atau ke bawah sebagai unit tanpa memodifikasi semua nilai koordinat individual yang membentuk LineString. (Meskipun LineString ditampilkan menggunakan nilai offset ketinggian, nilai ketinggian asli akan dipertahankan dalam file KML.) Satuan dalam meter.

<extrude>

Nilai Boolean. Menentukan apakah LineString akan dihubungkan ke tanah. Untuk memberikan LineLine, mode ketinggian harus bersifat relativeToGround, relativeToSeaFloor, atau absolute. Verteks pada LineString diekstrusi menuju pusat bola bumi.

<tessellate>

Nilai Boolean. Menentukan apakah akan mengizinkan LineString mengikuti medan. Untuk mengaktifkan tessellation, mode ketinggian harus clampToGround atau clampToSeaFloor. LineString yang sangat besar harus mengaktifkan tessellation agar mengikuti kelengkungan bumi (jika tidak, mungkin akan berada di bawah tanah dan tersembunyi).

<altitudeMode>

Menentukan cara komponen height di elemen <ordinats> ditafsirkan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag <koordinat>).
relativeToGround - Menetapkan ketinggian elemen relatif terhadap elevasi permukaan tanah sebenarnya dari lokasi tertentu. Misalnya, jika elevasi permukaan suatu lokasi berada tepat di permukaan laut dan ketinggian suatu titik diatur ke 9 meter, maka elevasi untuk ikon elevasi tanda letak titik adalah 9 meter dengan mode ini. Namun, jika koordinat yang sama ditetapkan di atas lokasi dengan ketinggian tanah 10 meter di atas permukaan laut, maka ketinggian koordinat adalah 19 meter. Penggunaan standar mode ini adalah untuk menempatkan tiang telepon atau lift ski.
absolut - Menetapkan ketinggian koordinat relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian koordinat ke 10 meter dengan mode ketinggian absolut, ikon penanda letak titik akan tampak berada di permukaan tanah jika medan di bawahnya juga 10 meter di atas permukaan laut. Jika medan berada 3 meter di atas permukaan laut, penanda letak akan muncul di atas medan sebesar 7 meter. Penggunaan standar mode ini adalah untuk penempatan pesawat.

<gx:heightMode>

Ekstensi KML, dalam namespace ekstensi Google, memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, <Ketinggian> akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi <height> diabaikan, dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

<gx:drawOrder>

Nilai bilangan bulat yang menentukan urutan gambar beberapa string baris. LineString yang digambar terlebih dahulu mungkin dikaburkan sebagian atau seluruhnya oleh LineStrings dengan urutan gambar lebih akhir. Elemen ini mungkin diperlukan bersamaan dengan elemen <gx:outerColor> dan <gx:outerWidth> di <LineStyle> saat garis dua warna saling bersilangan.

<ordinat>(wajib)

Dua atau beberapa tuple koordinat, masing-masing terdiri dari nilai floating point untuk bujur, lintang, dan ketinggian. Komponen height bersifat opsional. Masukkan spasi di antara tupel. Jangan sertakan spasi dalam tuple.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>LineString.kml</name>
  <open>1</open>
  <LookAt>
    <longitude>-122.36415</longitude>
    <latitude>37.824553</latitude>
    <altitude>0</altitude>
    <range>150</range>
    <tilt>50</tilt>
    <heading>0</heading>
  </LookAt>
  <Placemark>
    <name>unextruded</name>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <coordinates>
        -122.364383,37.824664,0 -122.364152,37.824322,0
      </coordinates>
    </LineString>
  </Placemark>
  <Placemark>
    <name>extruded</name>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <altitudeMode>relativeToGround</altitudeMode>
      <coordinates>
        -122.364167,37.824787,50 -122.363917,37.824423,50
      </coordinates>
    </LineString>
  </Placemark>
</Document>
</kml>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometri>
<Tanda Letak>

<LineStyle>

Sintaksis

<LineStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- colorModeEnum: normal or random -->

  <!-- specific to LineStyle -->
  <width>1</width>                            <!-- float -->
  <gx:outerColor>ffffffff</gx:outerColor>     <!-- kml:color -->
  <gx:outerWidth>0.0</gx:outerWidth>          <!-- float -->
  <gx:physicalWidth>0.0</gx:physicalWidth>    <!-- float -->
  <gx:labelVisibility>0</gx:labelVisibility>  <!-- boolean -->
</LineStyle>

Deskripsi

Menentukan gaya gambar (warna, mode warna, dan lebar garis) untuk semua geometri garis. Geometri garis mencakup garis luar poligon dengan garis batas dan "tether" yang diekstrusi dari ikon Penanda letak (jika ekstrusi diaktifkan).

Elemen Khusus untuk LineStyle

<width>

Lebar garis, dalam piksel.

<gx:outerColor>

Warna bagian garis yang ditentukan oleh <gx:outerWidth>. Perhatikan bahwa elemen <gx:outerColor> dan <gx:outerWidth> diabaikan saat <LineStyle> diterapkan ke <Polygon> dan <LinearRing>.

<gx:outerWidth>

Nilai antara 0,0 hingga 1,0 yang menentukan proporsi garis yang menggunakan <gx:outerColor>. Hanya berlaku untuk baris yang menetapkan lebar dengan <gx:physicalWidth>; tidak berlaku untuk baris yang menggunakan <width>. Lihat juga <gx:drawOrder> di <LineString>. Nilai urutan gambar mungkin diperlukan jika garis dua warna saling bersilangan—misalnya, untuk menunjukkan persimpangan jalan tol.

<gx:physicalWidth>

Lebar fisik garis, dalam meter.

<gx:labelVisibility>

Boolean yang menentukan apakah akan menampilkan label teks pada LineString atau tidak. Label LineString dimuat dalam elemen <name> yang merupakan pasangan <LineString> (yaitu dalam elemen <Placemark> yang sama).

Google Earth versi 6.1+ tidak menampilkan label secara default; dan harus diaktifkan untuk setiap LineString dengan menyetel <gx:labelVisibility> ke 1.

Masalah umum Google Earth 6.1: LineString yang tidak memiliki elemen <gx:physicalWidth> hanya akan menampilkan label jika panjang baris melebihi 100 m * jumlah karakter dalam label. Misalnya, label dengan tujuh karakter ("contoh") hanya akan ditampilkan jika barisnya lebih besar dari 700 m. Hal ini tidak memengaruhi LineString dengan nilai <gx:physicalWidth>.

Contoh

Contoh berikut menunjukkan garis merah buram 50 persen dengan lebar 4 piksel.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>LineStyle.kml</name>
  <open>1</open>
  <Style id="linestyleExample">
    <LineStyle>
      <color>7f0000ff</color>
      <width>4</width>
      <gx:labelVisibility>1</gx:labelVisibility>
    </LineStyle>
  </Style>
  <Placemark>
    <name>LineStyle Example</name>
    <styleUrl>#linestyleExample</styleUrl>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <coordinates>
        -122.364383,37.824664,0 -122.364152,37.824322,0
      </coordinates>
    </LineString>
  </Placemark>
</Document>
</kml>

Memperluas

<WarnaGaya>

Dimuat Oleh

<Gaya>

<Link>

Sintaksis

<Link id="ID">
  <!-- specific to Link -->
  <href>...</href>                      <!-- string -->
  <refreshMode>onChange</refreshMode>
    <!-- refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>  <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>  <!-- float -->
  <viewBoundScale>1</viewBoundScale>    <!-- float -->
  <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]</viewFormat>
                                        <!-- string -->
  <httpQuery>...</httpQuery>            <!-- string -->
</Link>

Deskripsi

<Link> menentukan lokasi salah satu dari hal berikut:

File KML yang diambil oleh link jaringan
File gambar yang digunakan dalam Overlay (elemen <Icon> menentukan gambar dalam Overlay; <Icon> memiliki kolom yang sama dengan <Link>)
File model yang digunakan dalam elemen <Model>

File tersebut dimuat dan diperbarui secara bersyarat, bergantung pada parameter pembaruan yang disediakan di sini. Dua kumpulan parameter refresh yang berbeda dapat ditentukan: satu kumpulan didasarkan pada time (<refreshMode> dan <refreshInterval>) dan satu didasarkan pada view "kamera" saat ini (<viewRefreshMode> dan <viewRefreshTime>). Selain itu, Link menentukan apakah akan menskalakan parameter kotak pembatas yang dikirim ke server (<viewBoundScale> dan menyediakan serangkaian parameter tampilan opsional yang dapat dikirim ke server (serta format yang berisi informasi)

Saat file diambil, URL yang dikirimkan ke server terdiri dari tiga informasi:

href (Referensi Hypertext) yang menentukan file yang akan dimuat.
string format arbitrer yang dibuat dari (a) parameter yang Anda tentukan dalam elemen <viewFormat> atau (b) parameter kotak pembatas (ini merupakan default dan digunakan jika tidak ada elemen <viewFormat> yang disertakan dalam file).
string format kedua yang ditentukan dalam elemen <httpQuery>.

Jika file yang ditentukan dalam <href> adalah file lokal, elemen <viewFormat> dan <httpQuery> tidak akan digunakan.

Elemen <Link> menggantikan elemen <Url> dari <NetworkLink> yang terdapat dalam rilis KML sebelumnya dan menambahkan fungsi untuk elemen <Region> (diperkenalkan dalam KML 2.1). Di Google Earth rilis 3.0 dan versi sebelumnya, elemen <Link> diabaikan.

Elemen Khusus untuk Penautan

<href>

URL (baik alamat HTTP maupun spesifikasi file lokal). Jika induk <Link> adalah NetworkLink, <href> adalah file KML. Jika induk <Link> adalah Model, <href> adalah file COLLADA. Jika induk <Icon> (kolom yang sama dengan <Link>) adalah Overlay, <href> adalah gambar. URL relatif dapat digunakan di tag ini dan dievaluasi relatif terhadap file KML yang disertakan. Lihat File KMZ untuk mengetahui detail tentang membuat referensi relatif dalam file KML dan KMZ.

<refreshMode>

Menentukan mode refresh berbasis waktu, yang dapat berupa salah satu dari hal berikut:

onChange - memuat ulang saat file dimuat dan setiap kali parameter Link berubah (default).
onInterval - muat ulang setiap n detik (ditentukan dalam <refreshInterval>).
onExpire - muat ulang file saat waktu habis masa berlaku tercapai. Jika file yang diambil memiliki NetworkLinkControl, waktu <expires> akan lebih diprioritaskan daripada waktu habis masa berlaku yang ditentukan di header HTTP. Jika waktu <expires> tidak ditentukan, header max-age HTTP akan digunakan (jika ada). Jika max-age tidak ada, header HTTP Expires akan digunakan (jika ada). (Lihat Bagian RFC261b dari Hypertext Transfer Protocol - HTTP 1.1 untuk detail tentang kolom header HTTP.)

<refreshInterval>

Mengindikasikan untuk memuat ulang file setiap n detik.

<viewRefreshMode>

Menentukan cara link dimuat ulang saat "kamera" berubah.

Dapat berupa salah satu opsi berikut:

never (default) - Mengabaikan perubahan dalam tampilan. Selain itu, abaikan parameter <viewFormat>, jika ada.
onStop - Memuat ulang file n detik setelah gerakan berhenti, dan n ditentukan dalam <viewRefreshTime>.
onRequest - Refresh file hanya saat pengguna secara eksplisit memintanya. (Misalnya, di Google Earth, pengguna mengklik kanan dan memilih Refresh di menu Konteks.)
onRegion - Muat ulang file saat Region menjadi aktif. Lihat <Region>.

<viewRefreshTime>

Setelah gerakan kamera berhenti, tentukan jumlah detik untuk menunggu sebelum memuat ulang tampilan. (Lihat <viewRefreshMode> dan onStop di atas.)

<viewBoundScale>

Menskalakan parameter BBOX sebelum mengirimkannya ke server. Nilai kurang dari 1 ditetapkan untuk digunakan kurang dari tampilan penuh (layar). Nilai yang lebih besar dari 1 menentukan untuk mengambil area yang diperluas melampaui tepi tampilan saat ini.

<viewFormat>

Menentukan format string kueri yang ditambahkan ke <href> Link sebelum file diambil.(Jika <href> menentukan file lokal, elemen ini akan diabaikan.)

Jika Anda menentukan <viewRefreshMode> dari onStop dan tidak menyertakan tag <viewFormat> dalam file, informasi berikut akan otomatis ditambahkan ke string kueri:

BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]

Informasi ini sesuai dengan spesifikasi kotak pembatas Web Map Service (WMS).

Jika Anda menentukan tag <viewFormat> kosong, tidak ada informasi yang ditambahkan ke string kueri.

Anda juga dapat menentukan kumpulan parameter tampilan kustom untuk ditambahkan ke string kueri. Jika Anda menyediakan string format, string tersebut akan digunakan sebagai ganti informasi BBOX. Jika Anda juga menginginkan informasi BBOX, Anda perlu menambahkan parameter tersebut bersama dengan parameter kustom.

Anda dapat menggunakan salah satu parameter berikut dalam string format (dan Google Earth akan mengganti nilai saat ini yang sesuai pada saat string string dibuat):

[lookatLon], [lookatLat] - garis bujur dan lintang dari titik yang dilihat <LookAt>
[lookatRange], [lookatTilt], [lookatHeading] - nilai-nilai yang digunakan oleh elemen <LookAt> (lihat deskripsi <range>, <tilt>, dan <heading> pada <LookAt>)
[lookatFieldLon], [lookatFieldLat], [lookatFieldAlt] - titik di medan dalam derajat/meter yang sedang <LookAt> dilihat
[cameraLon], [cameraLat], [cameraAlt] - derajat/meter sudut pandang kamera
[horizFov], [vertFov] - ruang pandang vertikal horizontal untuk kamera
[horizPixels], [vertPixels] - ukuran piksel penampil 3D
[terrainEnabled] - menunjukkan apakah penampil 3D menampilkan medan

<httpQuery>

Menambahkan informasi ke string kueri, berdasarkan parameter yang ditentukan. (Google Earth akan mengganti nilai saat ini yang sesuai pada saat string kueri dibuat.) Parameter berikut didukung:

[clientVersion]
[kmlVersion]
[clientName]
[bahasa]

Contoh

<NetworkLink>
  <name>NE US Radar</name>
  <flyToView>1</flyToView>
  <Link>
    <href>http://www.example.com/geotiff/NE/MergedReflectivityQComposite.kml</href>
    <refreshMode>onInterval</refreshMode>
    <refreshInterval>30</refreshInterval>
    <viewRefreshMode>onStop</viewRefreshMode>
    <viewRefreshTime>7</viewRefreshTime>
    <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth];CAMERA=\
      [lookatLon],[lookatLat],[lookatRange],[lookatTilt],[lookatHeading];VIEW=\
      [horizFov],[vertFov],[horizPixels],[vertPixels],[terrainEnabled]</viewFormat>
  </Link>
</NetworkLink>

<ListStyle>

Sintaksis

<ListStyle id="ID">
  <!-- specific to ListStyle -->
  <listItemType>check</listItemType> <!-- kml:listItemTypeEnum:check,
                                          checkOffOnly,checkHideChildren,
                                         radioFolder -->
  <bgColor>ffffffff</bgColor>        <!-- kml:color -->
  <ItemIcon>                         <!-- 0 or more ItemIcon elements -->
    <state>open</state>
      <!-- kml:itemIconModeEnum:open, closed, error, fetching0, fetching1, or fetching2 -->
    <href>...</href>                 <!-- anyURI -->
  </ItemIcon>
</ListStyle>

Deskripsi

Menentukan bagaimana Fitur ditampilkan dalam tampilan daftar. Tampilan daftar adalah hierarki penampung dan turunan. Di Google Earth, ini adalah panel Tempat.

Elemen Khusus untuk ListStyle

<listItemType>

Menentukan cara fitur ditampilkan dalam tampilan daftar. Nilainya dapat berupa:

check (default) - Visibilitas fitur terikat dengan kotak centang itemnya.
radioFolder - Jika ditentukan untuk Penampung, hanya satu item Penampung yang akan terlihat pada satu waktu
checkOffOnly - Jika ditentukan untuk Penampung atau Link Jaringan, mencegah semua item terlihat sekaligus—yaitu, pengguna dapat menonaktifkan semua item di Penampung atau Network Link, tetapi tidak dapat mengaktifkan semuanya secara bersamaan. Setelan ini berguna untuk Penampung atau Link Jaringan yang berisi data dalam jumlah besar.
checkHideChildren - Gunakan kotak centang normal untuk visibilitas, tetapi jangan tampilkan turunan Penampung atau Network Link di tampilan daftar. Kotak centang memungkinkan pengguna untuk mengalihkan visibilitas objek turunan dalam penampil.

<bgColor>

Warna latar belakang untuk Cuplikan. Nilai warna dan opasitas dinyatakan dalam notasi heksadesimal. Rentang nilai untuk satu warna apa pun adalah 0 hingga 255 (00 hingga ff). Untuk alfa, 00 sepenuhnya transparan dan ff sepenuhnya buram. Urutan ekspresi adalah aabbggrr, dengan aa=alpha (00 sampai ff); bb=blue (00 sampai ff); gg=green (00 sampai ff); rr=red (00 sampai ff). Misalnya, jika ingin menerapkan warna biru dengan opasitas 50 persen ke overlay, Anda akan menentukan hal berikut: <color>7fff0000</color>, dengan alpha=0x7f, blue=0xff, green=0x00, dan red=0x00.

<ItemIcon>

Ikon yang digunakan dalam tampilan Daftar yang mencerminkan status pengambilan Folder atau Link. Ikon yang terkait dengan mode terbuka dan tertutup digunakan untuk Folder dan Network Link. Ikon yang terkait dengan mode error dan fetching0, fetching1, dan fetch22 digunakan untuk Network Link. Screenshot berikut mengilustrasikan ikon Google Earth untuk status ini:

<status>: Menentukan status NetworkLink atau Folder saat ini. Nilai yang mungkin adalah open, closed, error, fetching0, fetching1, dan fetching2. Nilai ini dapat digabungkan dengan menyisipkan spasi di antara dua nilai (tanpa koma).
<href>: Menentukan URI gambar yang digunakan dalam Tampilan Daftar untuk Fitur.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>ListStyle.kml</name>
  <open>1</open>
  <Style id="bgColorExample">
    <ListStyle>
      <bgColor>ff336699</bgColor>
    </ListStyle>
  </Style>
  <Style id="checkHideChildrenExample">
    <ListStyle>
      <listItemType>checkHideChildren</listItemType>
    </ListStyle>
  </Style>
  <Style id="radioFolderExample">
    <ListStyle>
      <listItemType>radioFolder</listItemType>
    </ListStyle>
  </Style>
  <Folder>
    <name>ListStyle Examples</name>
    <open>1</open>
    <Folder>
      <name>bgColor example</name>
      <open>1</open>
      <Placemark>
        <name>pl1</name>
        <Point>
          <coordinates>-122.362815,37.822931,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl2</name>
        <Point>
          <coordinates>-122.362825,37.822931,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl3</name>
        <Point>
          <coordinates>-122.362835,37.822931,0</coordinates>
        </Point>
      </Placemark>
      <styleUrl>#bgColorExample</styleUrl>
    </Folder>
    <Folder>
      <name>checkHideChildren example</name>
      <open>1</open>
      <Placemark>
        <name>pl4</name>
        <Point>
          <coordinates>-122.362845,37.822941,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl5</name>
        <Point>
          <coordinates>-122.362855,37.822941,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl6</name>
        <Point>
          <coordinates>-122.362865,37.822941,0</coordinates>
        </Point>
      </Placemark>
      <styleUrl>#checkHideChildrenExample</styleUrl>
    </Folder>
    <Folder>
      <name>radioFolder example</name>
      <open>1</open>
      <Placemark>
        <name>pl7</name>
        <Point>
          <coordinates>-122.362875,37.822951,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl8</name>
        <Point>
          <coordinates>-122.362885,37.822951,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl9</name>
        <Point>
          <coordinates>-122.362895,37.822951,0</coordinates>
        </Point>
      </Placemark>
      <styleUrl>#radioFolderExample</styleUrl>
    </Folder>
  </Folder>
</Document>
</kml>

Memperluas

<Objek>

Dimuat Oleh

<Gaya>

<LookAt>

Sintaksis

<LookAt id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
    <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to LookAt -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos90 -->
  <range></range>                     <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
          <!--kml:altitudeModeEnum:clampToGround, relativeToGround, absolute -->
          <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->

</LookAt>

Deskripsi

Menentukan kamera virtual yang terkait dengan elemen apa pun yang berasal dari Fitur. Elemen LookAt menempatkan "kamera" dalam kaitannya dengan objek yang sedang dilihat. Di Google Earth, tampilan "terbang ke" sudut pandang LookAt ini saat pengguna mengklik dua kali item di panel Tempat atau mengklik dua kali ikon di penampil 3D.

Elemen Khusus untuk Dilihat

<longitude>

Bujur titik yang dilihat kamera. Jarak sudut dalam derajat, relatif terhadap Prime Meridian. Nilai barat Meridian berkisar dari 180 hingga 0 derajat. Nilai timur Meridian berkisar dari 0 hingga 180 derajat.

<latitude>

Lintang titik yang dilihat kamera. Derajat utara atau selatan Khatulistiwa (0 derajat). Nilainya berkisar dari 90 derajat hingga 90 derajat.

<altitude>

Jarak dari permukaan bumi, dalam meter. Diinterpretasikan berdasarkan mode ketinggian LookAt.

<heading>

Arah (yaitu, Utara, Selatan, Timur, Barat), dalam derajat. Default=0 (Utara). (Lihat diagram di bawah.) Nilai berkisar dari 0 hingga 360 derajat.

<tilt>

Sudut antara arah posisi LookAt dan normal ke permukaan bumi. (Lihat diagram di bawah.) Nilainya berkisar dari 0 hingga 90 derajat. Nilai untuk <tilt> tidak boleh negatif. Nilai <tilt> 0 derajat mengindikasikan bahwa video ditampilkan langsung dari atas. Nilai <tilt> 90 derajat menunjukkan tampilan di sepanjang cakrawala.

<range>(wajib ada)

Jarak dalam meter dari titik yang ditentukan oleh <bujur>, <garis lintang>, dan <ketinggian> ke posisi LookAt. (Lihat diagram di bawah.)

<altitudeMode>

Menentukan cara <height> yang ditentukan untuk titik LookAt ditafsirkan. Nilai yang memungkinkan adalah sebagai berikut:

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi <height> dan menempatkan posisi LookAt di permukaan.
relativeToGround - Menafsirkan <height> sebagai nilai dalam meter di atas permukaan tanah.
absolute - Menafsirkan <height> sebagai nilai dalam meter di atas permukaan laut.

<gx:ElevationMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, <Ketinggian> akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi <height> diabaikan, dan LookAt akan diposisikan di dasar laut. Jika titik berada di darat dan bukan di laut, LookAt akan diposisikan di tanah.

Diagram ini menggambarkan elemen <range>, <tilt>, dan <height>:

Diagram ini menggambarkan elemen <heading>:

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

  <Placemark>
    <name>LookAt.kml</name>
    <LookAt>
      <gx:TimeStamp>
        <when>1994</when>
      </gx:TimeStamp>
      <longitude>-122.363</longitude>
      <latitude>37.81</latitude>
      <altitude>2000</altitude>
      <range>500</range>
      <tilt>45</tilt>
      <heading>0</heading>
      <altitudeMode>relativeToGround</altitudeMode>
    </LookAt>
    <Point>
      <coordinates>-122.363,37.82,0</coordinates>
    </Point>
  </Placemark>
</kml>

Memperluas

<AbstractView>

Dimuat Oleh

Elemen apa pun yang berasal dari <Feature>
<NetworkLinkControl>

<Model>

Sintaksis

<Model id="ID">
  <!-- specific to Model -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround,relativeToGround,or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <Location>
    <longitude></longitude> <!-- kml:angle180 -->
    <latitude></latitude>   <!-- kml:angle90 -->
    <altitude>0</altitude>  <!-- double -->
  </Location>
  <Orientation>
    <heading>0</heading>    <!-- kml:angle360 -->
    <tilt>0</tilt>          <!-- kml:anglepos180 -->
    <roll>0</roll>          <!-- kml:angle180 -->
  </Orientation>
  <Scale>
    <x>1</x>                <!-- double -->
    <y>1</y>                <!-- double -->
    <z>1</z>                <!-- double -->
  </Scale>
  <Link>...</Link>
  <ResourceMap>
    <Alias>
      <targetHref>...</targetHref>   <!-- anyURI -->
      <sourceHref>...</sourceHref>   <!-- anyURI -->
    </Alias>
  </ResourceMap>
</Model>

Deskripsi

Objek 3D yang dijelaskan dalam file COLLADA (direferensikan dalam tag <Link>). File COLLADA memiliki ekstensi file .dae. Model dibuat di ruang koordinatnya sendiri, lalu ditempatkan, diposisikan, dan diskalakan di Google Earth. Lihat halaman "Topik dalam KML" di Model untuk detail selengkapnya.

Google Earth mendukung profil umum COLLADA, dengan pengecualian berikut:

Google Earth hanya mendukung segitiga dan garis sebagai jenis primitif. Jumlah maksimum segitiga yang diizinkan adalah 21845.
Google Earth tidak mendukung animasi atau skinning.
Google Earth tidak mendukung referensi geometri eksternal.

Elemen Khusus untuk Model

<altitudeMode>

Menentukan cara <height> yang ditentukan di <Location> ditafsirkan. Nilai yang memungkinkan adalah sebagai berikut:

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi <height> dan menempatkan Model di permukaan.
relativeToGround - Menafsirkan <height> sebagai nilai dalam meter di atas permukaan tanah.
absolute - Menafsirkan <height> sebagai nilai dalam meter di atas permukaan laut.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, <Ketinggian> akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi <height> diabaikan, dan Model akan diposisikan di dasar laut. Jika titik berada di darat dan bukan di laut, Model akan diposisikan di darat.

<Lokasi>

Menentukan koordinat asal model yang tepat dalam lintang, bujur, dan ketinggian. Pengukuran Lintang dan bujur adalah proyeksi lat-lon standar dengan data WGS84. Ketinggian adalah jarak di atas permukaan bumi, dalam meter, dan ditafsirkan sesuai dengan <heightMode> atau <gx:heightMode>.

<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location>

<Orientation>

Menjelaskan rotasi sistem koordinat model 3D untuk memosisikan objek di Google Earth. Lihat diagram di bawah.

<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation>

Rotasi diterapkan ke Model dalam urutan berikut:

<roll>
<tilt>
<heading>

<heading>: Rotasi tentang sumbu z (normal terhadap permukaan bumi). Nilai 0 (default) sama dengan Utara. Rotasi positif searah jarum jam di sekitar sumbu z dan ditentukan dalam derajat dari 0 hingga 360.
<tilt>: Rotasi sekitar sumbu x. Rotasi positif searah jarum jam di sekitar sumbu x dan ditentukan dalam derajat dari 0 hingga 180.
<roll>: Rotasi tentang sumbu y. Rotasi positif searah jarum jam di sekitar sumbu y dan ditentukan dalam derajat dari 0 hingga 180.; Diagram ini mengilustrasikan orientasi standar sumbu model:

<Skala>

Menskalakan model di sepanjang sumbu x, y, dan z dalam ruang koordinat model.

<Scale>
  <x>2.5</x>
  <y>2.5</y>
  <z>3.5</z>
</Scale>

<Link>

Menentukan file yang akan dimuat dan parameter refresh opsional. Lihat <Link>.

<ResourceMap>

Menentukan 0 atau beberapa elemen <Alias>, yang masing-masing merupakan pemetaan untuk jalur file tekstur dari file Collada asli ke file KML atau KMZ yang berisi Model. Elemen ini memungkinkan Anda memindahkan dan mengganti nama file tekstur tanpa harus memperbarui file Collada asli yang mereferensikan tekstur tersebut. Satu elemen <ResourceMap> dapat berisi beberapa pemetaan dari file Collada yang berbeda (sumber) ke file KMZ yang sama (target).

<Alias>
  <targetHref>../images/foo.jpg</targetHref>
  <sourceHref>c:\mytextures\foo.jpg</sourceHref>
</Alias>

<Alias> berisi pemetaan dari <sourceHref> ke <targetHref>:

<targetHref>: Menentukan file tekstur yang akan diambil oleh Google Earth. Referensi ini dapat berupa referensi relatif ke file gambar dalam arsip .FragmentManager, atau dapat berupa referensi absolut ke file (misalnya, URL).
<sumberHref>: Apakah jalur yang ditentukan untuk file tekstur di file Collada .dae.

Di Google Earth, jika pemetaan ini tidak disediakan, aturan berikut akan digunakan untuk menemukan tekstur yang dirujuk di file Collada (.dae):

Tidak ada jalur: Jika nama tekstur tidak menyertakan jalur, Google Earth akan mencari tekstur di direktori yang sama dengan file .dae yang mereferensikannya.
Jalur relatif: Jika nama tekstur menyertakan jalur relatif (misalnya, ../images/mytexture.jpg), Google Earth menafsirkan jalur tersebut sebagai relatif terhadap file .dae yang mereferensikannya.
Jalur absolut: Jika nama tekstur adalah jalur absolut (c:\mytexture.jpg) atau jalur jaringan (misalnya, http://myserver.com/mytexture.jpg), Google Earth akan mencari file di lokasi yang ditentukan, terlepas dari lokasi file .dae.

Contoh

<Model id="khModel543"> 
  <altitudeMode>relativeToGround</altitudeMode> 
  <Location> 
    <longitude>39.55375305703105</longitude> 
    <latitude>-118.9813220168456</latitude> 
    <altitude>1223</altitude> 
  </Location> 
  <Orientation> 
    <heading>45.0</heading> 
    <tilt>10.0</tilt> 
    <roll>0.0</roll> 
  </Orientation> 
  <Scale> 
    <x>1.0</x> 
    <y>1.0</y> 
    <z>1.0</z> 
  </Scale> 
  <Link> 
    <href>house.dae</href> 
    <refreshMode>once</refreshMode> 
  </Link> 
  <ResourceMap>
    <Alias>
      <targetHref>../files/CU-Macky---Center-StairsnoCulling.jpg</targetHref>
      <sourceHref>CU-Macky---Center-StairsnoCulling.jpg</sourceHref>
    </Alias>
    <Alias>
      <targetHref>../files/CU-Macky-4sideturretnoCulling.jpg</targetHref>
      <sourceHref>CU-Macky-4sideturretnoCulling.jpg</sourceHref>
    </Alias>
    <Alias>
      <targetHref>../files/CU-Macky-Back-NorthnoCulling.jpg</targetHref>
      <sourceHref>CU-Macky-Back-NorthnoCulling.jpg</sourceHref>
    </Alias>
  </ResourceMap>
</Model>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometri>
<Tanda Letak>

<MultiGeometry>

Sintaksis

<MultiGeometry id="ID">
  <!-- specific to MultiGeometry -->
  <!-- 0 or more Geometry elements -->
</MultiGeometry>

Deskripsi

Container untuk nol atau beberapa primitif geometri yang terkait dengan fitur yang sama.

Catatan: Tag <GeometryCollection> tidak digunakan lagi. Sebagai gantinya, gunakan <MultiGeometry>.

Elemen Khusus untuk MultiGeometri

0 atau beberapa elemen <Geometri>

Contoh

<Placemark>
  <name>SF Marina Harbor Master</name>
  <visibility>0</visibility>
  <MultiGeometry>
    <LineString>
      <!-- north wall -->
      <coordinates>
        -122.4425587930444,37.80666418607323,0
        -122.4428379594768,37.80663578323093,0
      </coordinates>
    </LineString>
    <LineString>
      <!-- south wall -->
      <coordinates>
        -122.4425509770566,37.80662588061205,0
        -122.4428340530617,37.8065999493009,0
      </coordinates>
    </LineString>
  </MultiGeometry>
</Placemark>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometri>
<Tanda Letak>

<gx:MultiTrack>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.2 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:MultiTrack id="ID">
  <!-- specific to MultiTrack -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:interpolate>0<gx:interpolate>   <!-- boolean -->
  <gx:Track>...</gx:Track>            <!-- one or more gx:Track elements -->
</gx:MultiTrack>

Deskripsi

Elemen multi-jalur digunakan untuk menggabungkan beberapa elemen trek menjadi satu unit konseptual. Misalnya, Anda mengumpulkan data GPS untuk satu hari bersepeda yang mencakup beberapa perhentian dan perhentian untuk makan siang. Karena gangguan waktu, satu wahana sepeda mungkin muncul sebagai empat jalur yang berbeda ketika waktu dan posisi dipetakan. Mengelompokkan elemen <gx:Track> ini ke dalam satu container <gx:MultiTrack> akan membuatnya ditampilkan di Google Earth sebagai bagian dari satu jalur. Saat mencapai akhir satu segmen, ikon akan bergerak ke awal segmen berikutnya. Elemen <gx:interpolate> menentukan apakah akan berhenti di akhir satu trek dan langsung melompat ke awal trek berikutnya, atau menginterpolasikan nilai yang tidak ada di antara kedua trek tersebut.

Elemen Khusus untuk gx:MultiTrack

Menentukan cara komponen height di elemen <ordinats> ditafsirkan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di elemen <gx:coord>).
relativeToGround - Menetapkan ketinggian elemen relatif terhadap elevasi permukaan tanah sebenarnya dari lokasi tertentu. Misalnya, jika elevasi permukaan suatu lokasi berada tepat di permukaan laut dan ketinggian suatu titik diatur ke 9 meter, maka elevasi untuk ikon elevasi tanda letak titik adalah 9 meter dengan mode ini. Namun, jika koordinat yang sama ditetapkan di atas lokasi dengan ketinggian tanah 10 meter di atas permukaan laut, maka ketinggian koordinat adalah 19 meter.
absolut - Menetapkan ketinggian koordinat relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian koordinat ke 10 meter dengan mode ketinggian absolut, ikon penanda letak titik akan tampak berada di permukaan tanah jika medan di bawahnya juga 10 meter di atas permukaan laut. Jika medan berada 3 meter di atas permukaan laut, penanda letak akan muncul di atas medan sebesar 7 meter.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan ketinggian sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, ketinggian akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi ketinggian akan diabaikan dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

<gx:interpolate>

Nilai Boolean. Jika multi-jalur berisi beberapa elemen <gx:Track>, menentukan apakah akan menginterpolasikan nilai yang tidak ada antara akhir trek pertama dan awal trek berikutnya. Saat nilai default (0) digunakan, ikon atau model berhenti di akhir satu lagu, lalu melompat ke awal lagu berikutnya.

Berisi

<gx:Pelacakan>

<NetworkLink>

Sintaksis

<NetworkLink id="ID">
  <!-- inherited from Feature element --><name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
   <atom:link href=" "/>               <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- specific to NetworkLink -->
  <refreshVisibility>0</refreshVisibility> <!-- boolean -->
  <flyToView>0</flyToView>                 <!-- boolean -->
  <Link>...</Link>
</NetworkLink>

Deskripsi

Mereferensikan file KML atau arsip KMZ pada jaringan lokal atau jarak jauh. Gunakan elemen <Link> untuk menentukan lokasi file KML. Dalam elemen tersebut, Anda dapat menentukan opsi pembaruan untuk memperbarui file, berdasarkan waktu dan perubahan kamera. NetworkLinks dapat digunakan bersama dengan Region untuk menangani set data yang sangat besar secara efisien.

Elemen Khusus untuk NetworkLink

<muat ulangVisibilitas>: Nilai Boolean. Nilai 0 memberikan visibilitas fitur dalam kontrol pengguna Google Earth. Tetapkan nilai ke 1 untuk mereset visibilitas fitur setiap kali NetworkLink dimuat ulang. Misalnya, Penanda Letak dalam file KML yang ditautkan memiliki <visibilitas> yang ditetapkan ke 1 dan NetworkLink memiliki <refreshVisibility> yang ditetapkan ke 1. Saat file pertama kali dimuat ke Google Earth, pengguna dapat menghapus kotak centang di samping item untuk menonaktifkan tampilan di penampil 3D. Namun, saat NetworkLink dimuat ulang, Penanda Letak akan terlihat lagi, karena status visibilitas aslinya adalah TRUE.
<flyToView>: Nilai Boolean. Nilai 1 menyebabkan Google Earth terbang ke tampilan LookAt atau Kamera di NetworkLinkControl (jika ada). Jika NetworkLinkControl tidak berisi elemen AbstractView, Google Earth akan terbang ke elemen LookAt atau Camera di turunan Fitur dalam elemen <kml> dalam file yang dimuat ulang. Jika elemen <kml> tidak memiliki LookAt atau Kamera yang ditentukan, tampilannya tidak akan berubah. Misalnya, Google Earth akan terbang ke tampilan <LookAt> Dokumen induk, bukan <LookAt> Penanda yang terdapat dalam Dokumen.
<Link>(wajib diisi)

Contoh

<Document>
  <visibility>1</visibility>
  <NetworkLink>
    <name>NE US Radar</name>
    <refreshVisibility>1</refreshVisibility>
    <flyToView>1</flyToView>
    <Link>...</Link></NetworkLink>
</Document>

Memperluas

<Fitur>

Dimuat Oleh

elemen apa pun yang berasal dari <Container>

<NetworkLinkControl>

Sintaksis

<NetworkLinkControl>
  <minRefreshPeriod>0</minRefreshPeriod>           <!-- float -->
  <maxSessionLength>-1</maxSessionLength>          <!-- float --> 
  <cookie>...</cookie>                             <!-- string -->
  <message>...</message>                           <!-- string -->
  <linkName>...</linkName>                         <!-- string -->
  <linkDescription>...</linkDescription>           <!-- string -->
  <linkSnippet maxLines="2">...</linkSnippet>      <!-- string -->
  <expires>...</expires>                           <!-- kml:dateTime -->
  <Update>...</Update>                             <!-- Change,Create,Delete -->
  <AbstractView>...</AbstractView>                 <!-- LookAt or Camera -->
</NetworkLinkControl>

Deskripsi

Mengontrol perilaku file yang diambil oleh <NetworkLink>.

Elemen Khusus untuk NetworkLinkControl

<MinRefreshPeriod>: Ditentukan dalam detik, <minRefreshPeriod> adalah waktu minimum yang diizinkan di antara pengambilan file. Dengan parameter ini, server dapat membatasi pengambilan file tertentu dan menyesuaikan kecepatan refresh dengan perkiraan perubahan data. Misalnya, pengguna mungkin menetapkan jumlah pembaruan link menjadi 5 detik, tetapi Anda dapat menetapkan periode pembaruan minimum menjadi 3600 untuk membatasi update pembaruan menjadi sekali setiap jam.
<maxSessionLength>: Ditentukan dalam detik, <maxSessionLength> adalah jumlah waktu maksimum bagi NetworkLink klien untuk dapat tetap terhubung. Nilai default -1 menunjukkan untuk tidak menghentikan sesi secara eksplisit.
<cookie>: Gunakan elemen ini untuk menambahkan string ke kueri URL pada pemuatan ulang link jaringan berikutnya. Anda dapat menggunakan data ini di skrip untuk memberikan penanganan yang lebih cerdas di sisi server, termasuk pembuatan kueri versi dan pengiriman file bersyarat.
<message>: Anda dapat mengirimkan pesan pop-up, seperti panduan penggunaan untuk link jaringan. Pesan ini muncul ketika tautan jaringan pertama kali dimuat ke Google Earth, atau saat diubah dalam kontrol tautan jaringan.
<linkName>: Anda dapat mengontrol nama link jaringan dari server, sehingga perubahan yang dibuat pada nama di sisi klien akan diganti oleh server.
<linkDescription>: Anda dapat mengontrol deskripsi link jaringan dari server, sehingga perubahan yang dibuat pada deskripsi di sisi klien akan diganti oleh server.
<linkCuplikan maxLines="2">: Anda dapat mengontrol cuplikan untuk link jaringan dari server, sehingga perubahan yang dibuat pada cuplikan di sisi klien akan diganti oleh server. <linkCuplikan> memiliki atribut maxLines, bilangan bulat yang menentukan jumlah baris maksimum yang akan ditampilkan.
<expires>: Anda dapat menentukan tanggal/waktu untuk memperbarui link. Spesifikasi ini hanya berlaku jika <refreshMode> di <Link> memiliki nilai onExpire. Lihat <refreshMode>
<Update>: Dengan <Update>, Anda dapat menentukan sejumlah tag Ubah, Buat, dan Hapus untuk file .kml atau arsip .ASPMX yang sebelumnya telah dimuat dengan link jaringan. Lihat <Update>.
<AbstractView>

Contoh

<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLinkControl>
   <message>This is a pop-up message. You will only see this once</message>
   <cookie>cookie=sometext</cookie>
   <linkName>New KML features</linkName>
   <linkDescription><![CDATA[KML now has new features available!]]></linkDescription>
</NetworkLinkControl>
</kml>

Memperluas

Ini adalah turunan langsung dari elemen <kml>.

Dimuat Oleh

<kml>

Lihat Juga

<Pembaruan>
<NetworkLink>

<Objek>

Sintaksis

<!-- abstract element; do not create -->
<!-- Object id="ID" targetId="NCName" -->
<!-- /Object> -->

Deskripsi

Ini adalah class dasar abstrak dan tidak dapat digunakan langsung di file KML. Atribut ini memberikan atribut id, yang memungkinkan identifikasi unik elemen KML, dan atribut targetId, yang digunakan untuk mereferensikan objek yang telah dimuat ke Google Earth. Atribut id harus ditetapkan jika mekanisme <Update> akan digunakan.

<Overlay>

Sintaksis

<!-- abstract element; do not create -->
<!-- Overlay id="ID" -->                    <!-- GroundOverlay,ScreenOverlay -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- specific to Overlay -->
  <color>ffffffff</color>                   <!-- kml:color -->
  <drawOrder>0</drawOrder>                  <!-- int -->
  <Icon>
    <href>...</href>
  </Icon>
<!-- /Overlay -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. <Overlay> adalah jenis dasar untuk overlay gambar yang digambar di permukaan planet atau di layar. <Icon> menentukan gambar yang akan digunakan dan dapat dikonfigurasi untuk memuat ulang gambar berdasarkan timer atau perubahan kamera. Elemen ini juga mencakup spesifikasi untuk menumpuk beberapa overlay dan menambahkan nilai warna dan transparansi ke gambar dasar.

Elemen Khusus untuk Overlay

<color>

Nilai warna dinyatakan dalam notasi heksadesimal, termasuk nilai opasitas (alfa). Urutan ekspresi adalah alfa, biru, hijau, merah (aabbggrr). Rentang nilai untuk satu warna apa pun adalah 0 hingga 255 (00 hingga ff). Untuk opasitas, 00 sepenuhnya transparan dan ff sepenuhnya buram. Misalnya, jika ingin menerapkan warna biru dengan opasitas 50 persen ke overlay, Anda akan menentukan hal berikut: <color>7fff0000</color>

Catatan: Elemen <geomColor> tidak digunakan lagi. Gunakan <color> sebagai gantinya.

<drawOrder>

Elemen ini menentukan urutan tumpukan untuk gambar dalam overlay yang tumpang tindih. Overlay dengan nilai <drawOrder> yang lebih tinggi digambar di atas overlay dengan nilai <drawOrder> yang lebih rendah.

<Icon>

Menentukan gambar yang terkait dengan Overlay. Elemen <href> menentukan lokasi gambar yang akan digunakan sebagai Overlay. Lokasi ini dapat berada di sistem file lokal atau di server web. Jika elemen ini dihilangkan atau tidak berisi <href>, persegi panjang akan digambar menggunakan warna dan ukuran yang ditentukan oleh overlay bumi atau layar.

<Icon>
   <href>icon.jpg</href>
</Icon>

Memperluas

<Fitur>

Diperluas Oleh

<GroundOverlay>
<FotoOverlay>
<ScreenOverlay>

<FotoOverlay>

Sintaksis

<PhotoOverlay>
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- inherited from Overlay element -->
  <color>ffffffff</color>               <!-- kml:color -->
  <drawOrder>0</drawOrder>              <!-- int -->
  <Icon>
    <href>...</href>                    <!-- anyURI -->
    ...
  </Icon>

  <!-- specific to PhotoOverlay -->
  <rotation>0</rotation>                <!-- kml:angle180 -->
  <ViewVolume>
    <leftFov>0</leftFov>                <!-- kml:angle180 -->
    <rightFov>0</rightFov>              <!-- kml:angle180 -->
    <bottomFov>0</bottomFov>            <!-- kml:angle90 -->
    <topFov>0</topFov>                  <!-- kml:angle90 -->
    <near>0</near>                      <!-- double -->
  </ViewVolume>
  <ImagePyramid>
    <tileSize>256</tileSize>            <!-- int -->
    <maxWidth>...</maxWidth>            <!-- int -->
    <maxHeight>...</maxHeight>          <!-- int -->
    <gridOrigin>lowerLeft</gridOrigin> <!-- lowerLeft or upperLeft -->
  </ImagePyramid>
  <Point>
    <coordinates>...</coordinates>      <!-- lon,lat[,alt] -->
  </Point>
  <shape>rectangle</shape>               <!-- kml:shape -->
</PhotoOverlay>

Deskripsi

Elemen <PhotoOverlay> memungkinkan Anda menemukan lokasi geografis di bumi dan menentukan parameter tampilan untuk PhotoOverlay ini. PhotoOverlay dapat berupa persegi panjang 2D sederhana, silinder parsial atau penuh, atau bola (untuk panorama sferikal). Overlay ditempatkan di lokasi yang ditentukan dan diorientasikan ke sudut pandang.

Karena <FotoOverlay> berasal dari <Feature>, elemen ini dapat berisi salah satu dari dua elemen yang berasal dari <AbstractView>—baik <Camera> atau <LookAt>. Camera (atau LookAt) menentukan sudut pandang dan arah tampilan (juga disebut sebagai vektor tampilan). PhotoOverlay diposisikan dalam kaitannya dengan sudut pandang. Secara khusus, bidang gambar persegi panjang 2D bersifat ortogonal (pada sudut siku-siku terhadap) vektor tampilan. Normal bidang ini—yaitu bagian depannya, yang merupakan bagian dari foto—berorientasi menuju sudut pandang.

URL untuk gambar PhotoOverlay ditentukan dalam tag <Icon>, yang diwarisi dari <Overlay>. Tag <Icon> harus berisi elemen <href> yang menentukan file gambar yang akan digunakan untuk PhotoOverlay. Untuk gambar berukuran sangat besar, <href> adalah URL khusus yang diindeks menjadi piramida dari berbagai gambar dengan resolusi (lihat ImagePyramid).

Untuk informasi selengkapnya, lihat halaman "Topik di KML" di OverlayOverlay.

Elemen Khusus untuk PhotoOverlay

<rotation>

Menyesuaikan cara foto ditempatkan di dalam ruang pandang. Elemen ini berguna jika foto Anda telah diputar dan sedikit menyimpang dari tampilan horizontal yang diinginkan.

<ViewVolume>

Menentukan seberapa banyak bagian dari scene saat ini yang terlihat. Menentukan kolom pandang serupa dengan menentukan cara membuka lensa di kamera fisik. Ruang pandang kecil, seperti lensa telefoto, berfokus pada sebagian kecil tampilan. Ruang pandang yang besar, seperti lensa sudut lebar, berfokus pada sebagian besar tampilan.

<leftFov>: Sudut, dalam derajat, antara arah kamera dan sisi kiri volume tampilan.
<rightFov>: Sudut, dalam derajat, antara arah kamera dan sisi kanan volume tampilan.
<bottomFov>: Sudut, dalam derajat, antara arah kamera dan sisi bawah volume tampilan.
<topFov>: Sudut, dalam derajat, antara arah kamera dan sisi atas volume tampilan.
<near>: Pengukuran dalam meter di sepanjang arah tampilan dari sudut pandang kamera ke bentuk PhotoOverlay.

Ruang pandang untuk PhotoOverlay ditentukan oleh empat bidang, yang masing-masing ditentukan oleh sudut relatif terhadap vektor tampilan. Keempat bidang ini menentukan sisi atas, bawah, kiri, dan kanan ruang pandang, yang berbentuk piramida yang terpotong, seperti yang ditampilkan di sini:

Diagram berikut menunjukkan empat sudut pandang dalam piramida ini:

<ImagePyramid>

Untuk gambar dengan ukuran yang sangat besar, Anda harus membuat piramida gambar, yang merupakan serangkaian hierarki dari gambar, yang masing-masing merupakan versi resolusi asli dari gambar yang lebih rendah. Setiap gambar dalam piramida dibagi lagi menjadi ubin, sehingga hanya bagian tampilan yang perlu dimuat. Google Earth menghitung sudut pandang saat ini dan memuat ubin yang sesuai dengan jarak pengguna dari gambar. Saat titik pandang bergerak lebih dekat ke PhotoOverlay, Google Earth akan memuat ubin dengan resolusi yang lebih tinggi. Karena semua piksel dalam gambar asli tidak dapat dilihat sekaligus di layar, pra-pemrosesan ini memungkinkan Google Earth mencapai performa maksimum karena hanya memuat bagian gambar yang terlihat, dan hanya detail piksel yang dapat dilihat oleh pengguna pada sudut pandang saat ini.

Saat menentukan piramida gambar, Anda juga memodifikasi <href> dalam elemen <Icon> untuk menyertakan spesifikasi ubin mana yang akan dimuat.

<tileSize>: Ukuran ubin, dalam piksel. Ubin harus berbentuk persegi, dan <tileSize> harus pangkat 2. Ukuran ubin 256 (default) atau 512 disarankan. Gambar asli akan dibagi menjadi ubin dengan ukuran ini, pada berbagai resolusi.
<maxWidth>: Lebar piksel gambar asli.
<maxHeight>: Tinggi piksel gambar asli.
<gridOrigin>: Menentukan tempat untuk memulai penomoran kotak di setiap lapisan piramida. Nilai lowerLeft menentukan bahwa baris 1, kolom 1 dari setiap lapisan ada di sudut kiri bawah petak.

<Titik>

Elemen <Point> berfungsi sebagai <Point> di dalam elemen <Penanda Letak>. Gambar ikon untuk menandai posisi PhotoOverlay. Ikon yang digambar ditentukan oleh kolom <styleUrl> dan <StyleSelector>, seperti pada <Penanda Letak>.

<shape>

PhotoOverlay diproyeksikan ke <bentuk>. <Shape> dapat berupa salah satu dari berikut ini:

persegi panjang (default) - untuk foto biasa

silinder - untuk panorama, yang bisa berupa silinder parsial atau penuh

sphere - untuk panorama sferikal

Contoh

<PhotoOverlay>
  <!-- Feature elements -->
  <name>A simple non-pyramidal photo</name>
  <description>High above the ocean</description>
  <!-- Overlay elements -->
  <Icon>
  <!-- A simple normal jpeg image -->
  <href>small-photo.jpg</href>
  </Icon>
  <!-- PhotoOverlay elements -->
  <!-- default: <rotation> default is 0 -->
  <ViewVolume>
    <near>1000</near>
    <leftFov>-60</leftFov>
    <rightFov>60</rightFov>
    <bottomFov>-45</bottomFov>
    <topFov>45</topFov>
  </ViewVolume>
  <!-- if no ImagePyramid only level 0 is shown,
       fine for a non-pyramidal image -->
  <Point>
    <coordinates>1,1</coordinates>
  </Point>
  <!-- default: <shape> -->
</PhotoOverlay>

Memperluas

<Overlay>

Dimuat Oleh

<Folder>, <Document>, atau <kml>

<Placemark>

Sintaksis

<Placemark id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- specific to Placemark element -->
  <Geometry>...</Geometry>
</Placemark>

Deskripsi

Penanda Letak adalah Fitur dengan Geometri terkait. Di Google Earth, Penanda Letak muncul sebagai item daftar di panel Tempat. Penanda Letak dengan Titik memiliki ikon yang terkait dengannya yang menandai titik di Bumi dalam penampil 3D. (Di penampil 3D Google Earth, Penanda Letak Titik adalah satu-satunya objek yang dapat Anda klik atau gerakkan. Objek Geometri lainnya tidak memiliki ikon di penampil 3D. Agar pengguna mengklik sesuatu di penampil 3D, Anda perlu membuat objek MultiGeometri yang berisi Titik dan objek Geometri lainnya.)

Elemen Khusus untuk Penanda Letak

0 atau satu elemen <Geometri>

Contoh

<Placemark>
  <name>Google Earth - New Placemark</name>
  <description>Some Descriptive text.</description>
  <LookAt>
    <longitude>-90.86879847669974</longitude>
    <latitude>48.25330383601299</latitude>
    <range>440.8</range>
    <tilt>8.3</tilt>
    <heading>2.7</heading>
  </LookAt>
  <Point>
    <coordinates>-90.86948943473118,48.25450093195546,0</coordinates>
  </Point>
</Placemark>

Memperluas

<Fitur>

Dimuat Oleh

<Dokumen>
<Folder>

Lihat Juga

<Ikon>

<Point>

Sintaksis

<Point id="ID">
  <!-- specific to Point -->
  <extrude>0</extrude>                        <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>              <!-- lon,lat[,alt] -->
</Point>

Deskripsi

Lokasi geografis yang ditentukan oleh bujur, lintang, dan ketinggian (opsional). Jika Titik dimuat oleh Penanda Letak, titik itu sendiri menentukan posisi nama dan ikon Penanda Letak. Saat Titik diekstrusi, titik tersebut terhubung ke tanah dengan garis. "Tethering" ini menggunakan LineStyle saat ini.

Elemen Khusus untuk Titik

<extrude>

Nilai Boolean. Menentukan apakah menghubungkan titik ke tanah dengan garis. Untuk memberikan Titik, nilai untuk <ElevationMode> harus berupa relativeToGround, relativeToSeaFloor, atau absolute. Titik diekstrusi menuju pusat bola Bumi.

<altitudeMode>

Menentukan cara komponen height di elemen <ordinats> ditafsirkan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag <koordinat>).
relativeToGround - Menetapkan ketinggian elemen relatif terhadap elevasi permukaan tanah sebenarnya dari lokasi tertentu. Misalnya, jika elevasi permukaan suatu lokasi berada tepat di permukaan laut dan ketinggian suatu titik diatur ke 9 meter, maka elevasi untuk ikon elevasi tanda letak titik adalah 9 meter dengan mode ini. Namun, jika koordinat yang sama ditetapkan di atas lokasi dengan ketinggian tanah 10 meter di atas permukaan laut, maka ketinggian koordinat adalah 19 meter. Penggunaan standar mode ini adalah untuk menempatkan tiang telepon atau lift ski.
absolut - Menetapkan ketinggian koordinat relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian koordinat ke 10 meter dengan mode ketinggian absolut, ikon penanda letak titik akan tampak berada di permukaan tanah jika medan di bawahnya juga 10 meter di atas permukaan laut. Jika medan berada 3 meter di atas permukaan laut, penanda letak akan muncul di atas medan sebesar 7 meter. Penggunaan standar mode ini adalah untuk penempatan pesawat.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan ketinggian sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, ketinggian akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi ketinggian akan diabaikan dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

<ordinat>(wajib)

tuple tunggal yang terdiri dari nilai floating point untuk garis bujur, lintang, dan ketinggian (dalam urutan tersebut). Nilai bujur dan lintang dalam derajat, dengan

bujur ≥ 180 dan <= 180
garis lintang ≥ 90 dan ≤ 90
Nilai height (opsional) dalam meter di atas permukaan laut

Jangan sertakan spasi di antara tiga nilai yang mendeskripsikan koordinat.

Contoh

<Point>
  <coordinates>-90.86948943473118,48.25450093195546</coordinates>
</Point>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometri>
<Tanda Letak>

<Polygon>

Sintaksis

<Polygon id="ID">
  <!-- specific to Polygon -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <outerBoundaryIs>
    <LinearRing>
      <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
    </LinearRing>
  </outerBoundaryIs>
  <innerBoundaryIs>
    <LinearRing>
      <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
    </LinearRing>
  </innerBoundaryIs>
</Polygon>

Deskripsi

Poligon ditentukan oleh batas luar dan 0 atau lebih batas dalam. Batasannya, pada akhirnya, ditentukan oleh LinearRings. Ketika Poligon diekstrusi, batas-batasnya terhubung dengan tanah untuk membentuk poligon tambahan, sehingga memberikan tampilan bangunan atau kotak. Poligon yang Diekstrusi menggunakan <PolyStyle> untuk warna, mode warna, dan isian.

<koordinat> untuk poligon harus ditentukan dengan urutan berlawanan arah jarum jam. Poligon mengikuti "aturan kanan", yang menyatakan bahwa jika Anda meletakkan jari-jari pada tangan kanan ke arah yang ditentukan oleh koordinat, ibu jari akan menunjuk ke arah umum normal geometris untuk poligon. (Pada grafik 3D, normal geometris digunakan untuk pencahayaan dan titik jauh dari tampilan depan poligon.) Karena Google Earth hanya mengisi tampilan depan poligon, Anda akan mendapatkan efek yang diinginkan hanya ketika koordinat ditetapkan dengan urutan yang benar. Jika tidak, poligon akan berwarna abu-abu.

Elemen Khusus untuk Poligon

<extrude>

Nilai Boolean. Menentukan apakah akan menghubungkan Poligon ke tanah. Untuk membuat bentuk Polygon, mode ketinggian harus bersifat relativeToGround, relativeToSeaFloor, atau absolute. Hanya verteks yang diekstrusi, bukan geometri itu sendiri (misalnya, persegi panjang berubah menjadi kotak dengan lima wajah. Verteks poligon diekstrusi menuju pusat bola bumi.

<tessellate>

Kolom ini tidak digunakan oleh Polygon. Untuk mengizinkan Poligon mengikuti medan (yaitu, untuk mengaktifkan tessellation) tentukan mode ketinggian clampToGround atau clampToSeaFloor.

<altitudeMode>

Menentukan cara komponen height di elemen <ordinats> ditafsirkan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag <koordinat>).
relativeToGround - Menetapkan ketinggian elemen relatif terhadap elevasi permukaan tanah sebenarnya dari lokasi tertentu. Misalnya, jika elevasi permukaan suatu lokasi berada tepat di permukaan laut dan ketinggian suatu titik diatur ke 9 meter, maka elevasi untuk ikon elevasi tanda letak titik adalah 9 meter dengan mode ini. Namun, jika koordinat yang sama ditetapkan di atas lokasi dengan ketinggian tanah 10 meter di atas permukaan laut, maka ketinggian koordinat adalah 19 meter. Penggunaan standar mode ini adalah untuk menempatkan tiang telepon atau lift ski.
absolut - Menetapkan ketinggian koordinat relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian koordinat ke 10 meter dengan mode ketinggian absolut, ikon penanda letak titik akan tampak berada di permukaan tanah jika medan di bawahnya juga 10 meter di atas permukaan laut. Jika medan berada 3 meter di atas permukaan laut, penanda letak akan muncul di atas medan sebesar 7 meter. Penggunaan standar mode ini adalah untuk penempatan pesawat.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan <height> sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, ketinggian akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi ketinggian akan diabaikan dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

<outerBoundaryIs>(wajib)

Berisi elemen <LinearRing>.

<innerBoundaryIs>

Berisi elemen <LinearRing>. Poligon dapat berisi beberapa elemen <innerBoundaryIs>, yang membuat beberapa potongan di dalam Poligon.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>Polygon.kml</name>
  <open>0</open>
  <Placemark>
    <name>hollow box</name>
    <Polygon>
      <extrude>1</extrude>
      <altitudeMode>relativeToGround</altitudeMode>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.366278,37.818844,30
            -122.365248,37.819267,30
            -122.365640,37.819861,30
            -122.366669,37.819429,30
            -122.366278,37.818844,30
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
      <innerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.366212,37.818977,30
            -122.365424,37.819294,30
            -122.365704,37.819731,30
            -122.366488,37.819402,30
            -122.366212,37.818977,30
          </coordinates>
        </LinearRing>
      </innerBoundaryIs>
    </Polygon>
  </Placemark>
</Document>
</kml>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometri>
<Tanda Letak>

<PolyStyle>

Sintaksis

<PolyStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to PolyStyle -->
  <fill>1</fill>                     <!-- boolean -->
  <outline>1</outline>               <!-- boolean -->
</PolyStyle>

Deskripsi

Menentukan gaya gambar untuk semua poligon, termasuk ekstrusi poligon (yang terlihat seperti dinding bangunan) dan ekstrusi garis (yang terlihat seperti pagar padat).

Elemen Khusus untuk PolyStyle

<fill>: Nilai Boolean. Menentukan apakah akan mengisi poligon.
<outline>: Nilai Boolean. Menetapkan apakah akan menggarisbawahi poligon atau tidak. Garis luar poligon menggunakan LineStyle saat ini.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>PolygonStyle.kml</name>
  <open>1</open>
  <Style id="examplePolyStyle">
    <PolyStyle>
      <color>ff0000cc</color>
      <colorMode>random</colorMode>
    </PolyStyle>
  </Style>
  <Placemark>
    <name>hollow box</name>
    <styleUrl>#examplePolyStyle</styleUrl>
    <Polygon>
      <extrude>1</extrude>
      <altitudeMode>relativeToGround</altitudeMode>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.3662784465226,37.81884427772081,30
            -122.3652480684771,37.81926777010555,30
            -122.365640222455,37.81986126286519,30
            -122.36666937925,37.81942987753481,30
            -122.3662784465226,37.81884427772081,30
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
      <innerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.366212593918,37.81897719083808,30
            -122.3654241733188,37.81929450992014,30
            -122.3657048517827,37.81973175302663,30
            -122.3664882465854,37.81940249291773,30
            -122.366212593918,37.81897719083808,30
          </coordinates>
        </LinearRing>
      </innerBoundaryIs>
    </Polygon>
  </Placemark>
</Document>
</kml>

Memperluas

<WarnaGaya>

Dimuat Oleh

<Gaya>

<Region>

Sintaksis

<Region id="ID"> 
  <LatLonAltBox>
    <north></north>                            <!-- required; kml:angle90 -->
    <south></south>                            <!-- required; kml:angle90 -->
    <east></east>                              <!-- required; kml:angle180 -->
    <west></west>                              <!-- required; kml:angle180 -->
    <minAltitude>0</minAltitude>               <!-- float -->
    <maxAltitude>0</maxAltitude>               <!-- float -->
    <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  </LatLonAltBox>
  <Lod>
    <minLodPixels>0</minLodPixels>             <!-- float -->
    <maxLodPixels>-1</maxLodPixels>            <!-- float -->
    <minFadeExtent>0</minFadeExtent>           <!-- float -->
    <maxFadeExtent>0</maxFadeExtent>           <!-- float -->
  </Lod>
</Region>

Deskripsi

Sebuah wilayah berisi kotak pembatas (<LatLonAltBox>) yang mendeskripsikan area minat yang ditentukan oleh koordinat dan ketinggian geografis. Selain itu, Region berisi tingkat LOD (level detail) (<Lod>) yang menentukan rentang validitas Region terkait dalam hal ukuran layar yang diproyeksikan. Region disebut "aktif" jika kotak pembatas berada dalam tampilan pengguna dan persyaratan LOD terpenuhi. Objek yang terkait dengan Region hanya digambar saat Region aktif. Jika <viewRefreshMode> adalah onRegion, Link atau Ikon akan dimuat hanya jika Region aktif. Lihat halaman "Topik dalam KML" di Wilayah untuk mengetahui detail selengkapnya. Dalam hierarki Container atau NetworkLink, penghitungan ini menggunakan Region yang merupakan ancestor terdekat dalam hierarki.

Elemen Khusus untuk Region

<LatLonAltBox>(wajib ada)

Kotak pembatas yang mendeskripsikan area minat yang ditentukan oleh koordinat dan ketinggian geografis. Nilai default dan kolom wajib diisi adalah sebagai berikut:

<heightMode> atau <gx:heightMode>: Nilai yang mungkin untuk <heightMode> adalah clampToGround, relativeToGround, dan absolute. Nilai yang mungkin untuk <gx:heightMode> adalah clampToSeaFloor dan relativeToSeaFloor. Lihat juga <LatLonBox>.
<minAltitude>: Ditentukan dalam meter (dan dipengaruhi oleh spesifikasi mode ketinggian).
<maxAltitude>: Ditentukan dalam meter (dan dipengaruhi oleh spesifikasi mode ketinggian).
<north> (wajib diisi): Menentukan garis lintang tepi utara kotak pembatas, dalam derajat desimal dari 0 hingga ±90.
<south> (wajib): Menentukan garis lintang tepi selatan kotak pembatas, dalam derajat desimal dari 0 hingga ±90.
<east> (wajib diisi)
: Menentukan bujur tepi timur kotak pembatas dalam derajat desimal dari 0 hingga ±180.
<west> (wajib diisi): Menentukan bujur tepi barat kotak pembatas, dalam derajat desimal dari 0 hingga ±180.

<LatLonAltBox>
  <north>43.374</north>
  <south>42.983</south>
  <east>-0.335</east>
  <west>-1.423</west>
  <minAltitude>0</minAltitude>
  <maxAltitude>0</maxAltitude>
</LatLonAltBox>

<Lod>

Lod adalah singkatan dari Level of Detail. <Lod> menjelaskan ukuran area yang diproyeksikan pada layar yang diperlukan agar wilayah dianggap "aktif". Juga menentukan ukuran ramp piksel yang digunakan untuk memudar (dari transparan ke buram) dan memudar (dari buram ke transparan). Lihat diagram di bawah untuk representasi visual parameter ini.

<Lod>
  <minLodPixels>256</minLodPixels>
  <maxLodPixels>-1</maxLodPixels>
  <minFadeExtent>0</minFadeExtent>
  <maxFadeExtent>0</maxFadeExtent>
</Lod>

<minLodPixels> (wajib ada)

Menentukan persegi dalam ruang layar, dengan sisi nilai yang ditentukan dalam piksel. Misalnya, 128 menentukan persegi dengan ukuran 128 x 128 piksel. Kotak pembatas wilayah harus lebih besar dari persegi ini (dan lebih kecil dari kotak maxLodPixels) agar Region aktif.

Detail selengkapnya tersedia di bab Bekerja dengan Region dalam Panduan Developer, serta tutorial Menghindari Kelebihan Beban dengan Region dalam dokumentasi Google Earth Outreach.

<maxLodPixels>

Pengukuran dalam piksel layar yang mewakili batas maksimum rentang visibilitas untuk Wilayah tertentu. Nilai 1, default, menunjukkan "aktif hingga ukuran tak terbatas".

<minFadeExtent>

Jarak yang dilalui geometri, mulai dari buram sepenuhnya menjadi sepenuhnya transparan. Nilai ramp ini, yang dinyatakan dalam piksel layar, diterapkan di ujung minimum batas LOD (visibilitas).

<maxFadeExtent>

Jarak yang dicapai geometri akan memudar, dari sepenuhnya transparan menjadi sepenuhnya buram. Nilai ramp ini, yang dinyatakan dalam piksel layar, diterapkan di ujung maksimum batas LOD (visibilitas).

Pada diagram berikut, jika P=ukuran proyeksi piksel yang dihitung, angka yang dilingkari menunjukkan hal berikut:

if (P < minLodPixels)
  opacity=0                                 //#1 in diagram
else if(P < minLodPixels + minFadeExtent)
  opacity=(P - minLodPixels)/minFadeExtent  //#2 in diagram
else if (P < maxLodPixels - maxFadeExtent)
  opacity=1                                 //#3 in diagram
else if (P < maxLodPixels)
  opacity=(maxLodPixels-P)/maxFadeExtent    //#4 in diagram
else
  opacity=0                                 //#5 in diagram

Contoh <Region>

<Region>
  <LatLonAltBox>
    <north>50.625</north>
    <south>45</south>
    <east>28.125</east>
    <west>22.5</west>
    <minAltitude>10</minAltitude>
    <maxAltitude>50</maxAltitude>
  </LatLonAltBox>
  <Lod>
    <minLodPixels>128</minLodPixels>
    <maxLodPixels>1024</maxLodPixels>
    <minFadeExtent>128</minFadeExtent>
    <maxFadeExtent>128</maxFadeExtent>
  </Lod>
</Region>

Memperluas

<Objek>

Dimuat Oleh

elemen apa pun yang berasal dari <Feature>

<Skema>

Sintaksis

<Schema name="string" id="ID">
  <SimpleField type="string" name="string">
    <displayName>...</displayName>            <!-- string -->
  </SimpleField>
</Schema>

Deskripsi

Menentukan skema KML kustom yang digunakan untuk menambahkan data kustom ke Fitur KML. Atribut "id" wajib ada dan harus unik dalam file KML. <Schema> selalu merupakan turunan dari <Document>.

Elemen Khusus untuk Skema

Elemen Skema berisi satu atau beberapa elemen SimpleField. Dalam SimpleField, Skema mendeklarasikan jenis dan nama kolom kustom. Secara opsional, kolom ini menentukan displayName (formulir yang mudah digunakan, dengan spasi dan tanda baca yang tepat yang digunakan untuk ditampilkan di Google Earth) untuk kolom kustom ini.

<SimpleField type="string" name="string">

Deklarasi kolom kustom, yang harus menentukan jenis dan nama kolom ini. Jika jenis atau nama dihilangkan, kolom akan diabaikan. Jenis dapat berupa salah satu dari yang berikut:

string
int
int
video singkat
Ushort
float
dobel
bool

<displayName>: Nama, jika ada, yang akan digunakan saat nama kolom ditampilkan kepada pengguna Google Earth. Gunakan elemen [CDATA] untuk meng-escape markup HTML standar.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <Schema name="TrailHeadType" id="TrailHeadTypeId">
    <SimpleField type="string" name="TrailHeadName">
      <displayName><![CDATA[<b>Trail Head Name</b>]]></displayName>
    </SimpleField>
    <SimpleField type="double" name="TrailLength">
      <displayName><![CDATA[<i>The length in miles</i>]]></displayName>
    </SimpleField>
    <SimpleField type="int" name="ElevationGain">
      <displayName><![CDATA[<i>change in altitude</i>]]></displayName>
    </SimpleField>
  </Schema> 
</Document>
</kml>

Memperluas

Ini adalah elemen root.

Dimuat Oleh

<Dokumen>

Lihat Juga

<SkemaData>

<ScreenOverlay>

Sintaksis

<ScreenOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- inherited from Overlay element -->
  <color>ffffffff</color>                  <!-- kml:color -->
  <drawOrder>0</drawOrder>                 <!-- int -->
  <Icon>...</Icon>

  <!-- specific to ScreenOverlay -->
  <overlayXY x="double" y="double" xunits="fraction" yunits="fraction"/>
    <!-- vec2 -->
    <!-- xunits and yunits can be one of: fraction, pixels, or insetPixels -->
  <screenXY x="double" y="double" xunits="fraction" yunits="fraction"/>
    <!-- vec2 -->
  <rotationXY x="double" y="double" xunits="fraction" yunits"fraction"/>
    <!-- vec2 -->
  <size x="double" y="double" xunits="fraction" yunits="fraction"/>
    <!-- vec2 -->
  <rotation>0</rotation>                   <!-- float -->
 </ScreenOverlay>

Deskripsi

Elemen ini menggambar gambar overlay yang ditetapkan ke layar. Contoh penggunaan untuk Overlay Layar adalah kompas, logo, dan heads-up display. Ukuran ScreenOverlay ditentukan oleh elemen <size>. Pemosisian overlay ditangani dengan memetakan titik dalam gambar yang ditentukan oleh <overlayXY> ke titik di layar yang ditentukan oleh <screenXY>. Kemudian, gambar diputar oleh <rotation> derajat di sekitar titik yang relatif terhadap layar yang ditentukan oleh <rotationXY>.

Anak <href> dari <Icon> menentukan gambar yang akan digunakan sebagai overlay. File ini dapat berada di sistem file lokal atau di server web. Jika elemen ini dihilangkan atau tidak berisi <href>, persegi panjang akan digambar menggunakan warna dan ukuran yang ditentukan oleh overlay layar.

Elemen Khusus untuk ScreenOverlay

<overlayXY>

Menentukan titik di (atau di luar) gambar overlay yang dipetakan ke koordinat layar (<screenXY>). Ini memerlukan nilai x dan y, serta unit untuk nilai tersebut.

Nilai x dan y dapat ditentukan dengan tiga cara berbeda: sebagai piksel ("pixels"), sebagai fraksi gambar ("fraction"), atau sebagai piksel inset ("insetPixels"), yang merupakan offset dalam piksel dari sudut kanan atas gambar. Posisi x dan y dapat ditentukan dengan cara yang berbeda—misalnya, x dapat berupa piksel dan y dapat berupa pecahan. Asal sistem koordinat ada di sudut kiri bawah gambar.

x - Jumlah piksel, komponen pecahan dari gambar, atau inset piksel yang menunjukkan komponen x dari suatu titik pada gambar overlay.
y - Jumlah piksel, komponen pecahan dari gambar, atau inset piksel yang menunjukkan komponen y dari suatu titik pada gambar overlay.
xunits - Unit tempat nilai x ditentukan. Nilai "fraction" menunjukkan nilai x adalah fraksi gambar. Nilai "pixels" menunjukkan nilai x dalam piksel. Nilai "insetPixels" menunjukkan indentasi dari tepi kanan gambar.
yunits - Unit tempat nilai y ditentukan. Nilai "fraction" menunjukkan nilai y adalah fraksi gambar. Nilai "pixels" menunjukkan nilai y dalam piksel. Nilai "insetPixels" menunjukkan indentasi dari tepi atas gambar.

<screenXY>

Menentukan titik relatif terhadap asal layar tempat gambar overlay dipetakan. Nilai x dan y dapat ditentukan dengan tiga cara berbeda: sebagai piksel ("pixels"), sebagai fraksi layar ("fraction"), atau sebagai piksel inset ("insetPixels"), yang merupakan offset dalam piksel dari sudut kanan atas layar. Posisi x dan y dapat ditentukan dengan cara yang berbeda—misalnya, x dapat berupa piksel dan y dapat berupa pecahan. Asal sistem koordinat ada di sudut kiri bawah layar.

x - Jumlah piksel, komponen pecahan layar, atau inset piksel yang menunjukkan komponen x dari suatu titik di layar.
y - Jumlah piksel, komponen pecahan layar, atau inset piksel yang menunjukkan komponen y dari suatu titik di layar.
xunits - Unit tempat nilai x ditentukan. Nilai "fraction" menunjukkan nilai x adalah bagian dari layar. Nilai "pixels" menunjukkan nilai x dalam piksel. Nilai "insetPixels" menunjukkan indentasi dari tepi kanan layar.
yunits - Unit tempat nilai y ditentukan. Nilai fraksi menunjukkan nilai y adalah fraksi layar. Nilai "pixels" menunjukkan nilai y dalam piksel. Nilai "insetPixels" menunjukkan indentasi dari tepi atas layar.

Misalnya, <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> menunjukkan titik di bagian tengah layar.

Berikut beberapa contohnya:

Pusatkan gambar:

<ScreenOverlay>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

Tempatkan gambar di kiri atas:

<ScreenOverlay>
  <overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="0" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

Tempatkan gambar di sebelah kanan layar:

<ScreenOverlay>
  <overlayXY x="1" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="1" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

<rotationXY>

Titik relatif ke layar tempat overlay layar diputar.

<size>

Menentukan ukuran gambar untuk overlay layar, sebagai berikut:

Nilai 1 menunjukkan penggunaan dimensi native
Nilai 0 menunjukkan bahwa rasio lebar tinggi dapat dipertahankan
Nilai n menetapkan nilai dimensi

Misalnya:

Untuk memaksa gambar mempertahankan dimensi x dan y aslinya, tetapkan nilai ke 1:

<size x="-1" y="-1" xunits="fraction" yunits="fraction"/>

Untuk memaksa gambar mempertahankan dimensi horizontalnya, tetapi menggunakan 20 persen ruang layar vertikal:

<size x="-1" y="0.2" xunits="fraction" yunits="fraction"/>

Untuk memaksa gambar diubah ukurannya menjadi 100 x 500 piksel:

<size x="100" y="500" xunits="pixels" yunits="pixels"/>

<rotation>

Menunjukkan sudut rotasi objek induk. Nilai 0 berarti tidak ada rotasi. Nilainya adalah sudut dalam derajat yang berlawanan arah jarum jam mulai dari utara. Gunakan ±180 untuk menunjukkan rotasi objek induk dari 0. Bagian tengah <rotation>, jika tidak (.5,.5), ditentukan dalam <rotationXY>.

Contoh

Contoh berikut menempatkan gambar di tengah layar secara tepat, menggunakan lebar, tinggi, dan rasio lebar tinggi asli gambar.

<ScreenOverlay id="khScreenOverlay756">
  <name>Simple crosshairs</name>
  <description>This screen overlay uses fractional positioning
   to put the image in the exact center of the screen</description>
  <Icon>
    <href>http://myserver/myimage.jpg</href>
  </Icon>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <rotation>39.37878630116985</rotation>
  <size x="0" y="0" xunits="pixels" yunits="pixels"/>
</ScreenOverlay>

Memperluas

<Fitur>
<Overlay>

Dimuat Oleh

<Dokumen>
<Folder>

<Style>

Sintaksis

<Style id="ID">
<!-- extends StyleSelector -->

<!-- specific to Style -->
  <IconStyle>...</IconStyle>
  <LabelStyle>...</LabelStyle>
  <LineStyle>...</LineStyle>
  <PolyStyle>...</PolyStyle>
  <BalloonStyle>...</BalloonStyle>
  <ListStyle>...</ListStyle>
</Style>

Deskripsi

Gaya menentukan grup gaya yang dapat diberi alamat yang dapat direferensikan oleh StyleMaps dan Fitur. Gaya memengaruhi bagaimana Geometri disajikan di penampil 3D dan bagaimana Fitur muncul di panel Tempat tampilan Daftar. Gaya bersama dikumpulkan dalam <Document> dan harus memiliki id yang ditentukan untuk gaya tersebut agar dapat direferensikan oleh Fitur individual yang menggunakannya.

Gunakan id untuk merujuk ke gaya dari <styleUrl>.

Contoh

<Document>
  <!-- Begin Style Definitions -->
  <Style id="myDefaultStyles">
    <IconStyle>
      <color>a1ff00ff</color>
      <scale>1.399999976158142</scale>
      <Icon>
        <href>http://myserver.com/icon.jpg</href>
      </Icon>
    </IconStyle>
    <LabelStyle>
      <color>7fffaaff</color>
      <scale>1.5</scale>
    </LabelStyle>
    <LineStyle>
      <color>ff0000ff</color>
      <width>15</width>
    </LineStyle>
    <PolyStyle>
      <color>7f7faaaa</color>
      <colorMode>random</colorMode>
    </PolyStyle>
  </Style>
  <!-- End Style Definitions -->
  <!-- Placemark #1 -->
  <Placemark>
    <name>Google Earth - New Polygon</name>
    <description>Here is some descriptive text</description>
    <styleUrl>#myDefaultStyles</styleUrl>
    . . .
  </Placemark>
  <!-- Placemark #2 -->
  <Placemark>
    <name>Google Earth - New Path</name>
    <styleUrl>#myDefaultStyles</styleUrl>
      . . . .
  </Placemark>
</Document>
</kml>

Memperluas

<PemilihPilih>

Dimuat Oleh

semua <Fitur>

Elemen Khusus untuk Gaya

<BalloonStyle>
<IconStyle>
<LabelStyle>
<BarisStyle>
<ListStyle>
<PolyStyle>

<StyleMap>

Sintaksis

<StyleMap id="ID">
  <!-- extends StyleSelector -->
  <!-- elements specific to StyleMap -->
  <Pair id="ID">
    <key>normal</key>              <!-- kml:styleStateEnum:  normal or highlight -->
    <styleUrl>...</styleUrl> or <Style>...</Style>
  </Pair>
</StyleMap>

Deskripsi

<StyleMap> memetakan antara dua Gaya yang berbeda. Biasanya elemen <StyleMap> digunakan untuk menyediakan gaya normal dan yang disorot untuk penanda letak, sehingga versi yang disorot muncul saat pengguna mengarahkan mouse ke ikon di Google Earth.

Elemen Khusus untuk StyleMap

<Pasang>(wajib)

Menentukan key-value pair yang memetakan mode (normal atau highlight) ke <styleUrl> standar. <Pair> berisi dua elemen (keduanya wajib):

<key>, yang mengidentifikasi kunci
<styleUrl> atau <Style>, yang mereferensikan gaya. Di <styleUrl>, untuk elemen gaya yang direferensikan yang bersifat lokal untuk dokumen KML, # referensi sederhana digunakan. Untuk gaya yang ada dalam file eksternal, gunakan URL lengkap bersama # referensi. Contoh:

<Pair> 
  <key>normal</key>
  <styleUrl>http://myserver.com/populationProject.xml#example_style_off</styleUrl>
</Pair>

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>StyleMap.kml</name>
  <open>1</open>
  <Style id="normalState">
    <IconStyle>
      <scale>1.0</scale>
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pal3/icon55.png</href>
      </Icon>
    </IconStyle>
    <LabelStyle>
      <scale>1.0</scale>
    </LabelStyle>
  </Style>
  <Style id="highlightState">
    <IconStyle>
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pal3/icon60.png</href>
      </Icon>
      <scale>1.1</scale>
    </IconStyle>
    <LabelStyle>
      <scale>1.1</scale>
      <color>ff0000c0</color>
    </LabelStyle>
  </Style>
  <StyleMap id="styleMapExample">
    <Pair>
      <key>normal</key>
      <styleUrl>#normalState</styleUrl>
    </Pair>
    <Pair>
      <key>highlight</key>
      <styleUrl>#highlightState</styleUrl>
    </Pair>
  </StyleMap>
  <Placemark>
    <name>StyleMap example</name>
    <styleUrl>#styleMapExample</styleUrl>
    <Point>
      <coordinates>-122.368987,37.817634,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Memperluas

<PemilihPilih>

Dimuat Oleh

semua <Fitur>

<PemilihPilih>

Sintaksis

<!-- abstract element; do not create -->
<!-- StyleSelector id="ID" -->                 <!-- Style,StyleMap -->
<!-- /StyleSelector -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Ini adalah jenis dasar untuk elemen <Style> dan <StyleMap>. Elemen StyleMap memilih gaya berdasarkan mode Penanda Letak saat ini. Elemen yang berasal dari StyleSelector diidentifikasi secara unik oleh id dan url miliknya.

Elemen Khusus untuk StyleSelector

Elemen abstrak ini tidak berisi elemen turunan apa pun.

Memperluas

<Objek>

Diperluas Oleh

<Gaya>
<GayaPeta>

<TimePrimitive>

Sintaksis

<!-- abstract element; do not create -->
<!-- TimePrimitive id="ID" -->            <!-- TimeSpan,TimeStamp -->
  <!-- extends Object -->
<!-- /TimePrimitive -->

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Elemen ini diperluas dengan elemen <TimeSpan> dan <TimeStamp>.

Memperluas

<Objek>

Diperluas Oleh

<TimeSpan>
<TimeStamp>

<TimeSpan>

Sintaksis

<TimeSpan id="ID">
  <begin>...</begin>     <!-- kml:dateTime -->
  <end>...</end>         <!-- kml:dateTime -->
</TimeSpan>

Deskripsi

Menunjukkan tingkat waktu yang dibatasi oleh dateTimes awal dan akhir.

Jika <begin> atau <end> tidak ada, akhir periode tersebut tidak terikat (lihat Contoh di bawah).

dateTime ditentukan sesuai dengan waktu Skema XML (lihat Skema XML Bagian 2: Edisi Kedua Jenis Data). Nilainya dapat dinyatakan sebagai yyyy-mm-ddThh:mm:ss.ssszzzzzz, dengan T adalah pemisah antara tanggal dan waktu, serta zona waktu adalah Z (untuk UTC) atau zzzzzz, yang mewakili ±hh:mm sehubungan dengan UTC. Selain itu, nilai dapat dinyatakan sebagai tanggal saja. Lihat <TimeStamp> untuk contoh.

Elemen Khusus untuk TimeSpan

<begin>: Menjelaskan momen awal dalam jangka waktu tertentu. Jika tidak ada, awal periode tidak terikat.
<end>: Menjelaskan momen akhir dari jangka waktu tertentu. Jika tidak ada, akhir periode tidak akan dibatasi.

Contoh

Contoh berikut menunjukkan jangka waktu yang mewakili negara bagian Colorado. Pesan ini hanya berisi tag <begin> karena Colorado menjadi negara bagian pada 1 Agustus 1876 dan terus menjadi negara bagian:

<Placemark>
  <name>Colorado</name>
  .
  .
  .
  <TimeSpan>
    <begin>1876-08-01</begin>
  </TimeSpan>
</Placemark>

Memperluas

<TimePrimitive>

Dimuat Oleh

elemen apa pun yang berasal dari <Feature>

<TimeStamp>

Sintaksis

<TimeStamp id="ID">
  <when>...</when>      <!-- kml:dateTime -->
</TimeStamp>

Deskripsi

Menunjukkan satu momen dalam waktu. Ini adalah elemen sederhana dan tidak berisi turunan. Nilainya adalah dateTime, ditentukan dalam waktu XML (lihat XML Schema Part 2: Datatypes Second Edition). Ketepatan TimeStamp ditentukan oleh nilai dateTime di elemen <when>.

Elemen Khusus TimeStamp

<when>

Menentukan momen tunggal dalam waktu. Nilainya adalah dateTime, yang dapat merupakan salah satu dari yang berikut:

dateTime memberikan resolusi kedua
date memberi resolusi hari
gYearMonth memberikan resolusi bulan
gYear memberikan resolusi tahun

Contoh berikut menunjukkan resolusi yang berbeda untuk nilai <when>:

gYear (YYYY)

<TimeStamp>
  <when>1997</when>
</TimeStamp>

gYearMonth (YYYY-MM)

<TimeStamp>
  <when>1997-07</when>
</TimeStamp>

date (YYYY-MM-DD)

<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp>

dateTime (YYYY-MM-DDThh:mm:ssZ)
Di sini, T adalah pemisah antara kalender dan notasi waktu per jam, dan Z menunjukkan UTC. (Detik diperlukan.)

<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>

dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
Contoh ini memberikan waktu lokal, lalu konversi ± menjadi UTC.

<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

Memperluas

<TimePrimitive>

Dimuat Oleh

elemen apa pun yang memperluas <Feature>

<gx:TimeSpan> dan <gx:TimeStamp>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Salinan elemen <TimeSpan> dan <TimeStamp>, di namespace ekstensi. Hal ini memungkinkan penyertaan nilai waktu di AbstractView (<Camera> dan <LookAt>). Nilai waktu digunakan untuk mengontrol gambar historis, sinar matahari, dan visibilitas Fitur yang diberi stempel waktu.

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

  <Document>
    <name>Views with Time</name>
    <open>1</open>
    <description>
      In Google Earth, enable historical imagery and sunlight,
      then click on each placemark to fly to that point in time.
    </description>

    <Placemark>
      <name>Sutro Baths in 1946</name>
      <Camera>
        <gx:TimeStamp>
          <when>1946-07-29T05:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.518172</longitude>
        <latitude>37.778036</latitude>
        <altitude>221.0</altitude>
        <heading>70.0</heading>
        <tilt>75.0</tilt>
      </Camera>
    </Placemark>

    <Placemark>
      <name>Palace of Fine Arts in 2002</name>
      <Camera>
        <gx:TimeStamp>
          <when>2002-07-09T19:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.444633</longitude>
        <latitude>37.801899</latitude>
        <altitude>139.629438</altitude>
        <heading>-70.0</heading>
        <tilt>75</tilt>
      </Camera>
    </Placemark>

  </Document>
</kml>

<gx:Tur>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:Tour id="ID">
  <name>...</name>
  <description>...</description>
  <gx:Playlist>

    <!-- any number of gx:TourPrimitive elements -->

  </gx:Playlist>
</gx:Tour>

Deskripsi

<gx:Tour> dapat berisi satu elemen <gx:Playlist>, yang selanjutnya berisi daftar elemen gx:TourPrimitive yang diurutkan untuk menentukan tur di semua browser KML. Pelajari tur lebih lanjut.

Contoh

Sejumlah contoh tur tersedia dari bab Tur dari Panduan Developer KML.

Berisi

gx:Playlist - Berisi sejumlah elemen gx:TourPrimitive. Tidak boleh ada satu atau beberapa elemen <gx:Playlist> yang termuat dalam elemen <gx:Tour>.

<gx:Tour>
  <gx:Playlist>
    <!-- gx:TourPrimitive -->
      ...
    <!-- /gx:TourPrimitive -->

    <!--- Any number of gx:TourPrimitive elements can be included --->
  </gx:Playlist>
</gx:Tour>

<gx:TourPrimitive>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.0 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:Tour>
  <gx:Playlist>

    <!-- abstract element; do not create -->
    <!-- gx:TourPrimitive -->    <!-- gx:AnimatedUpdate, gx:FlyTo, gx:TourControl, gx:SoundCue, gx:Wait -->
        <!-- extends Object -->
    <!-- /gx:TourPrimitive -->

  </gx:Playlist>
</gx:Tour>

Deskripsi

Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Elemen ini diperluas dengan elemen <gx:FlyTo>, <gx:AnimatedUpdate>, <gx:TourControl>, <gx:Wait>, dan <gx:SoundCue>.

Elemen yang diperluas dari gx:TourPrimitive memberikan petunjuk ke browser KML selama tur, termasuk titik untuk terbang dan durasi penerbangan, jeda, pembaruan pada fitur KML, dan file suara untuk diputar.

Elemen ini harus dimuat dalam elemen <gx:Playlist>, yang selanjutnya berisi elemen <gx:Tour>.

Contoh

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">

  <Document>
    <name>gx:AnimatedUpdate example</name>
    <open>1</open>

    <Style>
      <IconStyle id="iconstyle">
        <scale>1.0</scale>
      </IconStyle>
    </Style>

    <Placemark id="mountainpin1">
      <name>New Zealand's Southern Alps</name>
      <styleUrl>#style</styleUrl>
      <Point>
        <coordinates>170.144,-43.605,0</coordinates>
      </Point>
    </Placemark>

    <gx:Tour>
      <name>Play me!</name>
      <gx:Playlist>

        <!-- The order and duration of TourPrimitives is important;
             in this example, the AnimatedUpdate needs
             6.5 seconds to complete. The FlyTo provides 4.1,
             and the Wait 2.4, giving the update time to
             complete before the Tour ends. AnimatedUpdates
             don't hold Tours open, but FlyTos and Waits do.

             For more information, refer to:
             http://developers.google.com/kml/documentation/touring#tourtimelines
        -->

        <gx:AnimatedUpdate>
          <gx:duration>6.5</gx:duration>
          <Update>
            <targetHref></targetHref>
            <Change>
                <IconStyle targetId="iconstyle">
                  <scale>10.0</scale>
                </IconStyle>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>4.1</gx:duration>
          <Camera>
            <longitude>170.157</longitude>
            <latitude>-43.671</latitude>
            <altitude>9700</altitude>
            <heading>-6.333</heading>
            <tilt>33.5</tilt>
            <roll>0</roll>
          </Camera>
        </gx:FlyTo>

        <gx:Wait>
          <gx:duration>2.4</gx:duration>  <!-- waiting for the AnimatedUpdate to complete -->
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>
  </Document>
</kml>

Dimuat oleh

<gx:Playlist>

Diperpanjang sebesar

<gx:PembaruanPembaruan>
<gx:TerbangKe>
<gx:SoundCue>
```
<gx:SoundCue id="ID">
  <href>http://www.example.com/audio/trumpets.mp3</href>   
  <gx:delayedStart>0</gx:delayedStart>                     
</gx:SoundCue>
```
Berisi elemen <href> yang menentukan file suara yang akan diputar, dalam format MP3, M4A, atau AAC. Durasinya tidak berisi. File suara diputar secara paralel dengan bagian tur lainnya, yang berarti primitif tur berikutnya berlangsung tepat setelah primitif tur <gx:SoundCue> tercapai. Jika file suara lain diberi isyarat sebelum yang pertama selesai diputar, file tersebut akan digabungkan. Elemen <gx:delayedStart> menentukan penundaan mulai suara selama jumlah detik tertentu sebelum memutar file.
<gx:TourControl>
```
<gx:TourControl id="ID">
  <gx:playMode>pause</gx:playMode>    
</gx:TourControl>
```
Berisi elemen <gx:playMode> tunggal, yang memungkinkan tur dijeda hingga pengguna mengambil tindakan untuk melanjutkan tur.
<gx:Wait>
```
<gx:Wait id="ID">
  <gx:duration>0.0</gx:duration>    
</gx:Wait>
```
Kamera tetap diam, pada gx:AbstractView yang terakhir ditentukan, selama jumlah detik yang ditentukan sebelum memutar gx:TourPrimitive berikutnya. Perhatikan bahwa waktu tunggu tidak menjeda linimasa tur - file suara yang sedang diputar dan update animasi akan terus diputar saat kamera menunggu.

Memperluas

<Objek>

<gx:Pelacakan>

Elemen ini merupakan ekstensi standar OGC KML 2.2 dan didukung di Google Earth 5.2 dan yang lebih baru. Pelajari lebih lanjut

Sintaksis

<gx:Track id="ID">
  <!-- specific to Track -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <when>...</when>                         <!-- kml:dateTime -->
  <gx:coord>...</gx:coord>                 <!-- string -->
  <gx:angles>...</gx:angles>               <!-- string -->
  <Model>...</Model>
  <ExtendedData>
    <SchemaData schemaUrl="anyURI">
      <gx:SimpleArrayData kml:name="string">
        <gx:value>...</gx:value>            <!-- string -->
      </gx:SimpleArrayData>
    <SchemaData>
  </ExtendedData>
</gx:Track>

Deskripsi

Pelacakan menjelaskan cara objek bergerak di seluruh dunia selama jangka waktu tertentu. Fitur ini memungkinkan Anda membuat satu objek yang terlihat di Google Earth (baik ikon Titik atau Model) yang mengenkode beberapa posisi untuk objek yang sama beberapa kali. Di Google Earth, penggeser waktu memungkinkan pengguna menggerakkan tampilan, yang menganimasikan posisi objek.

Elemen gx:MultiTrack digunakan untuk mengumpulkan beberapa trek menjadi satu unit konseptual dengan satu ikon (atau Model) terkait yang bergerak di sepanjang jalur. Fitur ini berguna jika Anda memiliki beberapa trek untuk objek dunia nyata yang sama. Elemen <gx:interpolate> Boolean dari <gx:MultiTrack> menentukan apakah akan melakukan interpolasi antara trek dalam multi-jalur. Jika nilai ini 0, maka titik atau Model berhenti di akhir satu jalur dan melompat ke awal nilai berikutnya. (Misalnya, jika Anda ingin satu penanda letak merepresentasikan perjalanan Anda selama dua hari, dan unit GPS Anda dinonaktifkan selama empat jam selama periode ini, Anda dapat menampilkan diskon antara titik tempat unit dinonaktifkan lalu diaktifkan lagi.) Jika nilai untuk <gx:interpolate> adalah 1, nilai antara akhir trek pertama dan awal trek berikutnya diinterpolasi, sehingga trek akan muncul sebagai satu jalur berkelanjutan.

Lihat Panduan Pengguna Google Earth untuk mendapatkan informasi tentang cara mengimpor data GPS ke Google Earth.

Mengapa lagu berguna?

Versi KML sebelumnya (sebelum Google Earth 5.2) memungkinkan Anda mengaitkan elemen waktu dengan Fitur apa pun (tanda letak, hamparan bumi, dll.). Namun, Anda hanya dapat mengaitkan satu elemen waktu dengan Fitur tertentu. Trek adalah mekanisme yang lebih efisien untuk mengaitkan data waktu dengan Fitur yang terlihat karena Anda hanya membuat satu Fitur, yang dapat dikaitkan dengan beberapa elemen waktu saat objek bergerak di ruang.

Selain itu, elemen trek lebih kuat daripada mekanisme sebelumnya (dijelaskan dalam bab Waktu dan Animasi dalam Panduan Developer KML) karena <Track> menyediakan mekanisme untuk melakukan interpolasi posisi objek kapan saja di sepanjang jalurnya. Dengan fitur baru ini, Google Earth menampilkan grafik profil ketinggian dan kecepatan (ditambah data khusus, jika ada) untuk objek dari waktu ke waktu.

Data "Sparse"

Jika beberapa nilai data hilang untuk posisi pada trek, tag <coord/> (<coord></coord>) atau <angles/> (<angles></angles>) kosong dapat diberikan untuk menyeimbangkan array. Tag <coord/> atau <angles/> kosong menunjukkan bahwa tidak ada data semacam itu untuk titik data tertentu, dan nilainya harus diinterpolasi antara dua titik data terdekat yang ditentukan. Perilaku ini juga berlaku untuk ExtendedData untuk suatu jalur. Semua elemen kecuali <when> dapat kosong dan akan diinterpolasi antara dua elemen terdekat yang ditentukan dengan baik.

Elemen Khusus untuk Dilacak

<altitudeMode>

Menentukan cara komponen height di elemen <ordinats> ditafsirkan. Nilai yang memungkinkan adalah

clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag <gx:coord>).
relativeToGround - Menetapkan ketinggian elemen relatif terhadap elevasi permukaan tanah sebenarnya dari lokasi tertentu. Misalnya, jika elevasi permukaan suatu lokasi berada tepat di permukaan laut dan ketinggian suatu titik diatur ke 9 meter, maka elevasi untuk ikon elevasi tanda letak titik adalah 9 meter dengan mode ini. Namun, jika koordinat yang sama ditetapkan di atas lokasi dengan ketinggian tanah 10 meter di atas permukaan laut, maka ketinggian koordinat adalah 19 meter.
absolut - Menetapkan ketinggian koordinat relatif terhadap permukaan laut, terlepas dari ketinggian medan yang sebenarnya di bawah elemen. Misalnya, jika Anda menetapkan ketinggian koordinat ke 10 meter dengan mode ketinggian absolut, ikon penanda letak titik akan tampak berada di permukaan tanah jika medan di bawahnya juga 10 meter di atas permukaan laut. Jika medan berada 3 meter di atas permukaan laut, penanda letak akan muncul di atas medan sebesar 7 meter.

<gx:heightMode>

Ekstensi KML di namespace ekstensi Google, yang memungkinkan ketinggian relatif terhadap dasar laut. Nilainya adalah:

relativeToSeaFloor - Menafsirkan ketinggian sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, ketinggian akan ditafsirkan sebagai berada di atas tanah.
clampToSeaFloor - Spesifikasi ketinggian akan diabaikan dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

<Kapan>

Nilai waktu yang sesuai dengan posisi (ditentukan dalam elemen <gx:coord>). Jumlah elemen <when> di elemen <Track> harus sama dengan jumlah elemen <gx:coord> (dan elemen <gx:angles>, jika disertakan).

<gx:coord>

Nilai koordinat yang terdiri dari tiga nilai untuk bujur, lintang, dan ketinggian, tanpa pemisah koma. Misalnya:

<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

Perhatikan bahwa sintaksis untuk elemen <gx:coord> berbeda dengan sintaksis untuk elemen <ordinats>, yang menggunakan koma untuk memisahkan komponen bujur, lintang, dan ketinggian. Jumlah elemen yang ditentukan harus sama dengan jumlah elemen waktu () dan posisi (). Anda dapat menentukan elemen <gx:coord> kosong untuk nilai yang tidak ada jika diperlukan.

<gx:angles>

Nilai ini digunakan untuk menentukan nilai arah, kemiringan, dan pemutaran tambahan untuk ikon atau model untuk setiap waktu/posisi dalam trek. Tiga nilai floating point tercantum tanpa pemisah koma dan mewakili derajat rotasi. Jika <gx:angles> tidak ditentukan, Google Earth akan menyimpulkan judul, kemiringan, dan gerakan objek dari jalurnya. Jumlah elemen <gx:angles> yang ditentukan harus sama dengan jumlah elemen waktu (<when>) dan posisi (<gx:coord>). Anda dapat menentukan elemen <gx:angles> kosong untuk nilai yang tidak ada jika diperlukan.

Saat ini, ikon hanya mendukung judul, tetapi model mendukung ketiga nilai tersebut.

Berikut adalah contoh setelan nilai ini:

<gx:angles>45.54676 66.2342 77.0</gx:angles>

<Model>

Jika ditentukan, Model akan menggantikan ikon Titik yang digunakan untuk menunjukkan posisi saat ini pada jalur. Jika <Model> ditentukan dalam <gx:Track>, berikut adalah cara elemen turunan fungsi <Model>:

Elemen <Location> diabaikan.
Elemen <heightMode> diabaikan.
Nilai <Orientation> digabungkan dengan orientasi trek sebagai berikut. Pertama, rotasi <Orientasi> diterapkan, yang membawa model dari sistem koordinat lokal (x, y, z) ke orientasi menghadap ke kanan dan menghadap ke utara. Selanjutnya, rotasi diterapkan yang sesuai dengan interpolasi nilai <gx:angles> yang memengaruhi arah, kemiringan, dan roll model saat bergerak di sepanjang trek. Jika tidak ada sudut yang ditetapkan, arah dan kemiringan disimpulkan dari pergerakan model.
Tips: Jika Anda tidak yakin bagaimana cara menentukan orientasi, hilangkan elemen <Orientation> dari <Model> dan lihat bagaimana Google Earth memosisikan model saat bergerak di sepanjang lintasan. Jika bagian depan model menghadap ke samping, ubah elemen <heading> di <Orientation> untuk memutar model agar mengarah ke depan. Jika model tidak tegak, coba ubah elemen <tilt> atau <roll>.

<ExtendedData>

Elemen data kustom yang ditentukan dalam <Schema> sebelumnya di file KML.

Menambahkan data yang terkait dengan setiap waktu/posisi pada trek sering kali berguna. Naik sepeda, misalnya, dapat mencakup data detak jantung, ritme, dan daya, seperti yang ditunjukkan pada Contoh Jalur dengan Data yang Diperluas. Di <Schema>, Anda menentukan <gx:SimpleArrayField> untuk setiap jenis data kustom. Kemudian, untuk setiap jenis data, sertakan elemen <gx:SimpleArrayData> yang berisi elemen <gx:value> yang sesuai dengan setiap waktu/posisi di trek. Lihat bab Menambahkan Data Kustom pada Panduan Developer KML untuk informasi selengkapnya tentang cara menambahkan kolom data baru. Di Google Earth, data kustom ditampilkan di Profil Ketinggian untuk trek.

Contoh Sederhana

Contoh yang sangat mendasar ini menunjukkan cara membuat "array" nilai yang paralel untuk <when> dan <gx:coord>. Jumlah waktu dan nilai posisi harus sama.

<?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">
<Folder>
  <Placemark>
    <gx:Track>
      <when>2010-05-28T02:02:09Z</when>
      <when>2010-05-28T02:02:35Z</when>
      <when>2010-05-28T02:02:44Z</when>
      <when>2010-05-28T02:02:53Z</when>
      <when>2010-05-28T02:02:54Z</when>
      <when>2010-05-28T02:02:55Z</when>
      <when>2010-05-28T02:02:56Z</when>
      <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
      <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
      <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
      <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
      <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
      <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
      <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
    </gx:Track>
  </Placemark>
</Folder>
</kml>

Contoh Jalur dengan Data yang Diperluas

Jenis huruf tebal dalam contoh ini menyoroti elemen yang digunakan untuk menentukan dan menentukan data kustom untuk sepeda. Kolom data kustom diberi nama secara internal "detak jantung", "cadangan", dan "daya". Elemen <Schema> menentukan nama yang akan ditampilkan untuk setiap kumpulan nilai (Detak Jantung, Rangkaian Kegiatan Pemasaran, dan Kekuatan) dan menetapkan jenis data untuk setiap kolom baru (detak jantung dan ritme dengan jenis int, dan jenis daya float). Di Google Earth, data kustom ini ditampilkan bersama profil ketinggian untuk trek.

Contoh ini adalah presentasi trek yang lebih realistis, dengan ikon khusus serta ikon dan gaya garis terpisah untuk mode sorotan dan normal. Namun, perhatikan bahwa contoh tersebut hanya menyertakan tujuh set nilai data. Contoh sebenarnya mencakup puluhan ribu nilai. (Data atas kebaikan dari Sean Broeder. Data ini dikumpulkan dengan Garmin Edge 705 dengan pemantau detak jantung dan pengukur daya terkait.)

<?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">
  <Document>
    <name>GPS device</name>
    <Snippet>Created Wed Jun 2 15:33:39 2010</Snippet>

    <!-- Normal track style -->
    <LookAt>
      <gx:TimeSpan>
        <begin>2010-05-28T02:02:09Z</begin>
        <end>2010-05-28T02:02:56Z</end>
      </gx:TimeSpan>
      <longitude>-122.205544</longitude>
      <latitude>37.373386</latitude>
      <range>1300.000000</range>
    </LookAt>
    <Style id="track_n">
      <IconStyle>
        <scale>.5</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
      <LabelStyle>
        <scale>0</scale>
      </LabelStyle>

    </Style>
    <!-- Highlighted track style -->
    <Style id="track_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="track">
      <Pair>
        <key>normal</key>
        <styleUrl>#track_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#track_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal multiTrack style -->
    <Style id="multiTrack_n">
      <IconStyle>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>

    </Style>
    <!-- Highlighted multiTrack style -->
    <Style id="multiTrack_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>8</width>
      </LineStyle>
    </Style>
    <StyleMap id="multiTrack">
      <Pair>
        <key>normal</key>
        <styleUrl>#multiTrack_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#multiTrack_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal waypoint style -->
    <Style id="waypoint_n">
      <IconStyle>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <!-- Highlighted waypoint style -->
    <Style id="waypoint_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="waypoint">
      <Pair>
        <key>normal</key>
        <styleUrl>#waypoint_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#waypoint_h</styleUrl>
      </Pair>
    </StyleMap>
    <Style id="lineStyle">
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>
    </Style>
    <Schema id="schema">
      <gx:SimpleArrayField name="heartrate" type="int">
        <displayName>Heart Rate</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="cadence" type="int">
        <displayName>Cadence</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="power" type="float">
        <displayName>Power</displayName>
      </gx:SimpleArrayField>
    </Schema>
    <Folder>
      <name>Tracks</name>
      <Placemark>
        <name>2010-05-28T01:16:35.000Z</name>
        <styleUrl>#multiTrack</styleUrl>
        <gx:Track>
          <when>2010-05-28T02:02:09Z</when>
          <when>2010-05-28T02:02:35Z</when>
          <when>2010-05-28T02:02:44Z</when>
          <when>2010-05-28T02:02:53Z</when>
          <when>2010-05-28T02:02:54Z</when>
          <when>2010-05-28T02:02:55Z</when>
          <when>2010-05-28T02:02:56Z</when>
          <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
          <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
          <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
          <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
          <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
          <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
          <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
          <ExtendedData>
            <SchemaData schemaUrl="#schema">
              <gx:SimpleArrayData name="cadence">
                <gx:value>86</gx:value>
                <gx:value>103</gx:value>
                <gx:value>108</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="heartrate">
                <gx:value>181</gx:value>
                <gx:value>177</gx:value>
                <gx:value>175</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="power">
                <gx:value>327.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>179.0</gx:value>
                <gx:value>162.0</gx:value>
                <gx:value>166.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>183.0</gx:value>
              </gx:SimpleArrayData>
            </SchemaData>
          </ExtendedData>
        </gx:Track>
      </Placemark>
    </Folder>
  </Document>
</kml>

Memperluas

<Geometri>

Dimuat Oleh

<MultiGeometry>
<gx:MultiTrack>
<Placemark>

<Perbarui>

Sintaksis

<Update>
  <targetHref>...</targetHref>    <!-- URL -->
  <Change>...</Change>
  <Create>...</Create>
  <Delete>...</Delete>
</Update>

Deskripsi

Menentukan penambahan, perubahan, atau penghapusan data KML yang telah dimuat menggunakan URL yang ditentukan. <targetHref> menetapkan file .kml atau .pubsub yang datanya (dalam Google Earth) akan diubah. <Update> selalu berada di NetworkLinkControl. Selain itu, file yang berisi NetworkLinkControl harus telah dimuat oleh NetworkLink. Lihat halaman "Topik di KML" pada Update untuk contoh mendetail tentang cara kerja Update.

Elemen Khusus untuk Diperbarui

Dapat berisi sejumlah elemen <Change>, <Create>, dan <Delete>, yang akan diproses secara berurutan.

<targetHref>(wajib diisi): URL yang menentukan file .kml atau .pubsub yang datanya (dalam Google Earth) akan diubah oleh elemen <Update>. File KML ini harus sudah dimuat melalui <NetworkLink>. Dalam file tersebut, elemen yang akan diubah harus sudah memiliki atribut id eksplisit yang ditentukan untuknya.
<Change>: Memodifikasi nilai dalam elemen yang telah dimuat dengan <NetworkLink>. Dalam elemen Change, turunan yang akan dimodifikasi harus menyertakan atribut targetId yang mereferensikan id elemen asli.; Pembaruan ini dapat dianggap sebagai "pembaruan jarang": di elemen yang dimodifikasi, hanya nilai yang tercantum di <Change> yang akan diganti; semua nilai lainnya tetap tidak tersentuh. Ketika <Change> diterapkan ke serangkaian koordinat, koordinat baru tersebut akan menggantikan koordinat saat ini.; Turunan elemen ini adalah elemen yang akan diubah, yang diidentifikasi oleh atribut targetId.
<Create>: Menambahkan elemen baru ke Folder atau Dokumen yang telah dimuat melalui <NetworkLink>. Elemen <targetHref> di <Update> menentukan URL file .kml atau .FragmentManager yang berisi Folder atau Dokumen asli. Dalam file tersebut, Folder atau Dokumen yang berisi data baru harus sudah memiliki id eksplisit yang ditentukan untuknya. id ini dirujuk sebagai atribut targetId Folder atau Dokumen dalam <Create> yang berisi elemen yang akan ditambahkan.; Setelah objek dibuat dan dimuat ke Google Earth, objek tersebut akan mengambil URL Dokumen induk asli dari Folder. Untuk menjalankan update berikutnya pada objek yang ditambahkan dengan mekanisme Update/Create ini, tetapkan <targetHref> ke URL Dokumen atau Folder asli (bukan URL file yang memuat update intervensi).
<Delete>: Menghapus fitur dari elemen kompleks yang telah dimuat melalui <NetworkLink>. Elemen <targetHref> di <Update> menentukan file .kml atau .pubsub yang berisi data yang akan dihapus. Dalam file tersebut, elemen yang akan dihapus harus memiliki id eksplisit yang ditentukan untuknya. Elemen <Delete> mereferensikan id ini dalam atribut targetId.; Elemen turunan untuk <Delete>, yang merupakan satu-satunya elemen yang dapat dihapus, adalah Document, Folder, GroundOverlay, Tagging, dan ScreenOverlay.

Contoh <Change>

<NetworkLinkControl>
  <Update>
    <targetHref>http://www/~sam/January14Data/Point.kml</targetHref>
    <Change> 
      <Point targetId="point123">
        <coordinates>-95.48,40.43,0</coordinates>
      </Point>
    </Change>
  </Update>
</NetworkLinkControl>

Contoh <Create>

Contoh ini membuat Penanda Letak baru dalam Dokumen yang dibuat sebelumnya yang memiliki id "region24". Perlu diketahui bahwa jika Anda ingin melakukan pembaruan berikutnya untuk "placemark891", Anda akan tetap menggunakan http://myserver.com/Point.kml sebagai <targetHref>.

<Update>
  <targetHref>http://myserver.com/Point.kml</targetHref>
  <Create>
    <Document targetId="region24">
      <Placemark id="placemark891">
        <Point>
          <coordinates>-95.48,40.43,0</coordinates>
        </Point>
      </Placemark>
    </Document>
  </Create> 
</Update>

Contoh <Delete>

Contoh ini menghapus Penanda Letak yang sebelumnya dimuat ke Google Earth. (Penanda Letak ini mungkin telah dimuat langsung oleh NetworkLink dengan URL yang ditentukan, atau mungkin telah dimuat oleh Update berikutnya ke Dokumen asli.)

<Update>
  <targetHref>http://www.foo.com/Point.kml</targetHref>
  <Delete>
    <Placemark targetId="pa3556"></Placemark>
  </Delete>
</Update>

Dimuat Oleh

<NetworkLinkControl>

<Url>

Catatan: Elemen ini tidak digunakan lagi di Rilis KML 2.1 dan diganti dengan <Link>, yang memberikan fungsi tambahan Region. Tag <Url> akan tetap berfungsi di Google Earth, tetapi penggunaan tag <Link> yang lebih baru dianjurkan.

Gunakan elemen ini untuk menetapkan lokasi link ke file KML, menentukan opsi pembaruan untuk perubahan server dan pelihat, serta untuk mengisi variabel agar menampilkan informasi klien yang berguna ke server.

Kembali ke atas