Формат kml-файлов геозон в FM3
FortMonitor поддерживает возможность импорта и экспорта геозон в формате kml. Но если вы импортируете файл из другой системы, либо же просто добавляете зоны из рукописного файла, его содержание должно подходить под формат, используемый в системе. В этой статье мы разберём файлы экспорта и импорта на конкретных примерах. Файлы можно редактировать в любом текстовом редакторе, например notepad++.
Разберём общее строение на конкретном примере геозоны типа "точка".
Файл содержит следующие теги:
- ?xml version="1.0" encoding="utf-8"? - тип, версия и кодировка.
- kml - формат файла, служебный тег.
- Document - содержание файла, служебный тег.
- Placemark - "метка", данные всех отдельных геозон, вложенных в файл, должны быть ограничены этим тегом.
- name - имя геозоны.
- description [параметры]=" " - здесь прописаны следующие параметры зоны:
- addr=" " - использование зоны в качестве адреса, возможны варианты "1" и "0", соответственно использовать или нет.
- width=" " - радиус геозоны "точка". Для других геозон этот тег не указывается.
- ride_begin="0" и ride_end="0" - служебные теги, могут отсутствовать.
- Point - конкретно здесь указание на тип геозоны "точка". Другие типы рассмотрим далее.
- coordinates - собственно координаты точки.
Важно соблюдать структуру документа и вложенность тегов, иначе попытка импорта зон приведёт к ошибке. Сведенья об ошибке будут указаны в логах работы сервера в панели администратора.
Линия.
Здесь появляется тег Style, который отвечает за отображение в интерфейсе FortMonitor и включает в себя:
- LineStyle - указание на тип "линия"
- color - цвет в интерфейсе мониторинга
- width - ширина геозоны
Далее Style закрывается и идёт LineString, который указывает, что в нём прописаны координаты, выстроенные последовательно в линию. Далее в теге coordinates идут сами координаты, где широта и долгота разделены запятой, а пары широта+долгота - пробелом.
Многоугольник.
Здесь мы видим тот же Style, и вложенные в него теги:
- PolyStyle - тип "многоугольник
- color - цвет в интерфейсе мониторинга
Далее идут теги:
- Polygon - полигональная зона
- outerBoundaryIs - с внешними границами
- LinearRing - координаты закольцованы
- coordinates - собственно координаты
Файл может содержать несколько зон разных типов, данные по этим зонам должны быть закрыты в теге Placemark. Как пример, скрин файла с тремя вышеуказанными зонами.
Оригинал файла для собственных экспериментов можно скачать по ссылке.
Повторюсь, очень важно соблюдать структуру документа и вложенность тегов. Но пробелы и переносы строк между тегами (не в самих тегах, как в случае с coordinates) в принципе выполняют чисто косметические функции, так код удобнее читать. В некоторых случаях рабочий файл может выглядеть и так:
