Википедия:KML

Материал из Википедии — свободной энциклопедии

KML-статьи — особый род геоинформационных приложений к основным статьям Википедии. KML-статьи являются дальнейшим развитием идеи включения географических координат в статьи Википедии; каждая KML-статья содержит географические координаты одного или нескольких объектов.

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

Содержание 1 Именование KML-статей 2 Ссылки на KML-статьи 3 Типы объектов 3.1 Пометка места 3.2 Ломаная линия 3.3 Многоугольная область 3.4 Накладываемое изображение 3.5 Трёхмерная модель объекта 4 Структуры географических объектов 4.1 Объединение объектов в папки 4.2 Подключение внешних данных 4.3 Анимация 5 Создание KML-статей 6 Ссылки

[править] Именование KML-статей

KML-статьям рекомендуется давать название в виде «Википедия:KML/Название».

Достоинства этого порядка наименования таковы:

• Статья находится в служебном пространстве имён «Википедия:», и потому не попадает в «случайные статьи», где она могла бы шокировать неподготовленного участника или читателя Википедии.

• В начале статьи Википедией автоматически создаётся ссылка на статью «Википедия:KML», то есть вот сюда, где изложены разъяснения о том, что такое KML-статьи.

Например, для статьи Старокорсунская (станица) KML-статья будет называться Википедия:KML/Старокорсунская (станица).

[править] Ссылки на KML-статьи

Для ссылок на KML-статьи из основных статей Википедии используется шаблон {{Attach KML}}.

Пример применения:

{{Attach KML|Википедия:KML/Старокорсунская (станица)|станица Старокорсунская}}

Результат применения:  станица Старокорсунская ^{[KML · ??]}

В результате шаблоном создаётся:

• основная ссылка, после нажатия на которую браузером скачивается KML-файл (и скармливается в программу Google Earth, если она установлена);
• два верхних индекса, являющихся вспомогательными ссылками:
  • ссылка «KML» — нажатие на неё позволяет просмотреть и (или) отредактировать KML-код;
  • ссылка «??» — нажатие на неё переносит сюда (в эту вот статью), позволяя прочесть о том, что такое KML-статьи, для чего они нужны.

[править] Типы объектов

Язык KML позволяет определять (и отображать на фотографическом глобусе Google Earth) различные типы географических объектов. Каждая KML-статья может содержать один или несколько объектов, относящихся к одному или нескольким из нижеследующих типов.

[править] Пометка места

Пометка места (англ. placemarks; от слов place — «место», mark — «пометка») — значок, отмечающий положение некоторой точки (на земной поверхности или в пространстве над нею).

Для такой пометки могут быть заданы следующие свойства:

• Название. Отображается:
  • на карте — в качестве подписи возле значка пометки,
  • на левой панели мест («Places») — в качестве заголовка;
  • во всплывающей подсказке — в качестве заглавия.

• Значок. Та небольшая картинка, которая отображается в указанном месте. Создатель пометки может выбрать одно из предлагаемых по умолчанию изображений, или указать URLовый адрес произвольного изображения в Паутине. Можно отключить отображение значка, тогда на карте будет отображаться только подпись (название места), и при помощи карты не будет возможности вызвать подсказку с описанием места.

• Широта и долгота. Географические координаты.

• Описание. Небольшой фрагмент текста или гипертекста, поясняющего пометку. Если щелкнуть мышью по пометке, то отображается овальная подсказка с названием и описанием пометки. В описании могут использоваться некоторые теги языка HTML:
  • Описание может содержать гиперссылки, ведущие к статьям Википедии и (или) к другим страницам Паутины.
  • Описание может содержать изображения, в том числе иллюстрации из статей Википедии.

• Размер, цвет и прозрачность подписи. Управляет отображением на карте подписи, содержащей название пометки места. Размер задаётся в качестве масштабного коэффициента, а прозрачность в процентах (100% — непрозрачность, 0% — полная прозрачность).

• Размер, цвет и прозрачность значка. Управляет отображением на карте значка, отмечающего место. Размер задаётся в качестве масштабного коэффициента, а прозрачность в процентах (100% — непрозрачность, 0% — полная прозрачность). Заданный цвет действует в качестве фильтра, налагаемого на собственный цвет изображения, используемого значком. Например, если задан белый цвет, то изображение, используемое значком, отобразится на карте в неизменном виде.

• Широта и долгота, а также расстояние, угол наклона и азимут рекомендуемой точки наблюдения. Эти параметры задают направление взгляда и положение наблюдателя. Позволяют рекомендовать наблюдение указанного места под таким углом и с такого места, которые позволят оценить какие-либо его особенности (рельеф местности, береговую линию, и т. п.)

• Высота пометки. Позволяет пометить объект, располагающийся выше земной поверхности. Также позволяет при необходимости провести из помеченного места перпендикуляр к земной поверхности.

Применение.  Пометки мест могут применяться в Википедии для указания географического местоположения населённых пунктов, отдельных зданий, крепостей, судов, и так далее — то есть для той же цели, что и координатные шаблоны {{coord}}, {{coor}}, {{coor d}}, {{coord-nocat}}, {{координаты объекта}}.

В качестве иллюстраций в описании места могут использоваться thumb-версии иллюстраций, имеющихся в той статье Википедии, к которой KML-статья служит приложением.

В качестве значков могут применяться иллюстрации Википедии, предварительно уменьшенные при помощи вики-разметки до размера 30px или 40px. Для примера см. Обсуждение:Геленджик#Пометки для Google Earth.

[править] Ломаная линия

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый употреблению ломаных линий в KML-статьях. Вы можете помочь проекту, написав этот подраздел.

[править] Многоугольная область

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый употреблению многоугольных областей в KML-статьях. Вы можете помочь проекту, написав этот подраздел.

[править] Накладываемое изображение

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый употреблению накладываемых изображений в KML-статьях. Вы можете помочь проекту, написав этот подраздел.

[править] Трёхмерная модель объекта

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый употреблению трёхмерных моделей в KML-статьях. Вы можете помочь проекту, написав этот подраздел.

[править] Структуры географических объектов

[править] Объединение объектов в папки

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый объединению объектов в папки. Вы можете помочь проекту, написав этот подраздел.

[править] Подключение внешних данных

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый подключению внешних данных. Вы можете помочь проекту, написав этот подраздел.

[править] Анимация

Этот подраздел ещё не написан. Согласно замыслу одного из участников Википедии, на этом месте должен располагаться подраздел, посвящённый созданию меняющихся во времени объектов. Вы можете помочь проекту, написав этот подраздел.

[править] Создание KML-статей

Файлы в формате KML можно создать, экспортировав объект или группу объектов из программы Google Earth. Файлы в формате KML можно создавать и вручную. Документация по языку приведена в разделе Ссылки.

[править] Ссылки

• Статья в Википедии о формате KML
• Документация Google Earth по языку KML(англ.)
• Пособие Google Earth по языку KML(англ.)