Referensi KML

 |  Keyhole Markup Language  |  Google for Developers (original) (raw)

Langsung ke konten utama

Referensi KML

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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.

diagram hierarki class

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 ) untuk file yang dimuat dengan NetworkLink. ID ini juga digunakan oleh gaya bersama (lihat Pin on a mountaintop #pushpin 170.1435558771009,-43.60505741890396,0

gx:Tour Play me!

<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:duration5 10.0

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

</gx:Playlist>

Memperluas

Berisi

Sintaksis

ffffffff ff000000 ... default

Deskripsi

Menentukan cara balon deskripsi untuk penanda letak. , 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

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).

Catatan: Penggunaan elemen dalam tidak digunakan lagi. Sebagai gantinya, gunakan .

Warna latar depan untuk teks. Defaultnya adalah hitam (ff000000).

Teks yang ditampilkan dalam balon. Jika tidak ada teks yang ditentukan, Google Earth menggambar balon default (dengan Fitur dicetak tebal, Fitur , link untuk rute mobil, latar belakang putih, dan ekor yang dilampirkan ke koordinat titik Fitur, jika ditentukan).

Anda dapat menambahkan entitas ke tag 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 dengan konten tertentu, atau dengan $[description] untuk mengganti Fitur dasar .

Misalnya, dalam kutipan KML berikut, kolom $[name] dan $[description] akan diganti dengan kolom dan yang ditemukan di elemen Fitur yang menggunakan BalloonStyle ini

Jika default, Google Earth akan menggunakan informasi yang diberikan dalam untuk membuat balon . Jika sembunyikan, Google Earth tidak akan menampilkan balon. Di Google Earth, mengklik ikon Tampilan Daftar untuk Penanda Letak yang balonnya sembunyikan akan menyebabkan Google Earth terbang ke Penanda Letak.

Contoh

BalloonStyle.kml 1 BalloonStyle An example of BalloonStyle #exampleBalloonStyle -122.370533,37.823842,0

Memperluas

Dimuat Oleh

Kembali ke atas

gx:balloonVisibility

Sintaksis

gx:balloonVisibility0

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

Eiffel Tower 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>

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

balloonVisibility Example 1
<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>

Memperluas

Sintaksis

... gx:ViewerOptions

0 0 0 0 0 0 clampToGround

Deskripsi

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

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.

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

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

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 . Urutan transformasi adalah sebagai berikut:

  1. - terjemahkan di sepanjang sumbu Z ke
  2. - putar di sekitar sumbu Z.
  3. - putar pada sumbu X.
  4. - putar di sekitar sumbu Z (lagi).

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

Elemen Khusus Kamera

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 kamera virtual. Derajat utara atau selatan Khatulistiwa (0 derajat). Nilainya berkisar dari 90 derajat hingga 90 derajat.

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

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

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 menunjukkan bahwa tampilan mengarah ke arah cakrawala. Nilai yang lebih besar dari 90 menunjukkan bahwa tampilan mengarah ke langit. Nilai untuk dikunci pada +180 derajat.

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

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

gx:ElevationMode

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

Memperluas

Dimuat Oleh

Kembali ke atas

<_WarnaGaya_>

Sintaksis

<!_-- ColorStyle_ id="ID" --> ffffffff normal

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

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.

Nilai untuk bersifat normal (tidak ada efek) dan acak. Nilai random menerapkan skala linear acak ke dasar sebagai berikut.

Memperluas

Diperluas Oleh

Kembali ke atas

<_Penampung_>

Sintaksis

... 1 0

...
...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... atom:author...atom:author <atom:link href=" "/>

<!-- /_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

Diperluas Oleh

Kembali ke atas

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

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:

  1. Menentukan semua Gaya dalam Dokumen. Tetapkan ID unik untuk setiap Gaya.
  2. Dalam Feature atau StyleMap yang diberikan, referensikan ID Gaya menggunakan elemen .

Perhatikan bahwa gaya bersama tidak diwarisi oleh Fitur dalam Dokumen.

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

<styleUrl#myPrettyDocument"> ...

Jangan tempatkan gaya bersama dalam Folder.

Contoh berikut menggambarkan penggunaan gaya bersama.

Contoh

**** Document.kml 1 Document Feature 1 #exampleStyleDocument -122.371,37.816,0 Document Feature 2 #exampleStyleDocument -122.370,37.817,0 ****

Memperluas

Berisi

Kembali ke atas

gx:durasi

Sintaksis

gx:duration0.0

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:flyToModebounce gx:duration10.2

...

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:duration5.0

....

Sintaksis

                       

  ...   
   ...               

...   
<namespace_prefix:other>...

Deskripsi

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

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

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 , notasi $[name/displayName] diganti dengan . Jika Anda mengganti nilai atribut name dari elemen dalam format ini (misalnya, $[holeYardage], nilai atribut akan diganti dengan . Secara default, balon Penanda Letak menampilkan pasangan nama/nilai yang terkait dengannya.

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

Nilai pasangan data.

Club house 1 234 4

Elemen ini digunakan bersama dengan 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.

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"

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

Elemen ini menetapkan nilai ke kolom data kustom yang diidentifikasi oleh atribut name. Jenis dan nama kolom data kustom ini dideklarasikan dalam elemen .

Berikut contoh cara menentukan dua elemen data kustom:

Easy trail Pi in the sky 3.14159 10 -122.000,37.002 Difficult trail Mount Everest 347.45 10000 -122.000,37.002

<namespace_prefix:other>

Dengan elemen ini, Anda dapat menambahkan data kustom tanpa jenis. Pastikan untuk mereferensikan awalan namespace di elemen file Anda atau sebagai atribut elemen 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":

14 2 4

Dimuat Oleh

Lihat Juga

<_Fitur_>

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...
<-- /_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

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

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

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 . 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 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).

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

untuk menentukan lokasi titik, bukan menggunakan koordinat lintang dan bujur. (Namun, jika diberikan, akan lebih diutamakan daripada
.) 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

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

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, lihathttp://www.schemas.org/RFC /RFC2806.txt.

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

Konten yang disediakan pengguna yang muncul di balon deskripsi.

Konten yang didukung untuk elemen 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 .

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

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

Perilaku Lain yang Ditentukan Melalui Penggunaan Elemen

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

Elemen anchor 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:

Atribut type digunakan dalam elemen 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:

Menentukan sudut pandang yang terkait dengan elemen apa pun yang berasal dari Fitur. Lihat dan .

Mengaitkan Fitur ini dengan jangka waktu tertentu () atau titik waktu ().

URL Placemark #sn_blue-dot_copy3 -93.47875999999999,45.083248,0

Memperluas

Diperluas Oleh

gx:TerbangKe

Sintaksis

<gx:FlyTo id="ID"> gx:duration0.0 gx:flyToModebounce ...

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:duration2.55
gx:flyToModesmooth

-113.084448
36.567081
41277.571403
116.150227
absolute

Memperluas

Berisi

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

**</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

**** Folder.kml 1 A folder is a container that can hold multiple other objects Folder object 1 (Placemark) -122.377588,37.830266,0 Folder object 2 (Polygon) -122.377830,37.830445,0 -122.377576,37.830631,0 -122.377840,37.830642,0 -122.377830,37.830445,0 Folder object 3 (Path) 1 -122.378009,37.830128,0 -122.377885,37.830379,0 ****

Memperluas

Berisi

<_Geometri_>

Sintaksis

<!_-- Geometry_ id="ID" --> <!-- /_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

Diperluas Oleh

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

ffffffff 0 ...

0 clampToGround ... <! kml:angle90 --> ... <! kml:angle90 --> ... <! kml:angle180 --> ... <! kml:angle180 --> 0 <! kml:angle180 --> gx:LatLonQuad ...

Deskripsi

Elemen ini menggambar overlay gambar yang ditampilkan ke medan. Anak dari 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 , persegi panjang akan digambar menggunakan batas warna dan LatLonBox yang ditentukan oleh overlay bumi.

Elemen Khusus untuk GroundOverlay

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

Menentukan cara 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 sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, akan ditafsirkan sebagai berada di atas tanah.
  • clampToSeaFloor - Spesifikasi diabaikan, dan overlay akan tertutup di atas dasar laut. Jika titik berada di darat dan bukan di laut, overlay akan diposisikan di tanah.

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

  • Menentukan garis lintang tepi utara kotak pembatas, dalam derajat desimal dari 0 hingga ±90.
  • Menentukan garis lintang tepi selatan kotak pembatas, dalam derajat desimal dari 0 hingga ±90.
  • 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.)
  • 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.)
  • Menentukan rotasi overlay di sekitar pusatnya, dalam derajat. Nilainya bisa ±180. Default-nya adalah 0 (utara). Rotasi ditentukan dalam arah berlawanan arah jarum jam.

48.25475939255556 48.25207367852141 -90.86591508839973 -90.8714285289695 39.37878630116985

gx:LatLonQuad

Digunakan untuk overlay bumi segi empat non-persegi panjang.

Contoh

**** GroundOverlay.kml 7fffffff 1 http://www.google.com/intl/en/images/logo.gif onInterval 86400 0.75 37.83234 37.832122 -122.373033 -122.373724 45 ****

Memperluas

Dimuat Oleh

Sintaksis

... gx:x0gx:x/ gx:y0gx:y/ gx:w-1gx:w/ gx:h-1gx:h/ onChange 4 never 4 1 ... ...

Deskripsi

Menentukan gambar yang terkait dengan gaya Ikon atau overlay. Elemen turunan 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.

Sunset.jpg

/home/mydir/myiconpalette.jpg 138 138

Elemen Khusus untuk Ikon

Alamat HTTP atau spesifikasi file lokal yang digunakan untuk memuat ikon.

<gx.x>

dan

gx:y

Jika 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

dan

gx:j

Jika menentukan palet ikon, elemen ini menentukan lebar (gx:w) dan tinggi (gx:h), dalam piksel, dari ikon yang akan digunakan.

Untuk deskripsi dan elemen lain yang tercantum di bawah, lihat .

Dimuat Oleh

Sintaksis

ffffffff normal

1 0 ...

Deskripsi

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

Elemen Khusus untuk IconStyle

Mengubah ukuran ikon.

Catatan: Tag tidak digunakan lagi. Gunakan sebagai gantinya.

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

Ikon kustom. Di , satu-satunya elemen turunan adalah :

  • : Alamat HTTP atau spesifikasi file lokal yang digunakan untuk memuat ikon.

Menentukan posisi dalam Ikon yang "ditambatkan" ke 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

IconStyle.kml #randomColorIcon -122.36868,37.831145,0

Memperluas

Dimuat Oleh

Berisi

  • sebagai turunan dari

Sintaksis

...

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 juga dapat menyertakan namespace untuk skema XML eksternal apa pun yang dirujuk dalam file.

Elemen dasar berisi 0 atau 1 Fitur dan 0 atau 1 NetworkLinkControl:

...

Sintaksis

ffffffff normal

1

Deskripsi

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

Catatan: Tag tidak digunakan lagi. Gunakan sebagai gantinya.

Khusus untuk

Mengubah ukuran label.

Contoh

LabelStyle.kml #randomLabelColor -122.367375,37.829192,0

Memperluas

Dimuat Oleh

gx:LatLonQuad

Sintaksis

... ... 0 clampToGround

gx:LatLonQuad ...

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

<kml xmlns="http://www.opengis.net/kml/2.2" **xmlns:gx="" title="undefined" rel="noopener noreferrer">http://www.google.com/kml/ext/2.2"**> gx:LatLonQuad Example http://developers.google.com/kml/documentation/images/rectangle.gif 0.75 gx:LatLonQuad 81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015

Memperluas

Dimuat oleh

Sintaksis

gx:altitudeOffset0 0 0 clampToGround ...

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 yang digunakan sebagai batas dalam.

Catatan: Di Google Earth, Poligon dengan dari clampToGround mengikuti garis bantalan konstan; namun, LinearRing (dengan sendirinya) dengan 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.

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.

Nilai Boolean. Menentukan apakah akan mengizinkan LinearRing mengikuti medan. Untuk mengaktifkan tessellation, nilai untuk 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).

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

  • clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, dalam tag ).
  • 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 sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, akan ditafsirkan sebagai berada di atas tanah.
  • clampToSeaFloor - Spesifikasi diabaikan, dan titik akan diposisikan di dasar laut. Jika titik tersebut berada di darat, bukan di laut, titik akan diposisikan di daratan.

(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

LinearRing.kml **** -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 ****

Memperluas

Dimuat Oleh

Sintaksis

gx:altitudeOffset0 0 0 clampToGround gx:drawOrder0 ... <!_--_ lon,lat[,alt] -->

Deskripsi

Menentukan kumpulan segmen garis yang terhubung. Gunakan 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.

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.

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).

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

  • clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag ).
  • 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 sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, akan ditafsirkan sebagai berada di atas tanah.
  • clampToSeaFloor - Spesifikasi 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 saat garis dua warna saling bersilangan.

(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

LineString.kml 1 -122.36415 37.824553 0 150 50 0 unextruded 1 1 -122.364383,37.824664,0 -122.364152,37.824322,0 extruded **** 1 1 relativeToGround -122.364167,37.824787,50 -122.363917,37.824423,50 ****

Memperluas

Dimuat Oleh

Sintaksis

ffffffff normal

1 gx:outerColorffffffff gx:outerWidth0.0 gx:physicalWidth0.0 gx:labelVisibility0

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

Lebar garis, dalam piksel.

gx:outerColor

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

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.

LineStyle.kml 1 LineStyle Example #linestyleExample 1 1 -122.364383,37.824664,0 -122.364152,37.824322,0

Memperluas

Dimuat Oleh

Sintaksis

... onChange 4 never 4 1 BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]<**/**viewFormat> ...

Deskripsi

menentukan lokasi salah satu dari hal berikut:
  • File KML yang diambil oleh link jaringan
  • File gambar yang digunakan dalam Overlay (elemen menentukan gambar dalam Overlay; memiliki kolom yang sama dengan )
  • File model yang digunakan dalam elemen

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 ( dan ) dan satu didasarkan pada view "kamera" saat ini ( dan ). Selain itu, Link menentukan apakah akan menskalakan parameter kotak pembatas yang dikirim ke server ( 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 atau (b) parameter kotak pembatas (ini merupakan default dan digunakan jika tidak ada elemen yang disertakan dalam file).
  • string format kedua yang ditentukan dalam elemen .

Jika file yang ditentukan dalam adalah file lokal, elemen dan tidak akan digunakan.

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

Elemen Khusus untuk Penautan

URL (baik alamat HTTP maupun spesifikasi file lokal). Jika induk adalah NetworkLink, adalah file KML. Jika induk adalah Model, adalah file COLLADA. Jika induk (kolom yang sama dengan ) adalah Overlay, 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.

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 ).
  • onExpire - muat ulang file saat waktu habis masa berlaku tercapai. Jika file yang diambil memiliki NetworkLinkControl, waktu akan lebih diprioritaskan daripada waktu habis masa berlaku yang ditentukan di header HTTP. Jika waktu 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.)

Mengindikasikan untuk memuat ulang file setiap n detik.

Menentukan cara link dimuat ulang saat "kamera" berubah.

Dapat berupa salah satu opsi berikut:

  • never (default) - Mengabaikan perubahan dalam tampilan. Selain itu, abaikan parameter , jika ada.
  • onStop - Memuat ulang file n detik setelah gerakan berhenti, dan n ditentukan dalam .
  • 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 .

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

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.

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

Jika Anda menentukan dari onStop dan tidak menyertakan tag 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 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
  • [lookatRange], [lookatTilt], [lookatHeading] - nilai-nilai yang digunakan oleh elemen (lihat deskripsi , , dan pada )
  • [lookatFieldLon], [lookatFieldLat], [lookatFieldAlt] - titik di medan dalam derajat/meter yang sedang 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

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

NE US Radar 1 **** http://www.example.com/geotiff/NE/MergedReflectivityQComposite.kml onInterval 30 onStop 7 BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth];CAMERA=\ [lookatLon],[lookatLat],[lookatRange],[lookatTilt],[lookatHeading];VIEW=\ [horizFov],[vertFov],[horizPixels],[vertPixels],[terrainEnabled] ****

Memperluas

Dimuat Oleh

Lihat Juga

Sintaksis

check ffffffff open ...

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

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.

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.

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:

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).

Menentukan URI gambar yang digunakan dalam Tampilan Daftar untuk Fitur.

Contoh

ListStyle.kml 1 ListStyle Examples 1 bgColor example 1 pl1 -122.362815,37.822931,0 pl2 -122.362825,37.822931,0 pl3 -122.362835,37.822931,0 #bgColorExample checkHideChildren example 1 pl4 -122.362845,37.822941,0 pl5 -122.362855,37.822941,0 pl6 -122.362865,37.822941,0 #checkHideChildrenExample radioFolder example 1 pl7 -122.362875,37.822951,0 pl8 -122.362885,37.822951,0 pl9 -122.362895,37.822951,0 #radioFolderExample

Memperluas

Dimuat Oleh

Sintaksis

... gx:ViewerOptions

0 0 0 0 0 clampToGround

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

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.

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

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

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

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

(wajib ada)

Jarak dalam meter dari titik yang ditentukan oleh , , dan ke posisi LookAt. (Lihat diagram di bawah.)

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

  • clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi dan menempatkan posisi LookAt di permukaan.
  • relativeToGround - Menafsirkan sebagai nilai dalam meter di atas permukaan tanah.
  • absolute - Menafsirkan 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 sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, akan ditafsirkan sebagai berada di atas tanah.
  • clampToSeaFloor - Spesifikasi 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 , , dan :

Diagram ini menggambarkan elemen :

Timur=90, Selatan=180, Barat=270

LookAt.kml **** 1994 -122.363 37.81 2000 500 45 0 relativeToGround **** -122.363,37.82,0

Memperluas

Dimuat Oleh

Sintaksis

clampToGround 0 0 0 0 1 1 1 ... ... ...

Deskripsi

Objek 3D yang dijelaskan dalam file COLLADA (direferensikan dalam tag ). 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

Menentukan cara yang ditentukan di ditafsirkan. Nilai yang memungkinkan adalah sebagai berikut:

  • clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi dan menempatkan Model di permukaan.
  • relativeToGround - Menafsirkan sebagai nilai dalam meter di atas permukaan tanah.
  • absolute - Menafsirkan 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 sebagai nilai dalam meter di atas dasar laut. Jika titik di atas daratan dan bukan laut, akan ditafsirkan sebagai berada di atas tanah.
  • clampToSeaFloor - Spesifikasi diabaikan, dan Model akan diposisikan di dasar laut. Jika titik berada di darat dan bukan di laut, Model akan diposisikan di darat.

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 atau gx:heightMode.

39.55375305703105 -118.9813220168456 1223

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

45.0 10.0 0.0

Rotasi diterapkan ke Model dalam urutan berikut:

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.

Rotasi sekitar sumbu x. Rotasi positif searah jarum jam di sekitar sumbu x dan ditentukan dalam derajat dari 0 hingga 180.

Rotasi tentang sumbu y. Rotasi positif searah jarum jam di sekitar sumbu y dan ditentukan dalam derajat dari 0 hingga 180.

arah tujuan, kemiringan, dan gulungan ditentukan searah jarum jam saat melihat sumbu ke bawah terhadap asal

Diagram ini mengilustrasikan orientasi standar sumbu model:

Untuk model standar, +x berada di sebelah kanan, +y berada di bagian depan dan diorientasikan Utara, dan +z berada di atas

<Skala>

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


2.5
2.5
3.5

Menentukan file yang akan dimuat dan parameter refresh opsional. Lihat .

Menentukan 0 atau beberapa elemen , 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 dapat berisi beberapa pemetaan dari file Collada yang berbeda (sumber) ke file KMZ yang sama (target).

../images/foo.jpg c:\mytextures\foo.jpg

berisi pemetaan dari ke :

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).

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


relativeToGround

39.55375305703105
-118.9813220168456
1223


45.0
10.0
0.0


1.0
1.0
1.0


house.dae
once



../files/CU-Macky---Center-StairsnoCulling.jpg
CU-Macky---Center-StairsnoCulling.jpg


../files/CU-Macky-4sideturretnoCulling.jpg
CU-Macky-4sideturretnoCulling.jpg


../files/CU-Macky-Back-NorthnoCulling.jpg
CU-Macky-Back-NorthnoCulling.jpg


Memperluas

Dimuat Oleh

Sintaksis

Deskripsi

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

Catatan: Tag tidak digunakan lagi. Sebagai gantinya, gunakan .

Elemen Khusus untuk MultiGeometri

  • 0 atau beberapa elemen

Contoh

SF Marina Harbor Master 0 **** -122.4425587930444,37.80666418607323,0 -122.4428379594768,37.80663578323093,0 -122.4425509770566,37.80662588061205,0 -122.4428340530617,37.8065999493009,0 ****

Memperluas

Dimuat Oleh

gx:MultiTrack

Sintaksis

<gx:MultiTrack id="ID"> clampToGround gx:interpolate0gx:interpolate gx:Track...

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

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

0 0 ...

Deskripsi

Mereferensikan file KML atau arsip KMZ pada jaringan lokal atau jarak jauh. Gunakan elemen 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.

<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 yang ditetapkan ke 1 dan NetworkLink memiliki 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 dalam file yang dimuat ulang. Jika elemen tidak memiliki LookAt atau Kamera yang ditentukan, tampilannya tidak akan berubah. Misalnya, Google Earth akan terbang ke tampilan Dokumen induk, bukan Penanda yang terdapat dalam Dokumen.

_(wajib diisi)_

Tips: Untuk menampilkan Folder atau Dokumen tingkat atas dalam Network Link di Tampilan Daftar, tetapkan ID ke Folder atau Dokumen. Tanpa ID ini, hanya nama objek turunan yang akan ditampilkan dalam Tampilan Daftar.

Contoh

1 **** NE US Radar 1 1 ...****

Memperluas

Dimuat Oleh

Sintaksis

0 -1 ... ... ... ... ... ... ... ...

Deskripsi

Mengontrol perilaku file yang diambil oleh .

Elemen Khusus untuk NetworkLinkControl

Ditentukan dalam detik, 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.

Ditentukan dalam detik, adalah jumlah waktu maksimum bagi NetworkLink klien untuk dapat tetap terhubung. Nilai default -1 menunjukkan untuk tidak menghentikan sesi secara eksplisit.

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.

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.

Anda dapat mengontrol nama link jaringan dari server, sehingga perubahan yang dibuat pada nama di sisi klien akan diganti oleh server.

Anda dapat mengontrol deskripsi link jaringan dari server, sehingga perubahan yang dibuat pada deskripsi di sisi klien akan diganti oleh server.

Anda dapat mengontrol cuplikan untuk link jaringan dari server, sehingga perubahan yang dibuat pada cuplikan di sisi klien akan diganti oleh server. memiliki atribut maxLines, bilangan bulat yang menentukan jumlah baris maksimum yang akan ditampilkan.

Anda dapat menentukan tanggal/waktu untuk memperbarui link. Spesifikasi ini hanya berlaku jika di memiliki nilai onExpire. Lihat

Dengan , Anda dapat menentukan sejumlah tag Ubah, Buat, dan Hapus untuk file .kml atau arsip .ASPMX yang sebelumnya telah dimuat dengan link jaringan. Lihat .

Contoh

This is a pop-up message. You will only see this once cookie=sometext New KML features

Memperluas

  • Ini adalah turunan langsung dari elemen .

Dimuat Oleh

Lihat Juga

<_Objek_>

Sintaksis

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 akan digunakan.

<_Overlay_>

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

ffffffff 0 ... <!-- /_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. 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

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 tidak digunakan lagi. Gunakan sebagai gantinya.

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

Menentukan gambar yang terkait dengan Overlay. Elemen 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 , persegi panjang akan digambar menggunakan warna dan ukuran yang ditentukan oleh overlay bumi atau layar.

icon.jpg

Memperluas

Diperluas Oleh

Sintaksis

_..._ 1 0 ...
_..._
... ... _..._ _..._ _..._ <_TimePrimitive_>... _..._ <_StyleSelector>..._ ... ... ...

ffffffff 0 ... ...

0 0 0 0 0 0 256 ... ... lowerLeft ... rectangle

Deskripsi

Elemen 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 berasal dari , elemen ini dapat berisi salah satu dari dua elemen yang berasal dari —baik atau . 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 , yang diwarisi dari . Tag harus berisi elemen yang menentukan file gambar yang akan digunakan untuk PhotoOverlay. Untuk gambar berukuran sangat besar, 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

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

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.

Sudut, dalam derajat, antara arah kamera dan sisi kiri volume tampilan.

Sudut, dalam derajat, antara arah kamera dan sisi kanan volume tampilan.

Sudut, dalam derajat, antara arah kamera dan sisi bawah volume tampilan.

Sudut, dalam derajat, antara arah kamera dan sisi atas volume tampilan.

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:

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 dalam elemen untuk menyertakan spesifikasi ubin mana yang akan dimuat.

Ukuran ubin, dalam piksel. Ubin harus berbentuk persegi, dan harus pangkat 2. Ukuran ubin 256 (default) atau 512 disarankan. Gambar asli akan dibagi menjadi ubin dengan ukuran ini, pada berbagai resolusi.

Lebar piksel gambar asli.

Tinggi piksel gambar asli.

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.

Elemen berfungsi sebagai di dalam elemen . Gambar ikon untuk menandai posisi PhotoOverlay. Ikon yang digambar ditentukan oleh kolom dan , seperti pada .

PhotoOverlay diproyeksikan ke . 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

A simple non-pyramidal photo High above the ocean small-photo.jpg 1000 -60 60 -45 45 1,1

Memperluas

Dimuat Oleh

  • , , atau

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

...

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

Contoh

Google Earth - New Placemark Some Descriptive text. -90.86879847669974 48.25330383601299 440.8 8.3 2.7 -90.86948943473118,48.25450093195546,0

Memperluas

Dimuat Oleh

Lihat Juga

Sintaksis

0 clampToGround ...

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

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

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

  • clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag ).
  • 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.

(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

-90.86948943473118,48.25450093195546

Memperluas

Dimuat Oleh

Sintaksis

0 0 clampToGround ... ...

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 untuk warna, mode warna, dan isian.

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.

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

Elemen Khusus untuk Poligon

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.

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

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

  • clampToGround - (default) Menunjukkan untuk mengabaikan spesifikasi ketinggian (misalnya, di tag ).
  • 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 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.

(wajib)

Berisi elemen .

Berisi elemen . Poligon dapat berisi beberapa elemen , yang membuat beberapa potongan di dalam Poligon.

Contoh

Polygon.kml 0 hollow box 1 relativeToGround -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 -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

Memperluas

Dimuat Oleh

Sintaksis

ffffffff normal

1 1

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

Nilai Boolean. Menentukan apakah akan mengisi poligon.

Nilai Boolean. Menetapkan apakah akan menggarisbawahi poligon atau tidak. Garis luar poligon menggunakan LineStyle saat ini.

Contoh

PolygonStyle.kml 1 hollow box #examplePolyStyle 1 relativeToGround -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 -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

Memperluas

Dimuat Oleh

Sintaksis

0 0 clampToGround 0 -1 0 0

Deskripsi

Sebuah wilayah berisi kotak pembatas () yang mendeskripsikan area minat yang ditentukan oleh koordinat dan ketinggian geografis. Selain itu, Region berisi tingkat LOD (level detail) () 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 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

(wajib ada)

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

atau gx:heightMode

Nilai yang mungkin untuk adalah clampToGround, relativeToGround, dan absolute. Nilai yang mungkin untuk gx:heightMode adalah clampToSeaFloor dan relativeToSeaFloor. Lihat juga .

Ditentukan dalam meter (dan dipengaruhi oleh spesifikasi mode ketinggian).

Ditentukan dalam meter (dan dipengaruhi oleh spesifikasi mode ketinggian).

(wajib diisi)

Menentukan garis lintang tepi utara kotak pembatas, dalam derajat desimal dari 0 hingga ±90.

(wajib)

Menentukan garis lintang tepi selatan kotak pembatas, dalam derajat desimal dari 0 hingga ±90.

(wajib diisi)

Menentukan bujur tepi timur kotak pembatas dalam derajat desimal dari 0 hingga ±180.

(wajib diisi)

Menentukan bujur tepi barat kotak pembatas, dalam derajat desimal dari 0 hingga ±180.


43.374
42.983
-0.335
-1.423
0
0

Lod adalah singkatan dari Level of Detail. 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.


256
-1
0
0

<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

50.625 45 28.125 22.5 10 50 128 1024 128 128

Memperluas

Dimuat Oleh

Sintaksis

...

Deskripsi

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

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.

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

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

Contoh

Memperluas

Ini adalah elemen root.

Dimuat Oleh

Lihat Juga

Sintaksis

... 1 0 atom:author...atom:author <atom:link href=" "/>

...
xal:AddressDetails...
...
... ... ... <TimePrimitive_>...</_TimePrimitive_> ... <_StyleSelector>... ... ... ...

ffffffff 0 ...

0 ****

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 . Pemosisian overlay ditangani dengan memetakan titik dalam gambar yang ditentukan oleh ke titik di layar yang ditentukan oleh . Kemudian, gambar diputar oleh derajat di sekitar titik yang relatif terhadap layar yang ditentukan oleh .

Anak dari 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 , persegi panjang akan digambar menggunakan warna dan ukuran yang ditentukan oleh overlay layar.

Elemen Khusus untuk ScreenOverlay

Menentukan titik di (atau di luar) gambar overlay yang dipetakan ke koordinat layar (). 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.

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:

Tempatkan gambar di kiri atas:

Tempatkan gambar di sebelah kanan layar:

Titik relatif ke layar tempat overlay layar diputar.

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:

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

Untuk memaksa gambar diubah ukurannya menjadi 100 x 500 piksel:

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 , jika tidak (.5,.5), ditentukan dalam .

Contoh

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

Simple crosshairs This screen overlay uses fractional positioning to put the image in the exact center of the screen http://myserver/myimage.jpg 39.37878630116985

Memperluas

Dimuat Oleh

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 dan harus memiliki id yang ditentukan untuk gaya tersebut agar dapat direferensikan oleh Fitur individual yang menggunakannya.

Gunakan id untuk merujuk ke gaya dari .

Contoh

**** Google Earth - New Polygon Here is some descriptive text #myDefaultStyles . . . Google Earth - New Path #myDefaultStyles . . . .

Memperluas

Dimuat Oleh

Elemen Khusus untuk Gaya

Sintaksis

normal ... or

Deskripsi

memetakan antara dua Gaya yang berbeda. Biasanya elemen 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

(wajib)

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

  • , yang mengidentifikasi kunci
  • atau **** normal #normalState highlight #highlightState **** StyleMap example #styleMapExample -122.368987,37.817634,0

    Memperluas

    Dimuat Oleh

    <_PemilihPilih_>

    Sintaksis

    Deskripsi

    Ini adalah elemen abstrak dan tidak dapat digunakan secara langsung di file KML. Ini adalah jenis dasar untuk elemen