به روز رسانی ها

برای تغییر تدریجی داده های بارگذاری شده روی NetworkLink، از عنصر Update استفاده کنید که فرزند NetworkLinkControl است. به‌روزرسانی می‌تواند حاوی هر تعداد عنصر تغییر، ایجاد و حذف باشد که به ترتیب پردازش می‌شوند.

شکل زیر توالی وقایع را نشان می دهد.

1. یک NetworkLink فایل KML "اصلی" را در Google Earth بارگیری می کند. عنصری که بعداً به‌روزرسانی می‌شود، باید زمانی که برای اولین بار مشخص شد، یک شناسه صریح تعریف شده باشد. شناسه ها باید در یک فایل مشخص منحصر به فرد باشند.
2. NetworkLink دیگری یک فایل KML دوم را بارگیری می‌کند که حاوی به‌روزرسانی‌ها (هر ترکیبی از تغییر، ایجاد، و حذف) شی (های) KML است که قبلاً بارگذاری شده‌اند. فایل به‌روزرسانی شامل دو مرجع برای شناسایی داده‌های اصلی KML است:
3. برای تعیین مکان اشیاء در Google Earth، عنصر Update از عنصر targetHref برای شناسایی فایل اصلی استفاده می‌کند که شیء(های) مورد اصلاح را تعریف کرده است. برای شناسایی شی(های) مورد اصلاح یا محفظه اشیاء جدید، عناصر Change، Create و Delete حاوی ویژگی targetId هستند که به شناسه آن اشیاء ارجاع می دهد.

تغییر مثال

مثال زیر مجموعه ای از فایل های داده های NetworkLinks و KML نمونه را نشان می دهد. برای اجرای نمونه:

1. فایل Point-load.kml را در Google Earth بارگیری کنید. این فایل حاوی NetworkLink است که فایل داده اصلی را بارگیری می کند که حاوی دو نقطه ( Point.kml ) است.
2. فایل Update-load.kml را در Google Earth بارگیری کنید. این فایل حاوی NetworkLink دوم است که فایل حاوی اطلاعات Update (نام جدیدی برای point123 ) را بارگیری می کند.

فایل اول حاوی NetworkLink است که فایل داده را بارگذاری می کند که شامل دو نقطه است. مکان‌هایی که حاوی این نقاط هستند دارای شناسه‌هایی هستند که به آنها اختصاص داده شده است. فایل سوم حاوی NetworkLink دیگری است که فایل Update را اضافه می کند. عنصر Change نام Placemark را برای point123 تغییر می‌دهد .

در اینجا چهار فایل استفاده شده در این مثال آورده شده است. ابتدا، این فایل Point-load.kml است که حاوی NetworkLink است که فایل داده اصلی را بارگیری می کند ( 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>

در اینجا فایل Point.kml است که حاوی داده های اصلی (دو نقطه) است. نقطه با شناسه "point123" نقطه ای است که ما آن را اصلاح خواهیم کرد.

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

بعد دومین فایل NetworkLink ( Update-load.kml ) است. این فایل فایلی را که حاوی اطلاعات Update است بارگیری می کند.

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

و در نهایت، اینجا فایل KML (NetworkLinkControl-Update.kml ) است که حاوی اطلاعات 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>

بازگشت به بالا