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

KML — это формат файлов, используемый для отображения географических данных в браузере Earth, таком как Google Earth. Вы можете создавать файлы KML для точного определения местоположения, добавления наложений изображений и представления расширенных данных новыми способами. KML — это международный стандарт, поддерживаемый Open Geospatial Consortium, Inc. (OGC) .

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

Существует три основных инструмента для создания KML-файлов.

• Google Планета Земля. Это самый важный инструмент для создания KML-файлов. С помощью Google Планета Земля вы можете создавать
  
  • Метки
  • Пути
  • Полигоны
  • Наложения изображений
  • Сетевые ссылки
  • Размещение моделей
  • Папки всего вышеперечисленного
  • Фотоналожения

Создав один из таких объектов, щёлкните по нему правой кнопкой мыши на панели «Места» и выберите «Копировать». Затем вы можете вставить объект в текстовый редактор или XML-редактор и начать его редактирование.

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

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

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

KML можно использовать для представления астрономических данных и загружать в Google Sky или Microsoft WorldWide Telescope. Подробнее см. в статье «Данные о небе в KML» .

Все теги KML поддерживаются Google Earth. Список всех тегов см. в спецификации KML .

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

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

Например, эта линия пройдет сквозь Землю и фактически исчезнет:

<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> верно
   <имя>Атланта не верна
   <имяАтланта</имя> неверно
   <имяАтланта<имя> неверно

KML — это язык разметки XML. Вы можете проверить его корректность несколькими способами:

• Вы можете использовать XML-редактор, например Oxygen или Netbeans , для проверки документа. Ознакомьтесь с документацией по выбранному XML-редактору. Для проверки вам понадобится схема KML .
• Вы можете проверить его с помощью онлайн-валидатора, например FeedValidator.org , который укажет вам на любые допущенные вами ошибки и предложит несколько рекомендаций по стилю.
• Некоторые текстовые редакторы позволяют выполнять проверку XML. Например, для проверки KML можно использовать jEdit . Ознакомьтесь с этим руководством от команды Google Earth Outreach.

Тег «Регион» используется для управления функциями, которые вы отображаете пользователю. Лучшие ресурсы для получения дополнительной информации о регионах:

• Статья в руководстве разработчика о регионах
• Справочный документ Google KML для регионов

Элемент MultiGeometry группирует геометрические объекты в одном элементе Placemark . Это позволяет использовать для геометрических объектов одинаковый стиль и отображать их как один элемент в списке, например, на панели «Мои места» в Google Планета Земля.

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

Часто используемое решение — создать отдельную метку для каждого геометрического объекта, используя для каждой из них свой стиль. Чтобы предотвратить разрастание списка, поместите их в папку со стилем ListStyle и типом listItemType с опцией checkHideChildren. Например, в Google Earth это помещает все метки в один и тот же элемент папки в разделе «Мои метки», что не позволяет пользователю открывать его для просмотра большого количества элементов.

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

На этом этапе KML не поддерживает сохранение статуса всплывающей подсказки при обновлении NetworkLink.

На данном этапе вы не можете использовать NetworkLink для захвата KML-файлов, созданных пользователем в Google Earth или Картах. Однако вы можете использовать JavaScript API Google Карт в качестве инструмента для создания KML-файлов и записать эту информацию обратно на сервер. Пример см. в GeoDataStore .

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

На этом этапе KML в Google Earth поддерживает только подмножество HTML, описывающее представление, а не взаимодействие.

Однако вы можете встроить Flash-формы в KML-файл, используемый в Google Планета Земля. Для этого встройте Flash-приложение в HTML-код в описании KML-файла.

Есть несколько основных способов сделать это.

• Сделайте это программно самостоятельно, используя собственное приложение для анализа CSV-файла и создания из него KML-файла. Пример см. в статье «Преобразование CSV-файлов в KML» .
• Используйте онлайн-таблицы. Например, команда Google Earth Outreach создала инструмент Spreadsheet Mapper на основе Google Таблиц.
• Используйте один из инструментов для создания файлов Excel в формате KML, например [ссылка на тему tek]этот
• Используйте Google Earth Plus или Pro для загрузки файлов, а затем сохраните их как файлы KML или KMZ.

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

Дополнительную информацию, в том числе о том, как правильно реструктурировать содержимое KMZ, смотрите в этой статье .

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

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