Обновления

Чтобы данные, загружаемые с помощью сетевой ссылки, можно было постепенно обновлять, используется <Update> – дочерний элемент элемента <NetworkLinkControl>. Он может содержать любое количество элементов <Change>, <Create> и <Delete>, которые обрабатываются по порядку.

Последовательность событий схематически представлена ниже.

  1. Компонент NetworkLink загружает "исходный" KML-файл в Google Планету Земля. Элементу, который потребуется обновлять, необходимо присвоить идентификатор (id) уже на этапе определения. В одном файле не должно быть двух одинаковых идентификаторов.
  2. Другой компонент NetworkLink загружает второй KML-файл, содержащий обновления уже загруженных объектов KML (элементы <Change>, <Create> и <Delete> в любой комбинации). В этом файле содержатся две ссылки на исходные данные KML.
  3. Чтобы элемент <Update> мог обновить нужный объект, используется тег targetHref, содержащий ссылку на исходный файл, в котором определен этот объект. Чтобы определить объекты, подлежащие изменению, или контейнеры новых объектов, используются элементы <Change>, <Create> и <Delete> с тегом targetId, содержащим ссылки на id этих объектов.

Пример изменения

В этом примере рассматривается набор компонентов NetworkLink и KML-файлов. Чтобы запустить его, выполните указанные ниже действия.

  1. Загрузите файл Point-load.kml в Google Планету Земля. Он содержит компонент NetworkLink, который загружает исходный файл с двумя точками (Point.kml).
  2. Загрузите файл Update-load.kml в Google Планету Земля. Он содержит второй компонент NetworkLink, который загружает файл с данными обновления (с новым названием точки point123).

В первом файле содержится компонент NetworkLink, который загружает файл данных с двумя точками. Меткам, содержащим эти точки, присвоены идентификаторы. В третьем файле содержится ещё один компонент NetworkLink, добавляющий файл Update. Элемент <Change> изменяет название метки 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>

Следующий файл – Update-load.kml – содержит второй компонент NetworkLink, который загружает файл с данными обновления.

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

Последний файл – NetworkLinkControl-Update.kml – содержит данные обновления.

<?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>
<!-- координаты не меняются -->
</Placemark>
</Change> </Update>
</NetworkLinkControl>
</kml>

Наверх

Оставить отзыв о...

Текущей странице
Язык разметки Keyhole