Руководство разработчика

В Руководстве подробно описаны основные элементы KML и способы их использования.

KMZ-файлыОбновлено
Инструкции по сжатию KML-файлов и связанных с ними изображений, наложений, значков и звуковых фрагментов в единый архив, который можно отправить по электронной почте или разместить на сервере.
Путешествия
В Google Планете Земля 5.0 появились путешествия – траектории движения в пространстве и времени, которые можно программировать с помощью KML-кода. Элементы, относящиеся к путешествиям, включены в пространство имен расширений Google.
Режимы высоты
Благодаря новым элементам в пространстве имен расширений Google в Планете Земля 5.0 стало возможным погружаться под воду – для этого служат режимы высоты clampToSeaFloor и relativeToSeaFloor. На этой странице также описаны традиционные "наземные" режимы.
Время и анимация
С любым компонентом KML можно связать временные данные. Если KML-файл содержит компоненты с элементами TimeSpan или TimeStamp, в Google Планете Земля отображается ползунок времени. С помощью этого ползунка и кнопки воспроизведения можно просматривать весь заданный период или его части.
Камеры
Элемент <Camera> определяет ракурс, с которого пользователь видит компонент. В частности, эта функция отлично подходит для представления фото (элемент PhotoOverlay, с помощью которого они показываются, также является новинкой в KML 2.2). Элемент <Camera> поддерживает шесть степеней свободы, поэтому камеру можно не только смещать, но и вращать по осям x, y и z.
Фото
Элемент <PhotoOverlay> позволяет разместить фотографию в заданном месте земной поверхности и определить положение и ракурс камеры, к которой оно привязано. Фото может быть обычным двухмерным прямоугольником, частичным или полным цилиндром либо сферой (сферической панорамой). Дочерний элемент <ImagePyramid> элемента <PhotoOverlay> отвечает за эффективную обработку слишком больших картинок в Google Планете Земля.
Данные Google Неба в KML
Теперь в Google Планете Земля можно отображать небесные тела. На этой странице описано, как определить их в KML-файле, а также как преобразовать стандартные небесные координаты в координаты режима Неба в Google Планете Земля.
Персонализированные данные
К компонентам KML можно добавлять персонализированные данные. Способ, которым это делается, зависит от их типа. Новый элемент <ExtendedData> позволяет добавлять типизированные и нетипизированные данные или любые XML-данные. Google Планета Земля хранит их вместе с файлом. Типизированные и нетипизированные данные содержат отображаемые элементы, которые могут использоваться в шаблонах стилей и для замены объектов во всплывающих окнах.
Модели
Трехмерные объекты можно моделировать в отдельных координатных пространствах, экспортировать в виде файлов COLLADA™, а затем импортировать в Google Планету Земля и размещать на земной поверхности.
Регионы
Регионы позволяют более точно задавать условия обработки данных, отображаемых в Google Планете Земля. В сочетании с сетевыми ссылками регионы обеспечивают потоковую передачу больших объемов информации, причем чем ближе компонент находится к пользователю, тем больше деталей загружается и отображается (подробные сведения приведены в разделе Фрагментированные изображения). С помощью регионов можно также симулировать слои Google Планеты Земля.
Обновления
Содержание, загружаемое по сетевым ссылкам, можно постепенно обновлять, изменяя, добавляя или удаляя KML-данные, загруженные в Google Планету Земля ранее.
Устаревание данных
На этой странице описано, как обеспечить актуальность KML-данных за счет использования HTTP-заголовков или определения времени устаревания в KML.