Update

Untuk mengubah data yang dimuat melalui NetworkLink secara bertahap, gunakan elemen Update, yang merupakan turunan dari NetworkLinkControl. Update dapat berisi sejumlah elemen Ubah, Buat, dan Hapus yang diproses secara berurutan.

Gambar di bawah mengilustrasikan urutan peristiwa.

  1. NetworkLink memuat file KML "asli" ke Google Earth. Elemen yang nantinya akan diperbarui harus memiliki id eksplisit yang ditentukan saat pertama kali ditentukan. ID harus unik dalam file tertentu.
  2. NetworkLink lain memuat file KML kedua yang berisi pembaruan (kombinasi dari Ubah, Buat, dan Hapus) ke objek KML yang telah dimuat. File pembaruan berisi dua referensi untuk mengidentifikasi data KML asli:
  3. Untuk menemukan objek dalam Google Earth, elemen Update menggunakan elemen targetHref untuk mengidentifikasi file asli yang menentukan objek yang akan diubah. Untuk mengidentifikasi objek yang akan diubah atau penampung untuk objek baru, elemen Ubah, Buat, dan Hapus berisi atribut targetId yang mereferensikan id objek tersebut.

Contoh Perubahan

Contoh berikut menunjukkan kumpulan contoh file data NetworkLink dan KML. Untuk menjalankan contoh:

  1. Muat file Point-load.kml ke Google Earth. File ini berisi NetworkLink yang memuat file data asli, yang berisi dua titik (Point.kml).
  2. Muat file Update-load.kml ke Google Earth. File ini berisi NetworkLink kedua, yang memuat file yang berisi data Pembaruan (nama baru untuk point123).

File pertama berisi NetworkLink yang memuat file data, yang berisi dua titik. Penanda Letak yang berisi titik-titik ini memiliki ID yang ditetapkan padanya. File ketiga berisi NetworkLink lain, yang menambahkan file Update. Elemen Perubahan memodifikasi nama Penanda Letak untuk point123.

Berikut adalah empat file yang digunakan dalam contoh ini. Pertama, ini adalah file Point-load.kml, yang berisi NetworkLink yang memuat file data asli (Point.kml). 

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLink>
  <name>Loads Point.kml</name>
  <Link>
    <href>http://developers.google.com/kml/documentation/Point.kml</href>
  </Link>
</NetworkLink>
</kml>

Berikut adalah file Point.kml, yang berisi data asli (dua titik). Titik dengan ID "point123" adalah titik yang akan kita ubah.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <Placemark id="pm123">
    <name>point123</name>
    <Point>
      <coordinates>-95.44,40.42,0</coordinates>
    </Point>
  </Placemark>
  <Placemark id="pm456">
    <name>point456</name>
	  <Point>
      <coordinates>-95.43,40.42,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Berikutnya adalah file NetworkLink kedua (Update-load.kml). File ini memuat file yang berisi informasi Pembaruan.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLink>
  <name>Update</name>
  <Link>
    <href>http://developers.google.com/kml/documentation/NetworkLinkControl-Update.kml</href></Link>
</NetworkLink>
</kml>

Terakhir, berikut adalah file KML (NetworkLinkControl-Update.kml) yang berisi informasi Update:

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLinkControl>
  <Update>
    <targetHref>http://developers.google.com/kml/documentation/Point.kml</targetHref>
    <Change>
      <Placemark targetId="pm123">
        <name>Name changed by Update Change</name>
        <!-- coordinates remain the same -->
      </Placemark>
    </Change>
  </Update>
</NetworkLinkControl>
</kml>

Kembali ke atas