Часто задаваемые вопросы о KML

KML – это формат файлов, который используется для отображения географических данных в геобраузерах, таких как Google Планета Земля, Google Карты и Google Карты для мобильных устройств. С помощью KML-файлов можно добавлять на карту метки или наложенные изображения и отображать расширенные географические данные. KML является международным стандартом, поддерживаемым организацией Open Geospatial Consortium (OGC).

Сообщество KML весьма разнообразно. Чтобы в этом убедиться, достаточно посетить форум сообщества Google Планеты Земля. Обычные пользователи с помощью KML могут обозначать на карте свои дома, маршруты пеших или велосипедных путешествий. Ученым KML позволяет создавать подробные карты минеральных ресурсов, моделировать вулканические извержения, землетрясения, движение воздушных масс и другие природные явления. Риелторам, архитекторам и специалистам по градоустройству KML помогает представлять планы и строительные проекты. Учащиеся и преподаватели используют KML для проведения демографических исследований, а также наглядной демонстрации исторических и современных мест и событий. Такие организации, как National Geographic, ЮНЕСКО и Смитсоновский институт отображают с помощью KML специализированную информацию.

KML-можно создать тремя способами, которые описаны ниже.

• В интерфейсе Google Планеты Земля. Это самый удобный инструмент для создания KML-файлов, позволяющий добавлять следующие компоненты:
  
  • метки;
  • пути;
  • многоугольники;
  • накладываемые изображения;
  • сетевые ссылки;
  • модели;
  • папки с перечисленными выше объектами;
  • накладываемые фото.

Создайте один из перечисленных объектов, выберите его в панели "Метки" и нажмите "Копировать". Скопированное содержание затем можно вставить в текстовый редактор или редактор XML.

• В текстовом редакторе. Создав объект в интерфейсе Google Планеты Земля, скопируйте его в текстовый редактор для дальнейшей работы.
• В редакторе XML. KML – это язык разметки для описания географической информации, основанный на XML. Редакторы XML предлагают богатые возможности формирования XML-документов, включая такую полезную функцию, как дополнение закрывающих тегов.

Существует также множество инструментов, созданных участниками сообщества Google Планеты Земля. Посетите группу поддержки KML-разработчиков.

KMZ-файл – это архив, состоящий из одного или нескольких файлов, предназначенных для отображения в Google Планете Земля. Файлы сжимаются в формате ZIP и могут быть распакованы с помощью любого ZIP-архиватора, такого как WinZip, 7-Zip, инструмента Windows XP Compressed Folders Tool (в ОС Windows), Stuffit (в Mac OS) или команды zip (в Mac OS или Linux). Чтобы открыть файлы с помощью ZIP-архиватора, может потребоваться изменить расширение пакета с KMZ на ZIP. Не забудьте снова присвоить файлу расширение KMZ, прежде чем загружать его в геобраузер.

В KML-файл можно включить астрономические данные для загрузки в Google Небо или Microsoft WorldWide Telescope. Подробные сведения приведены в статье Данные Google Неба в KML.

Google Планета Земля поддерживает абсолютно все теги, предусмотренные в KML. Их список можно найти в Спецификации KML.

Google Карты поддерживают некоторые теги KML.

Руководство разработчика опубликовано по адресу https://developers.google.com/kml/documentation/topicsinkml.html.

Если для компонента LineString задано значение высоты clampToGround, он всегда остается на земной поверхности. Если же задано значение relativeToGround, может потребоваться добавить дополнительные точки, поскольку слишком длинные прямые отрезки пересекаются с рельефом местности.

Приведем пример кода для компонента LineString: отрезки определенной им прямой линии будут скрыты под землей.

<kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <name>Untitled Path</name>
    <LineString>
      <tessellate>0</tessellate>
      <altitudeMode>absolute</altitudeMode>
      <coordinates>-115.415105,40.669016 -37.752364,34.879979</coordinates>
    </LineString>
  </Placemark>
</kml>

Если добавить дополнительные точки, под землю будет уходить меньше линий. Чтобы линия копировала рельеф местности, установите для поля <tessellate> значение 1.

<Placemark>
  <name>Untitled Path</name>
  <LineString>
    <tessellate>1</tessellate>
    <altitudeMode>relativeToGround</altitudeMode>
    <coordinates>
      -134.148103,37.752967 -128.917074,38.803008
      -125.166954,39.583592 -122.137625,39.656880
      -120.421783,40.036311 -118.298157,40.235316
      -114.348386,40.631532 -112.670431,40.761033
      -111.916045,40.681939 -110.177711,40.653055
      -109.544331,40.619327 -107.155697,40.642007
      -105.410526,40.421505 -103.192299,40.430138
      -102.853712,40.427904 -98.168302,40.363524
      -97.093391,40.308754 -94.831304,40.479175
      -93.760070,40.395392 -84.913828,39.466651
      -84.414888,39.387332 -81.380660,39.188551
      -80.276261,38.977744 -77.811560,38.872542
      -75.062267,38.521146 -72.006956,38.101733
      -66.67819,37.664687
    </coordinates>
  </LineString>
</Placemark>

В KML не предусмотрена геометрия круга, однако с помощью ломаных линий (компонентов LineString) можно создать нечто подобное (см. пример).

Элемент <LineStyle> позволяет менять цвет, прозрачность и толщину линий, однако на данный момент KML не позволяет менять их тип.

Ярлыки, отображаемые рядом с метками в Google Планете Земля, задаются с помощью тегов <name>. Если установить для элемента <LabelStyle> значение 0, ярлык будет скрыт.

<Style id="hideLabel">
  <LabelStyle>
    <scale>0</scale>
  </LabelStyle>
</Style>

Ошибки синтаксического анализа обычно возникают по одной из двух причин.

1. Неверный регистр. В KML, как и во всех языках на основе XML, различаются строчные и заглавные буквы. Таким образом, все элементы должны быть записаны с учетом регистра: <Placemark>, а не <PLACEMARK>; <href>, а не <Href>; <Link>, а не <lInk> и т. д.
2. Незакрытые теги. Иногда авторы кода забывают закрывать теги или пропускают угловую скобку (< или >).
   Примеры:
   <name>Омск</name> – верно;
   <name>Омск – неверно;
   <nameОмск</name> – неверно;
   <nameОмск<name> – неверно.

KML – это язык разметки на основе XML. Проверить правильность XML-кода можно несколькими способами.

• Функции валидации в редакторе XML, таком как Oxygen или Netbeans. Ознакомьтесь с документацией к выбранному редактору. Чтобы проверить код, потребуется схема KML.
• Онлайн-валидатор, например FeedValidator.org, или KML Validator от Galdos, который укажет на ошибки и предложит варианты их исправления.
• Функции валидации XML-кода в некоторых текстовых редакторах (например, jEdit предлагает такую возможность). Ознакомьтесь с учебником, разработанным в рамках Просветительской программы Google Планеты Земля.

Для этих целей используются регионы (компоненты Region). Рекомендуем ознакомиться со следующими ресурсами:

• Глава "Регионы" в Руководстве разработчика
• Раздел "Регионы" в Справке по KML

MultiGeometry объединяет несколько геометрических объектов в единую метку (компонент Placemark). Благодаря этому к ним можно применять единый стиль и отображать их как единый объект, например в панели "Места" в Google Планете Земля.

Стили задаются на уровне компонента Placemark с помощью элемента styleUrl или Style. Таким образом, отдельные геометрические объекты внутри метки не могут иметь собственные стили.

Это правило можно обойти, создав отдельный компонент Placemark для каждого геометрического объекта и определив для него собственный стиль. Чтобы элементов не получилось слишком много, объедините их в компонент Folder, определите для него ListStyle и задайте для его элемента listItemType значение checkHideChildren. Все объединенные таким образом компоненты Placemark будут представлены как единый элемент в панели "Места" в Google Планете Земля, и отображать их по отдельности не потребуется.

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

В настоящее время KML не сохраняет состояние всплывающего окна при обновлении сетевой ссылки.

В настоящее время по сетевым ссылкам нельзя отследить KML-код, создаваемый пользователями в Google Планете Земля или Google Картах. Тем не менее, можно использовать API Google Планеты Земля или API Google Карт в качестве инструмента создания KML-файлов и передавать информацию обратно на сервер (см. пример GeoDataStore).

Ползунок времени отображается, когда открывается KML-файл, содержащий элемент <TimeStamp> или <TimeSpan>. Геобразуер обнаруживает все выбранные элементы <TimeStamp> и <TimeSpan> и настраивает на ползунке соответствующие интервалы. В настоящее время в KML не предусмотрены другие способы управления ползунком времени, такие как возможность принудительной установки текущего времени или определенного периода. Подробные сведения о добавлении временных данных приведены в статье Время и анимация.

В настоящее время KML в Google Планете Земля поддерживает только функции HTML, служащие для представления содержания; интерактивные функции HTML не поддерживаются. В Google Картах KML позволяет программировать формы.

Однако KML в Google Планете Земля поддерживаются Flash-формы. Чтобы добавить такую форму, вставьте Flash-приложение в HTML-код, который отображается во всплывающем окне с описанием. В Google Картах этот способ не работает.

Да. Это можно сделать одним из указанных ниже способов.

• Напишите собственную программу, которая будет анализировать CSV-файл и создавать на его основе KML-код. Вам может быть полезна эта статья.
• Воспользуйтесь онлайн-редактором таблиц. В частности, в рамках Просветительской программы Google Планеты Земля было создано веб-приложение Spreadsheet Mapper, основанное на Google Таблицах.
• Воспользуйтесь одним из инструментов преобразования таблиц Excel в KML-файлы, таким как [link to tek's thread].
• Загрузите файлы в Google Планету Земля Плюс или PRO и сохраните их с расширением KML или KMZ.

Недавно в Google Планету Земля были внесены изменения, в результате которых ссылки во всплывающих окнах стали обрабатываться иначе. Изменения нацелены на оптимизацию работы всего механизма. В результате, если нажать в KMZ-файле на ссылку с неправильной структурой, откроется страница с надписью "Ссылка, по которой вы перешли на эту страницу, не работает из-за неверного форматирования. Чтобы воспользоваться предыдущей версией, нажмите на ссылку ниже". Если появляется это сообщение, необходимо изменить KML- или KMZ-код так, чтобы он был совместим с последующими версиями Google Планеты Земля.

Подробные сведения о требованиях к структуре KMZ-кода можно найти здесь.

В настоящее время эти правила влияют только на URL во всплывающих окнах (ссылки в тегах <description> и <text> в элементах <BallonStyle>). Однако в будущем в Google Планету Земля могут быть внесены дальнейшие изменения, направленные на повышение стабильности работы, поэтому уже сейчас не рекомендуется использовать родительский каталог в качестве базового URL, к которому привязываются ссылки в KMZ-архиве.

Нет. KML-файлы, созданные в интерфейсе Google Планеты Земля или загруженные пользователем, не отправляются в Google. Все данные хранятся и обрабатываются локально.