Overlays in Google Earth einbinden

nospam@example.com (Frank Seitz) — Thu, 28 Jan 2010 17:39:53 +0100

Overlays sind Bilder, die von Google Earth auf einen Bereich der Erdoberfläche (GroundOverlays) oder statisch ins Anwendungsfenster (ScreenOverlays) projeziert werden.

Zu den Bildern gehört eine Spezifikation in KML (Keyhole Markup Language), die die Bilder beschreibt und festlegt, wie Google Earth mit ihnen verfahren soll. KML ist XML-basiert und wird in einer Datei mit der Extension .kml gespeichert.

Die kml-Datei und die Bild-Dateien können zusammen in Form einer einzelnen kmz-Datei an Google Earth übergeben werden. Die kmz-Datei ist eine ZIP-Datei, die die genannten Dateien enthält.

Die kmz-Datei wird entweder über "File/Open" geladen oder als Parameter beim Aufruf von Google Earth angegeben.

Beispiel

KML-Datei

1	<?xml version="1.0" encoding="UTF-8"?>
2	<kml xmlns="http://www.opengis.net/kml/2.2">
3	<Document>
4	<name>__NAME__</name>
5	<open>1</open>
6	<description>__DESCRIPTION__</description>
7	<GroundOverlay>
8	<name>Image</name>
9	<Icon>
10	<href>__FILE__</href>
11	</Icon>
12	<LatLonBox>
13	<north>__NORTH__</north>
14	<south>__SOUTH__</south>
15	<east>__EAST__</east>
16	<west>__WEST__</west>
17	</LatLonBox>
18	</GroundOverlay>
19	<ScreenOverlay>
20	<name>Legend</name>
21	<Icon>
22	<href>__LEGEND_FILE__</href>
23	</Icon>
24	<overlayXY x="0.02" y="0.98" xunits="fraction" yunits="fraction"/>
25	<screenXY x="0.02" y="0.98" xunits="fraction" yunits="fraction"/>
26	<size x="-1" y="-1" xunits="pixels" yunits="pixels"/>
27	</ScreenOverlay>
28	</Document>
29	</kml>

Obige KML-Spezifiktion beschreibt ein Bild, das auf die Erdoberfläche projeziert wird (Element GroundOverlay) und ein Bild, das statisch in der oberen linken Ecke des Fensters dargestellt wird (Element ScreenOverlay). Die beteiligten Hauptelemente sind: Document, GroundOverlay, ScreenOverlay.

Für die Platzhalter __NAME__, __DESCRIPTION__ usw. müssen konkrete Werte eingesetzt werden.

__NAME__: Bezeichnung des Orts (Google-Terminus: Place). Diese Bezeichnung erscheint auf der linken Seite im Fenster und kann direkt ausgewählt werden.
__DESCRIPTION__: Beschreibung zum Ort.
__FILE__: Dateiname des Bildes, das auf die Erdoberfläche projeziert wird.
__NORTH__, __SOUTH__, __EAST__, __WEST__: Quadrupel von dezimalen Gradzahlen, die die geografische Region definieren.
__LEGEND_FILE__: Dateiname des statischen Bildes (das wir hier als "Legende" bezeichnen).

MIME Type

Wird die kmz-Datei von einem HTTP-Server ausgeliefert, sollte dieser den MIME-Type kennen:

application/vnd.google-earth.kmz kmz

Im Browser kann Google-Earth als Helper-Applikation vereinbart werden. Beim Eintreffen einer kmz-Datei wird Google Earth dann automatisch gestartet und positioniert an den betreffenden Ort. Die Angaben für den Browser sind:

Mime-Type:	application/vnd.google-earth.kmz
Description:	Keyhole Markup Language Archive
Extension:	kmz

Applikation

http://ferrydata.gkss.de/index.cgi?seite=map_plot

Frank Seitz' Developer Logbuch - Google Earth

Overlays in Google Earth einbinden

Beispiel

KML-Datei

MIME Type

Applikation