Diese Seite wurde von der Cloud Translation API übersetzt.

KML-Referenz

Dieser Abschnitt enthält eine alphabetische Referenz für alle in der KML-Version 2.2 definierten KML-Elemente sowie für Elemente im Namespace der Google-Erweiterung. Die Klassenstruktur für KML-Elemente ist unten zu sehen. In diesem Diagramm sind die Elemente auf der rechten Seite eines bestimmten Zweigs in der Struktur Erweiterungen der Elemente links. Beispielsweise ist eine Ortsmarkierung eine spezielle Art von Funktion. Es enthält alle Elemente, die zu Feature gehören, und es werden einige Elemente hinzugefügt, die für das Ortsmarkierungselement spezifisch sind.

KML ist ein offener Standard, der offiziell als OpenGIS® KML Encoding Standard (OGC KML) bezeichnet wird. Gepflegt wird sie vom Open Geospatial Consortium Inc. (OGC). Die vollständige Spezifikation für OGC-KML-Dateien finden Sie unter http://www.opengeospatial.org/standards/kml/.

Das vollständige XML-Schema für KML finden Sie unter http://schemas.opengis.net/kml/.

Hinweis:Klicken Sie auf einen Elementnamen in diesem Diagramm, um zu dessen Eintrag im Referenzabschnitt zu springen.

Beachten Sie, dass abstrakte Elemente (im Diagramm dargestellt) nicht in KML-Dateien verwendet werden. Sie sind nützlich, wenn ein einzelnes Element als programmatische Grundlage für mehrere ähnliche, aber unterschiedliche abgeleitete Elemente dienen soll. Das Verständnis dieser objektorientierten Hierarchie ist auch eine gute Möglichkeit, KML-Dateien zu erlernen, da Sie sich ganz einfach Gruppierungen verwandter Elemente ansehen können.

Allen von Object abgeleiteten Elementen kann eine id zugewiesen werden. Diese id wird vom KML-Aktualisierungsmechanismus (siehe <Update>) für Dateien verwendet, die mit einem NetworkLink geladen wurden. Er wird auch von gemeinsamen Stilen verwendet (siehe <Style>). id ist eine standardmäßige XML-ID.

Da es sich bei KML um eine XML-Grammatik und ein Dateiformat handelt, muss bei Tag-Namen zwischen Groß- und Kleinschreibung unterschieden werden und sie müssen genau wie hier angezeigt werden. Wenn Sie mit XML vertraut sind, interessieren Sie sich auch für das KML 2.2-Schema. Wenn Sie KML-Textdateien bearbeiten, können Sie dieses Schema in einen beliebigen XML-Editor laden und damit Ihren KML-Code überprüfen.

Tipp: KML-Daten für Google Earth-Funktionen ansehen

Mit dieser praktischen Funktion von Google Earth können Sie die KML-Datei für jedes Element ganz einfach anzeigen. In Google Earth können Sie im Bereich „Orte“ mit der rechten Maustaste auf ein Element klicken und es kopieren. Wenn Sie die entsprechende KML-Datei für das kopierte Objekt ansehen möchten, öffnen Sie Ihren bevorzugten Texteditor und fügen Sie die Auswahl darin ein.

Kompatibilität

KML-Versionen haben ein doppeltes Nummerierungssystem: majorVersion.minorVersion. Alle Versionen mit derselben majorVersion sind kompatibel. Wenn Sie den Namespace in „2.2“ ändern, also xmlns="http://www.opengis.net/kml/2.2", werden alle KML 2.1-Dateien im KML 2.2-Schema validiert.

Über diese Referenz

Jeder Referenzeintrag enthält einen Abschnitt „Syntax“, in dem die Elemente im Hauptelement aufgeführt sind. Dieser Syntaxabschnitt ist eine informelle Auflistung und verwendet einfache Abkürzungen, um die Elemente zusammenzufassen. Dieser Abschnitt umfasst auch Folgendes:

Standardwerte für jedes Element (oder Ellipsen, falls es sich um ein komplexes Element handelt oder wenn es keinen Standardwert gibt)
den Typ des Werts (siehe KML-Felder)

Der Abschnitt „Syntax“ kann kopiert und als Vorlage für jedes nicht abstrakte Element in einer KML-Datei verwendet werden.

KML-Erweiterungs-Namespace und das Präfix „gx“

Der OGC KML-Standard bietet einen Mechanismus für Erweiterungen - zusätzliche Elemente, die über Informationen hinausgehen, die im Standard verfügbar sind (weitere Informationen über XML-Namespaces auf w3.org). Mit der Einführung von Google Earth 5.0 bietet Google Erweiterungen für KML-Dateien, die eine Reihe neuer Funktionen unterstützen. Diese Erweiterungen verwenden das Präfix gx und den folgenden Namespace-URI:

xmlns:gx="http://www.google.com/kml/ext/2.2"

Dieser Namespace-URI muss dem Element <kml> in einer beliebigen KML-Datei mit den gx-vorgestellten Elementen hinzugefügt werden:

<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

Erweiterungen für KML werden möglicherweise nicht von allen Geo-Browsern unterstützt. Wenn Ihr Browser bestimmte Erweiterungen nicht unterstützt, sollten die Daten in diesen Erweiterungen ignoriert werden und der Rest der KML-Datei sollte ohne Fehler geladen werden.

Elemente, für die derzeit das Präfix gx verwendet wird:

gx:heightModus
gx:heightOffset
gx:angles
gx:Animiertes Update
gx:balloonSichtbarkeit
gx:coord
gx:delayedStart
gx:drawOrder
gx:Dauer
gx:FlyTo
gx:flyToMode
gx:h
gx:horizFov
gx:interpolate
gx:labelSichtbarkeit
gx:LatwinK
gx:MultiTrack
gx:vieweroptions
gx:outerColor
gx:outerWidth
gx:physicalWidth
gx:Playlist
gx:playMode
gx:SoundCue
gx:Zeitspanne
gx:Zeitstempel
gx:Tour
gx:TourSteuerung
gx:TourPrimitiv
gx:Beobachten
gx:ViewerOptions
gx:w
gx:Warte
gx:x
gx:y

Das vollständige XML-Schema für Elemente in diesem Erweiterungs-Namespace finden Sie unter http://developers.google.com/kml/schema/kml22gx.xsd.

KML-Felder

KML verwendet gängige XML-Typen wie Boolesch, String, Doppel, Gleitkommazahl und int und definiert darüber hinaus eine Reihe von Feldelementtypen. In der folgenden Tabelle finden Sie einige der am häufigsten in KML definierten Typen und Links zu Beispielelementen, in denen diese verwendet werden:

Feldtyp	Value	Anwendungsbeispiel
ElevationModeEnum	clampToGround, relativeToGround, absolute	Siehe <LookAt> und <Region>
angle90	ein Wert ≥ 90 und ≤ 90	Siehe <Breitengrad> unter <Modell>
anglepos90	ein Wert ≥ 0 oder ≤ 90	Siehe <tilt> in <LookAt>
winkel180	ein Wert ≥ 180 und ≤ 180	Siehe <Längengrad> im Modell <Modell>
angle360	ein Wert ≥ 360 und ≤ 360	Siehe <head> in <Orientation>
Farbe	Hexadezimalwert: aabbggrr	Elemente ansehen, die <ColorStyle> erweitern
colorModeEnum	Normal, Zufall	Elemente ansehen, die <ColorStyle> erweitern
dateTime	dateTime, date, gYearMonth, gYear	Siehe <TimeSpan> und <TimeStamp>
displayModeEnum	Standardeinstellung, ausblenden	Siehe <BalloonStyle>
gridOrigin,	unten links, oben links	Siehe <PhotoOverlay>
refreshModeEnum	onChange, onInterval, onExpire	Siehe <Link>
shapeEnum	Rechteck, Zylinder, Kugel	Siehe <PhotoOverlay>
styleStateEnum	Normal, markieren	Siehe <StyleMap>
unitsEnum	Bruch, Pixel, insetPixel	Siehe <hotSpot> in <IconStyle>, <ScreenOverlay>
V2	×	Siehe <hotSpot> in <IconStyle>, <ScreenOverlay>
viewRefreshEnum	nie, onRequest, onStop, onRegion	Siehe <Link>

<Abstraktansicht>

Syntax

<!-- abstract element; do not create -->
<!-- AbstractView -->                       <!-- Camera, LookAt -->
  <!-- extends Object -->
  <TimePrimitive>...</TimePrimitive>        <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <gx:option name="" enabled=boolean />   <!-- name="streetview",
                                                      "historicalimagery",
                                                   or "sunlight" -->
  </gx:ViewerOptions>
<-- /AbstractView -->

Beschreibung

Dies ist ein abstraktes Element und kann nicht direkt in einer KML-Datei verwendet werden. Dieses Element wird durch die Elemente <Camera> und <LookAt> erweitert.

Erweitert

<Objekt>

Für Abstrakte Elemente spezifische Elemente

<gx:ViewerOptions>: Dieses Element ermöglicht spezielle Anzeigemodi ab Google Earth 6.0. Sie hat mindestens ein untergeordnetes <gx:option>-Element. Das Element <gx:option> hat das Attribut name und das Attribut enabled. name gibt eines der folgenden Elemente an: Street View-Bilder („Street View“), historisches Bildmaterial („Historisches Bildmaterial“) und Sonneneinstrahlung für eine bestimmte Tageszeit („Sonnenlicht“). Mit dem Attribut enabled wird ein bestimmter Anzeigemodus aktiviert oder deaktiviert.
<gx:horizFov>: Definiert das horizontale Sichtfeld der abstrakten Ansicht während einer Tour. Dieses Element hat keine Auswirkungen auf „abstrakte Ansichten“ außerhalb einer Tour. <gx:horizFov> wird während der Aufzeichnung der Tour automatisch vom Google Earth-Client (Version 6.1 oder höher) eingefügt. Regulären abViews-Ansichten wird der Wert 60 zugewiesen; Ansichten in Street View wird der Wert 85 zugewiesen, damit sie dem standardmäßigen Street View-Sichtfeld in Google Earth entsprechen. Nach der Festlegung wird der Wert auf nachfolgende Ansichten angewendet, bis ein neuer Wert angegeben wird.

<gx:heightMode>

Dieses Element ist eine Erweiterung des OGC KML 2.2-Standards und wird ab Google Earth 5.0 unterstützt. Weitere Informationen

Syntax

<gx:altitudeMode>clampToGround</gx:altitudeMode>
  <!-- gx:altitudeModeEnum: relativeToSeaFloor, clampToSeaFloor, relativeToGround, clampToGround, absolute -->

Beschreibung

Kann anstelle des OGC-KML-Standardelements <altitudeMode> verwendet werden. Es werden die folgenden Werte zusätzlich zu den standardmäßigen Höhenmodus-Werten akzeptiert:

relativeToSeaFloor: interpretiert die Höhe als Wert in Metern über dem Meeresboden. Liegt das KML-Element über Land und nicht über dem Meer, wird die Höhe als „über dem Boden“ interpretiert.
clampToSeaFloor: Die Höhenangabe wird ignoriert und die KML-Funktion wird auf dem Meeresboden positioniert. Wenn die KML-Datei auf Land und nicht auf See steht, hebt clampToSeaFloor stattdessen an den Boden an.

Wie bei <altitudeMode> wirkt sich <gx:altitudeMode> auf Folgendes aus:

die Höhenkoordinaten innerhalb des <coordinates>-Elements
<minAltitude> und <maxAltitude> innerhalb von <LatLonAltBox>
<altitude> innerhalb von <Location>, <GroundOverlay> und AbstractView (<LookAt> und <Camera>).

Weitere Informationen zu Höhenmodi finden Sie im Kapitel Höhenmodi des KML-Entwicklerhandbuchs.

Beispiel

heightmode_reference.KML

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">   <!-- required when using gx-prefixed elements -->

<Placemark>
  <name>gx:altitudeMode Example</name>
  <LookAt>
    <longitude>146.806</longitude>
    <latitude>12.219</latitude>
    <heading>-60</heading>
    <tilt>70</tilt>
    <range>6300</range>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
  </LookAt>
  <LineString>
    <extrude>1</extrude>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
    <coordinates>
      146.825,12.233,400
      146.820,12.222,400
      146.812,12.212,400
      146.796,12.209,400
      146.788,12.205,400
    </coordinates>
  </LineString>
</Placemark>

</kml>

<gx:Animiertes Update>

Dieses Element ist eine Erweiterung des OGC KML 2.2-Standards und wird ab Google Earth 5.0 unterstützt. Weitere Informationen

Syntax

<gx:AnimatedUpdate id="ID">
  <gx:duration>0.0</gx:duration>     <!-- double, specifies time in seconds -->
  <Update>
    <targetHref>...</targetHref>     <!-- required; can contain a URL or be left blank -->
                                      <!-- (to target elements within the same file) -->
    <Change>...</Change>
    <Create>...</Create>
    <Delete>...</Delete>
  </Update>
  <gx:delayedStart>0</gx:delayedStart>  <!-- double, specifies time in seconds -->
</gx:AnimatedUpdate>

Beschreibung

<gx:AnimatedUpdate> steuert Änderungen an einer Tour für KML-Elemente mithilfe von <Update>. Änderungen an den KML-Funktionen haben keine Auswirkungen auf das DOM, d. h. Änderungen, die nach Abschluss der Tour rückgängig gemacht werden, werden nicht gespeichert.

<gx:AnimatedUpdate> sollte außerdem einen <gx:duration>-Wert enthalten, um die Dauer in Sekunden anzugeben, über die die Aktualisierung erfolgt. Ganzzahl-, Gleitkomma- und Farbfelder werden während der gesamten Dauer gleichmäßig vom Original zum neuen Wert animiert. Boolesche Werte, Strings und andere Werte, die keine Interpolation auslösen, werden am Ende des Zeitraums aktualisiert.

Weitere Informationen zu <gx:AnimatedUpdate> und der Zeitachse finden Sie im Kapitel Touring im KML-Entwicklerhandbuch.

<gx:Dauer>: Gibt die Zeitspanne in Sekunden an, über die die Aktualisierung erfolgt.
<gx:delayedStart>: Gibt die Anzahl der Sekunden an (nach der Inline-Startposition), bevor das Update gestartet wird.

Beispiel

Das folgende Beispiel zeigt eine Änderung der Symbolgröße. Diese Änderung wird fünf Sekunden lang animiert.

animiertes_Update_beispiel.de

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

<Document>
  <name>gx:AnimatedUpdate example</name>

  <Style id="pushpin">
    <IconStyle id="mystyle">
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href>
        <scale>1.0</scale>
      </Icon>
    </IconStyle>
  </Style>

  <Placemark id="mountainpin1">
    <name>Pin on a mountaintop</name>
    <styleUrl>#pushpin</styleUrl>
    <Point>
      <coordinates>170.1435558771009,-43.60505741890396,0</coordinates>
    </Point>
  </Placemark>

  <gx:Tour>
    <name>Play me!</name>

    <gx:Playlist>

      <gx:FlyTo>
        <gx:flyToMode>bounce</gx:flyToMode>
        <gx:duration>3</gx:duration>
        <Camera>
          <longitude>170.157</longitude>
          <latitude>-43.671</latitude>
          <altitude>9700</altitude>
          <heading>-6.333</heading>
          <tilt>33.5</tilt>
        </Camera>
      </gx:FlyTo>

      <gx:AnimatedUpdate>
        <gx:duration>5</gx:duration>
        <Update>
          <targetHref></targetHref>
          <Change>
            <IconStyle targetId="mystyle">
              <scale>10.0</scale>
            </IconStyle>
          </Change>
        </Update>
      </gx:AnimatedUpdate>

      <gx:Wait>
        <gx:duration>5</gx:duration>
      </gx:Wait>

    </gx:Playlist>
  </gx:Tour>

</Document>
</kml>

Erweitert

<gx:TourPrimitive>

Enthält

<gx:Dauer>
<Aktualisieren>

<BalloonStyle>

Syntax

<BalloonStyle id="ID">
  <!-- specific to BalloonStyle -->
  <bgColor>ffffffff</bgColor>            <!-- kml:color -->
  <textColor>ff000000</textColor>        <!-- kml:color -->
  <text>...</text>                       <!-- string -->
  <displayMode>default</displayMode>     <!-- kml:displayModeEnum -->
</BalloonStyle>

Beschreibung

Gibt an, wie das Info-Pop-up für Ortsmarkierungen gezeichnet wird. <bgColor> wird, sofern angegeben, als Hintergrundfarbe für das Info-Pop-up verwendet. Unter <Funktion> finden Sie ein Diagramm, das veranschaulicht, wie das Info-Pop-up mit Standardbeschreibungen in Google Earth funktioniert.

Für BalloonStyle spezifische Elemente

<bgColor>: Hintergrundfarbe des Info-Pop-ups (optional). Farb- und Deckkraftwerte (Alpha) werden als Hexadezimalwerte ausgedrückt. Der Wertebereich einer Farbe ist 0 bis 255 (00 bis ff). Die Reihenfolge des Ausdrucks ist aabbggrr, wobei aa=alpha (00 bis ff); bb=blue (00 bis ff); gg=green (00 bis ff); rr=red (00 bis ff). In der Alphaphase ist 00 vollständig transparent und ff ist undurchsichtig. Wenn Sie beispielsweise eine blaue Farbe mit 50 % Deckkraft auf ein Overlay anwenden möchten, geben Sie Folgendes an: <bgColor>7fff0000</bgColor>, wobei alpha=0x7f, blue=0xff, green=0x00 und red=0x00 ist. Die Standardeinstellung ist undurchsichtig, weiß.
<textColor>: Vorderfarbe für Text Der Standardwert ist Schwarz (ff000000).
<text>: Im Info-Pop-up angezeigter Text Wenn kein Text angegeben ist, zeichnet Google Earth das Info-Pop-up mit dem fett formatierten Merkmal <name>, dem <description>-Element, Links zur Routenplanung, einem weißen Hintergrund und einem an den Punktkoordinaten des Merkmals befestigten Extremwert.; Sie können im <text>-Tag Entitäten mit dem folgenden Format hinzufügen, um auf ein untergeordnetes Element von Feature zu verweisen: $[name], $[description], $[address], $[id], $[Snippet]. Google Earth sucht im aktuellen Feature nach der entsprechenden String-Entität und ersetzt diese Information im Info-Pop-up. Verwenden Sie das Tag $[geDirections], wenn Sie Routen für Routen mit dem Ziel Nach hier abrufen möchten. Sie können verhindern, dass die Routenplaner-Links in einem Info-Pop-up angezeigt werden, indem Sie das Element <text> mit einigen Inhalten oder durch $[description] ersetzen, um die Basisfunktion <description> zu ersetzen.; Im folgenden KML-Auszug werden beispielsweise die Felder $[name] und $[description] durch die Felder <name> und <description> ersetzt, die in den Feature-Elementen, die dieses Feature verwenden, verwendet werden.
<displayMode>: Wenn <displayMode> auf default gesetzt ist, verwendet Google Earth die in <text> angegebenen Informationen, um ein Info-Pop-up zu erstellen . Ist <displayMode> auf hide gesetzt, wird das Info-Pop-up von Google Earth nicht angezeigt. Wenn Sie in Google Earth auf das Symbol für die Listenansicht einer Ortsmarkierung klicken, deren <displayMode> <displayMode> auf hide gesetzt ist, fliegt Google Earth zur Ortsmarkierung.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>BalloonStyle.kml</name>
  <open>1</open>
  <Style id="exampleBalloonStyle">
    <BalloonStyle>
      <!-- a background color for the balloon -->
      <bgColor>ffffffbb</bgColor>
      <!-- styling of the balloon text -->
      <text><![CDATA[
      <b><font color="#CC0000" size="+3">$[name]</font></b>
      <br/><br/>
      <font face="Courier">$[description]</font>
      <br/><br/>
      Extra text that will appear in the description balloon
      <br/><br/>
      <!-- insert the to/from hyperlinks -->
      $[geDirections]
      ]]></text>
    </BalloonStyle>
  </Style>
  <Placemark>
    <name>BalloonStyle</name>
    <description>An example of BalloonStyle</description>
    <styleUrl>#exampleBalloonStyle</styleUrl>
    <Point>
      <coordinates>-122.370533,37.823842,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Erweitert

<Farbstil>

Enthalten durch

<Stil>

Nach oben

<gx:balloonSichtbarkeit>

Dieses Element ist eine Erweiterung des OGC KML 2.2-Standards und wird ab Google Earth 5.0 unterstützt. Weitere Informationen

Syntax

<gx:balloonVisibility>0</gx:balloonVisibility>    <!-- 0 (not visible) or 1 (visible) -->

Beschreibung

Blendet die Sichtbarkeit eines Info-Pop-ups ein oder aus Das Info-Pop-up, das aktualisiert werden soll, muss durch die XML-ID des Objekts identifiziert werden (z.B. <Placemark targetId="xxx">).

Beispiele

Das erste Beispiel zeigt <gx:balloonVisibility> mit einer Ortsmarkierung. Sobald die Ortsmarkierung geladen ist, wird das Info-Pop-up geöffnet.
balloonsichtbarkeit_beispiel.kml

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Placemark>
    <name>Eiffel Tower</name>
    <description>
        Located in Paris, France. 
        
        This description balloon opens 
        when the Placemark is loaded.
    </description>
    <gx:balloonVisibility>1</gx:balloonVisibility>
    <Point>
      <coordinates>2.294785,48.858093,0</coordinates>
    </Point>
  </Placemark>

</kml>

Das zweite Beispiel zeigt die Verwendung von <gx:balloonVisibility> in einer Tour. Während der Tour werden verschiedene Info-Pop-ups geöffnet und geschlossen.
balloonsichtbarkeit_tourbeispiel.kml

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Document>
    <name>balloonVisibility Example</name>
    <open>1</open>

    <gx:Tour>
      <name>Play me</name>
      <gx:Playlist>

        <gx:FlyTo>
          <gx:duration>8.0</gx:duration>
          <gx:flyToMode>bounce</gx:flyToMode>
          <LookAt>
            <longitude>-119.748584</longitude>
            <latitude>33.736266</latitude>
            <altitude>0</altitude>
            <heading>-9.295926</heading>
            <tilt>84.0957450</tilt>
            <range>4469.850414</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.782630</longitude>
            <latitude>33.862855</latitude>
            <altitude>0</altitude>
            <heading>-9.314858</heading>
            <tilt>84.117317</tilt>
            <range>6792.665540</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.849578</longitude>
            <latitude>33.968515</latitude>
            <altitude>0</altitude>
            <heading>-173.948935</heading>
            <tilt>23.063392</tilt>
            <range>3733.666023</range>
            <altitudeMode>relativeToGround</altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="onland">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>

    <Placemark id="underwater1">
      <name>Underwater off the California Coast</name>
      <description>
        The tour begins near the Santa Cruz Canyon,
        off the coast of California, USA.
      </description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.749531,33.715059,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="underwater2">
      <name>Still swimming...</name>
      <description>We're about to leave the ocean, and visit the coast...</description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.779550,33.829268,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="onland">
      <name>The end</name>
      <description>
        <![CDATA[The end of our simple tour.
        Use <gx:balloonVisibility>1</gx:balloonVisibility>
        to show description balloons.]]>
      </description>
      <Point>
        <coordinates>-119.849578,33.968515,0</coordinates>
      </Point>
    </Placemark>


  </Document>
</kml>

Erweitert

<Funktion>

<Kamera>

Syntax

<Camera id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to Camera -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos180 -->
  <roll>0</roll>                      <!-- kml:angle180 -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: relativeToGround, clampToGround, or absolute -->
        <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->
</Camera>

Beschreibung

Definiert die virtuelle Kamera, die die Szene betrachtet. Dieses Element definiert die Position der Kamera relativ zur Erdoberfläche sowie die Sichtrichtung der Kamera. Die Position der Kamera wird durch <Längengrad>, <Breitengrad>, <Höhe> und entweder <Höhenstil> oder <gx:heightMode> definiert. Die Sichtrichtung der Kamera wird durch <Überschrift>, <Neigung> und <Neigung> definiert. <Kamera> kann ein untergeordnetes Element eines beliebigen Elements oder von <NetzwerkLinkControl> sein. <Kamera> kann nicht gleichzeitig ein

Mit der <Kamera> hast du ein vollständiges 6-Freiheitsgrad. Du kannst die Kamera also im Weltraum positionieren und sie dann um die Achsen X, Y und Z drehen. Vor allem können Sie die Kameraansicht neigen, sodass Sie über den Horizont in den Himmel blicken.

<Camera> kann auch einen TimePrimitive (<gx:TimeSpan> oder <gx:TimeStamp>) enthalten. Zeitwerte in der Kamera wirken sich auf historische Bilder, Sonnenlicht und die Anzeige von Elementen mit Zeitstempel aus. Weitere Informationen finden Sie unter Time with SummaryView (Zeit mit abstrakten Ansichten) im Kapitel Time and Animation (Zeit und Animation) im Entwicklerhandbuch.

Ansicht definieren

Verwenden Sie innerhalb einer Funktion oder eines <NetworkLinkControl>-Elements entweder ein <Camera>- oder ein <LookAt>-Objekt, aber nicht beide in demselben Objekt. Das Objekt <Kamera> definiert den Blickwinkel in Bezug auf die Position und Ausrichtung des Betrachters. Mit dem <Camera>-Objekt können Sie eine Ansicht angeben, die sich nicht auf der Erdoberfläche befindet. Das Objekt <LookAt> definiert den Blickwinkel in Bezug darauf, was dargestellt wird. Das <LookAt>-Objekt ist im Umfang eingeschränkter als <Camera> und erfordert in der Regel, dass die Ansichtsrichtung die Erdoberfläche überschneidet.

Das folgende Diagramm zeigt die Achsen X, Y und Z, die an der virtuellen Kamera angebracht sind.

Die X-Achse zeigt auf die rechte Seite der Kamera und wird als rechter Vektor bezeichnet.
Die y-Achse legt die Aufwärtsrichtung relativ zum Bildschirm fest und wird als up-Vektor bezeichnet.
Die Z-Achse zeigt von der Bildschirmmitte zum Augenpunkt. Die Kamera blickt auf die −Z-Achse, die als Ansichtsvektor bezeichnet wird.

Reihenfolge der Transformationen

Die Reihenfolge der Rotation ist wichtig. Standardmäßig blickt die Kamera gerade nach unten zur −Z-Achse in Richtung der Erde. Vor dem Ausführen von Drehungen wird die Kamera entlang der Z-Achse nach <height> verschoben. Die Reihenfolge der Transformationen lautet:

<altitude>: entlang der Z-Achse in <height> übersetzen
<heading>: Um die Z-Achse drehen.
<tilt>: Um die X-Achse drehen.
<roll>: um die Z-Achse drehen (noch einmal).

Beachten Sie, dass bei jeder Anwendung einer Drehung zwei der Kameraachsen ihre Ausrichtung ändern.

Kameraspezifische Elemente

<longitude>

Längengrad der virtuellen Kamera (Augenpunkt). Winkelabstand in Grad, relativ zum Nullmeridian. Die Werte westlich des Meridians liegen zwischen −180 und 0 Grad. Die Werte östlich des Meridians liegen zwischen 0 und 180 Grad.

<latitude>

Breite der virtuellen Kamera Grad nördlich oder südlich des Äquators (0 Grad) Die Werte reichen von −90 bis 90 Grad.

<altitude>

Entfernung der Kamera von der Erdoberfläche in Metern. Wird entsprechend den Werten für <heightMode> oder <gx:heightMode> der Kamera interpretiert.

<heading>

Richtung (Azimut) der Kamera in Grad. Standard=0 (wahrer Norden). (siehe Diagramm) Die Werte reichen von 0 bis 360 Grad.

<tilt>

Drehen der Kamera um die X-Achse in Grad. Der Wert 0 gibt an, dass die Ansicht direkt auf die Erde ausgerichtet ist (am häufigsten). Ein Wert für 90 für <tilt> gibt an, dass die Ansicht auf den Horizont ausgerichtet ist. Werte über 90 geben an, dass die Ansicht nach oben zeigt. Die Werte für <tilt> betragen +180 Grad.

<roll>

Drehen der Kamera um die Z-Achse in Grad. Die Werte reichen von −180 bis +180 Grad.

<altitudeMode>

Gibt an, wie die für die Kamera angegebene <height> interpretiert wird. Folgende Werte sind möglich:

relativeToGround – (Standardeinstellung) Interpretiert <height> als Wert in Metern über dem Boden. Wenn der Punkt über dem Wasser liegt, wird <height> als Wert in Metern über dem Meeresspiegel interpretiert. Weitere Informationen zum Festlegen von Punkten relativ zum Meeresgrund finden Sie im Abschnitt <gx:heightMode> unten.
clampToGround: Bei einer Kamera wird mit dieser Einstellung auch relativeToGround festgelegt, da die Kamera auf exakte Geländehöhe ausgerichtet ist. Das bedeutet, dass das Auge das Gelände kreuzt und die Sicht blockiert wird.
absolut: Interpretiert die <height> als Wert in Metern über dem Meeresspiegel.

<gx:heightMode>

Eine KML-Erweiterung im Namespace der Google-Erweiterung, die Höhen relativ zum Meeresboden zulässt. Mögliche Werte:

relativeToSeaFloor: Interpretiert die <height> als Wert in Metern über dem Meeresboden. Wenn der Punkt über Land und nicht über Meer liegt, wird <height> so interpretiert, dass er sich über dem Boden befindet.
clampToSeaFloor: Die <height>-Spezifikation wird ignoriert und die Kamera wird auf dem Meeresboden positioniert. Wenn sich der Zugangspunkt auf Land und nicht auf See befindet, wird die Kamera auf dem Boden platziert.

Erweitert

<Abstraktansicht>

Enthalten durch

Alle aus <Feature> abgeleiteten Elemente
<NetzwerkLinkControl>

Nach oben

<Farbstil>

Syntax

<!-- abstract element; do not create -->
<!-- ColorStyle id="ID" -->          <!-- IconStyle,LabelStyle,LineStyle,PolyStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->
<!-- /ColorStyle -->

Beschreibung

Dies ist ein abstraktes Element und kann nicht direkt in einer KML-Datei verwendet werden. Es bietet Elemente zum Angeben der Farbe und des Farbmodus erweiterter Stiltypen.

Für ColorStyle spezifische Elemente

<color>: Farb- und Deckkraftwerte (Alpha) werden als Hexadezimalwerte ausgedrückt. Der Wert für eine Farbe liegt zwischen 0 und 255 (00 bis ff). Bei Alpha ist 00 vollständig transparent und ff vollständig deckend. Die Reihenfolge des Ausdrucks ist aabbggrr, wobei aa=alpha (00 bis ff); bb=blue (00 bis ff); gg=green (00 bis ff); rr=red (00 bis ff). Wenn Sie beispielsweise eine blaue Farbe mit einer Opazität von 50 % auf ein Overlay anwenden möchten, geben Sie <color>7fff0000</color> an, wobei alpha=0x7f, blue=0xff, green=0x00 und red=0x00
<colorMode>: Die Werte für <colorMode> sind normal (kein Effekt) und random. Mit dem Wert random wird eine zufällige lineare Skala auf die Basis <color> so angewendet:

Um eine wirklich zufällige Farbauswahl zu erhalten, geben Sie die Basis-Farbe <color> (weiß) an.
Wenn Sie eine einfarbige Komponente angeben (z. B. ff0000ff für rot), werden für diese eine zufällige Farbangabe (rot) ausgewählt. In diesem Fall liegen die Werte zwischen 00 (schwarz) und ff (voll rot).
Wenn Sie Werte für zwei oder alle drei Farbkomponenten angeben, wird auf jede Farbkomponente eine zufällige lineare Skala angewendet. Die Werte reichen von Schwarz bis zu den für jede Komponente angegebenen Maximalwerten.
Die Deckkraft einer Farbe stammt von der Alpha-Komponente von <color> und wird niemals nach dem Zufallsprinzip angeordnet.

Erweitert

<Objekt>

Erweitert von

<Symbolstil>
<LabelStyle>
<LineStyle>
<PolyStyle>

Nach oben

<Container>

Syntax

<!-- abstract element; do not create -->
<!-- Container id="ID" -->              <!-- Document,Folder -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <address>...</address>                <!-- string -->
  <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">...
      </AddressDetails>                 <!-- string -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- LookAt or Camera -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>
  <atom:author>...<atom:author>   <!-- xmlns:atom="http://www.w3.org/2005/Atom" -->
  <atom:link href=" "/>

  <!-- specific to Container --> 
  <!-- 0 or more Features -->
<!-- /Container -->

Beschreibung

Dies ist ein abstraktes Element und kann nicht direkt in einer KML-Datei verwendet werden. Ein Containerelement enthält ein oder mehrere Features und ermöglicht die Erstellung verschachtelter Hierarchien.

Erweitert

<Funktion>

Erweitert von

<Dokument>
<Ordner>

Nach oben

<Document>

Syntax

<Document id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                 <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- specific to Document -->
  <!-- 0 or more Schema elements -->
  <!-- 0 or more Feature elements -->
</Document>

Beschreibung

Ein Dokument ist ein Container für Features und Stile. Dieses Element ist erforderlich, wenn Ihre KML-Datei gemeinsam genutzte Stile verwendet. Wir empfehlen die Verwendung gemeinsam genutzter Stile. Dazu sind folgende Schritte erforderlich:

Definieren Sie alle Stile in einem Dokument. Jedem Stil eine eindeutige ID zuweisen.

Verweisen Sie in einer bestimmten Funktion oder StyleMap mithilfe eines <styleUrl>-Elements auf die ID des Stils.

Hinweis: Gemeinsame Stile werden nicht von den Funktionen im Dokument übernommen.

Jede Funktion muss explizit die Stile angeben, die in einem <styleUrl>-Element verwendet werden. Bei einem Stil, der auf ein Dokument angewendet wird (z. B. ListStyle), muss das Dokument selbst auf <styleUrl> verweisen. Beispiel:

<Document>
  <Style id="myPrettyDocument">
   <ListStyle> ... </ListStyle>

  </Style>
  <styleUrl#myPrettyDocument">
  ...
</Document>

Legen Sie freigegebene Stile nicht in einem Ordner fest.

Das folgende Beispiel zeigt die Verwendung eines gemeinsamen Stils.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>Document.kml</name>
  <open>1</open>
  <Style id="exampleStyleDocument">
    <LabelStyle>
      <color>ff0000cc</color>
    </LabelStyle>
  </Style>
  <Placemark>
    <name>Document Feature 1</name>
    <styleUrl>#exampleStyleDocument</styleUrl>
    <Point>
      <coordinates>-122.371,37.816,0</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <name>Document Feature 2</name>
    <styleUrl>#exampleStyleDocument</styleUrl>
    <Point>
      <coordinates>-122.370,37.817,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Erweitert

<Container>

Enthält

0 oder mehr Elemente stammen aus <Feature>
0 oder mehr Elemente aus <StyleSelector> abgeleitet
0 oder mehr Elemente aus <Schema> abgeleitet

Nach oben

<gx:Dauer>

Dieses Element ist eine Erweiterung des OGC KML 2.2-Standards und wird ab Google Earth 5.0 unterstützt. Weitere Informationen

Syntax

<gx:duration>0.0</gx:duration>            <!-- double -->

Beschreibung

<gx:duration> erweitert gx:TourPrimitive durch die Angabe einer Zeitspanne für Ereignisse. Die Zeit wird in Sekunden unter Verwendung des XML-Datentyps double geschrieben.

Dauer und <gx:FlyTo>

Wenn eine Dauer in einem <gx:FlyTo>-Element enthalten ist, gibt sie die Dauer an, die der Browser benötigt, um vom vorherigen zum angegebenen Punkt zu fliegen.

<gx:FlyTo>
  <gx:flyToMode>bounce</gx:flyToMode>
  <gx:duration>10.2</gx:duration>

  <!-- AbstractView -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

Dauer und <gx:Animiertes Update>

Gibt den Zeitraum an, über den die Aktualisierung erfolgt. Ganzzahl-, Gleitkomma- und Farbfelder werden während der gesamten Dauer gleichmäßig vom Original zum neuen Wert animiert. Boolesche Werte, Strings und andere Werte, die keine Interpolation auslösen, werden am Ende des Zeitraums aktualisiert.

<gx:AnimatedUpdate>
  <gx:duration>5.0</gx:duration>
  <Update>

    ....

  </Update>
</gx:AnimatedUpdate>

<Erweiterte Daten>

Syntax

<ExtendedData>                       
  <Data name="string">
    <displayName>...</displayName>    <!-- string -->
    <value>...</value>                <!-- string -->
  </Data>
  <SchemaData schemaUrl="anyURI">
    <SimpleData name=""> ... </SimpleData>   <!-- string -->
  </SchemaData>
  <namespace_prefix:other>...</namespace_prefix:other>
</ExtendedData>

Beschreibung

Das ExtendedData-Element bietet drei Methoden, um einer KML-Funktion benutzerdefinierte Daten hinzuzufügen: NetworkLink, Ortsmarkierungen, GroundOverlay, PhotoOverlay, ScreenOverlay, Document, Folder. Diese Methoden sind

Nicht typisierte Daten/Wert-Paare mit dem Element <Daten> (einfach) hinzufügen
Neue typisierte Felder mit dem Element <Schema> deklarieren und dann mit dem Element <SchemaData> als erweitert festlegen (erweitert)
Verweisen auf XML-Elemente, die in anderen Namespaces definiert wurden, durch Verweis auf den externen Namespace innerhalb der KML-Datei (einfach)

Diese Verfahren können in einer einzelnen KML-Datei oder in einem Feature für verschiedene Daten kombiniert werden.

Weitere Informationen finden Sie unter Benutzerdefinierte Daten hinzufügen unter „Themen in KML“.

Für ExtendedData spezifische Elemente

<Datenname ="string">

Erstellt ein Name/Wert-Paar ohne Typ. Der Name kann zwei Versionen haben: name und displayName. Mit dem Attribut name wird das Datenpaar innerhalb der KML-Datei identifiziert. Das Element displayName wird verwendet, wenn in Google Earth ein richtig formatierter Name mit Leerzeichen und HTML-Formatierung angezeigt wird. Im <text>-Element von <BalloonStyle> wird die Notation $[name/displayName] durch <displayName> ersetzt. Wenn Sie den Wert des Attributs name des Elements <Data> in diesem Format ersetzen, wird der Attributwert durch $[holeYardage] standardmäßig durch <value> ersetzt. Standardmäßig wird der Name des Info-Pop-ups des Ortsmarkierungsnamens angezeigt.

<displayName>

Eine optionale formatierte Version von Name, die zu Anzeigezwecken verwendet wird.

<Wert>

Wert des Datenpaars.

<Placemark>
  <name>Club house</name>
  <ExtendedData>
    <Data name="holeNumber">
      <value>1</value>
    </Data>
    <Data name="holeYardage">
      <value>234</value>
    </Data>
    <Data name="holePar">
      <value>4</value>
    </Data>
  </ExtendedData>
</Placemark>

<SchemaData schemaUrl="beliebiger URI">

Dieses Element wird in Verbindung mit <Schema> verwendet, um einem KML-Element typisierte benutzerdefinierte Daten hinzuzufügen. Das Schema-Element (gekennzeichnet durch das Attribut schemaUrl) deklariert den benutzerdefinierten Datentyp. Die tatsächlichen Datenobjekte („Instanzen“ der benutzerdefinierten Daten) werden mit dem SchemaData-Element definiert.

Die <schemaURL> kann eine vollständige URL, ein Verweis auf eine Schema-ID, die in einer externen KML-Datei definiert ist, oder ein Verweis auf eine Schema-ID sein, die in derselben KML-Datei definiert ist. Alle der folgenden Spezifikationen sind zulässig:

schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"

schemaUrl="AnotherFile.kml#my-schema-id"

schemaUrl="#schema-id"   <!-- same file -->

Das Schema-Element ist immer „Document“. Das ExtendedData-Element ist ein untergeordnetes Element der Funktion, die die benutzerdefinierten Daten enthält.

<SimpleData name="String">: Mit diesem Element wird dem benutzerdefinierten Datenfeld, das durch das Attribut name gekennzeichnet ist, ein Wert zugewiesen. Der Typ und der Name dieses benutzerdefinierten Datenfelds werden im <Schema>-Element deklariert.; Hier ein Beispiel für die Definition von zwei benutzerdefinierten Datenelementen:

<Namespace_Präfix:Andere>: Mit diesem Element können Sie untypisierte benutzerdefinierte Daten hinzufügen. Achten Sie darauf, das Namespace-Präfix im <KML>-Element Ihrer Datei oder als Attribut des <ExtendedData>-Elements anzugeben und den Namen jedes Datenelements mit dem Namespace-Präfix zu versehen. Benutzerdefinierte Daten, die auf diese Weise hinzugefügt wurden, werden in der KML-Datei gespeichert, aber in keiner Weise von Google Earth verwendet. Sie wird immer zusammen mit der Datei gespeichert.; Im folgenden Beispiel wird das Namespace-Präfix „camp“ verwendet:

Enthalten durch

Alle aus <Feature> abgeleiteten Elemente

Weitere Informationen

Schema

<Funktion>

Syntax

<!-- abstract element; do not create -->
<!-- Feature id="ID" -->                <!-- Document,Folder,
                                             NetworkLink,Placemark,
                                             GroundOverlay,PhotoOverlay,ScreenOverlay -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>    <!-- TimeStamp or TimeSpan -->
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->
<-- /Feature -->

Beschreibung

Dies ist ein abstraktes Element und kann nicht direkt in einer KML-Datei verwendet werden. Das folgende Diagramm zeigt, wie einige Elemente von Elementen in Google Earth dargestellt werden.

Funktionsspezifische Elemente

<name>

Benutzerdefinierter Text, der im 3D-Viewer als Label für das Objekt angezeigt wird (z. B. für eine Ortsmarkierung, einen Ordner oder einen NetworkLink).

<visibility>

Boolescher Wert. Gibt an, ob das Element beim ersten Laden im 3D-Viewer gezeichnet wird. Damit ein Feature sichtbar wird, muss für alle Vorgänger auch das <visible>-Tag auf 1 festgelegt werden. In der Google Earth-Listenansicht gibt es für jede Funktion ein Kontrollkästchen, mit dem der Nutzer die Sichtbarkeit der Funktion steuern kann.

<open>

Boolescher Wert. Gibt an, ob ein Dokument oder Ordner beim ersten Laden in das Fenster „Orte“ geschlossen oder geöffnet angezeigt wird. 0=minimiert (Standardeinstellung), 1=maximiert. Siehe auch <ListStyle>. Dieses Element gilt nur für Dokument, Ordner und NetworkLink.

<atom:author>

KML 2.2 unterstützt neue Elemente, mit denen Sie Daten über den Autor und die zugehörige Website in Ihre KML-Datei einfügen können. Diese Informationen werden in Geo-Suchergebnissen sowohl in Google Earth-Browsern wie Google Earth als auch in anderen Anwendungen wie Google Maps angezeigt. In KML werden die folgenden CSS-Elemente verwendet:

atom:author-Element – übergeordnetes Element für atom:name
Element atom:name – Name des Autors
atom:link-Element – enthält das Attribut href
href-Attribut – URL der Webseite mit der KML-/KMZ-Datei

Diese Elemente werden im Atom Syndication-Format definiert. Die vollständige Spezifikation finden Sie unter http://atompub.org. (siehe Beispiel unten).

Das Element <atom:author> ist das übergeordnete Element für <atom:name>, das den Autor der KML-Funktion angibt.

<atom:link href="..." >

Gibt die URL der Website an, die diese KML- oder KMZ-Datei enthält. Achten Sie darauf, den Namespace für dieses Element in jede KML-Datei aufzunehmen, die es verwendet: xmlns:atom="http://www.w3.org/2005/Atom" (siehe Beispiel).

<address>

Ein Stringwert, der eine unstrukturierte Adresse darstellt, die als Standardstraße, -stadt, -bundesstaatliche Adresse und/oder Postleitzahl angegeben ist. Sie können das <address>-Tag verwenden, um den Standort eines Punkts anzugeben, anstatt Koordinaten für Längen- und Breitengrad zu verwenden. Wenn jedoch ein <Point> angegeben ist, hat er Vorrang vor <address>. Informationen dazu, welche Sprachen für dieses Tag in Google Earth unterstützt werden, finden Sie in der Google Maps-Hilfe.

<xal:AddressDetails>

Eine strukturierte Adresse im Format xAL oder eXtensible Address Language, ein internationaler Standard für die Formatierung von Adressen. <xal:AddressDetails> wird von KML nur für die Geocodierung in Google Maps verwendet. Weitere Informationen finden Sie in der Dokumentation zur Google Maps API. Dieses Element wird in Google Earth derzeit nicht verwendet. Verwenden Sie stattdessen <address>. Achten Sie darauf, den Namespace für dieses Element in jede KML-Datei aufzunehmen, in der es verwendet wird: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<phoneNumber>

Ein Stringwert, der eine Telefonnummer darstellt. Dieses Element wird nur von Google Maps Mobile verwendet. Der Branchenstandard für Java-fähige Mobiltelefone ist RFC2806.
Weitere Informationen finden Sie unter http://www.ietf.org/rfc /rfc2806.txt.

<Snippet maxLines="2" >

Eine kurze Beschreibung des Elements. In Google Earth wird diese Beschreibung im Fenster „Orte“ unter dem Namen des Elements angezeigt. Wenn kein Snippet angegeben ist, werden die ersten beiden Zeilen von <description> verwendet. Wenn eine Ortsmarkierung in Google Earth sowohl eine Beschreibung als auch ein Snippet enthält, wird <Snippet> im Bereich „Orte“ unter der Ortsmarkierung und <description> im Info-Pop-up angezeigt. Dieses Tag unterstützt kein HTML-Markup. <Snippet> hat ein maxLines-Attribut. Das ist eine Ganzzahl, die die maximale Anzahl der anzuzeigenden Zeilen angibt.

<description>

Von Nutzern bereitgestellte Inhalte, die im Info-Pop-up angezeigt werden.

Der unterstützte Inhalt für das Element <description> wurde von Google Earth 4.3 in 5.0 geändert. Die spezifischen Informationen zu jeder Version sind unten aufgeführt, gefolgt von Informationen, die für beide Versionen gelten.

Google Earth 5.0

In Google Earth 5.0 (und neueren Versionen) werden Info-Pop-ups sowohl als Nur-Text-Content als auch als HTML- und JavaScript-Code unterstützt. Der Inhalt des Beschreibungs-Tags wird vom Open-Source-Webbrowser des WebKits gerendert und wie in jedem anderen WebKit-basierten Browser dargestellt.

Allgemeine Einschränkungen

Links zu lokalen Dateien sind in der Regel nicht zulässig. Dadurch wird verhindert, dass schädlicher Code dein System beschädigt oder auf deine Daten zugreift. Wenn Sie den Zugriff auf Ihr lokales Dateisystem zulassen möchten, wählen Sie Einstellungen > Zugriff auf lokale Dateien und personenbezogene Daten zulassen aus. Links zu Bilddateien im lokalen Dateisystem sind immer zulässig, wenn sie in einem <img>-Tag enthalten sind.

Auf Inhalte, die in einer KMZ-Datei komprimiert wurden, kann selbst dann zugegriffen werden, wenn sie sich im lokalen Dateisystem befinden.

Cookies sind aktiviert, aber gemäß der Richtlinie zu demselben Ursprung werden lokale Inhalte nicht mit anderen Inhalten (einschließlich anderer lokaler Inhalte) geteilt.

HTML

HTML wird größtenteils wie jeder andere WebKit-Browser gerendert.

Ziele werden ignoriert, wenn sie direkt im HTML-Code in die KML-Datei geschrieben werden. Alle diese Links werden geöffnet, als wäre das Ziel auf _blank gesetzt. Alle angegebenen Ziele werden ignoriert.

In einem iFrame enthaltener oder dynamisch mit JavaScript oder DHTML generierter HTML-Code wird hingegen target="_self" als Standard verwendet. Andere Ziele können angegeben werden und werden unterstützt.

Der Content von KMZ-Dateien, lokalen Ankerlinks und ;flyto-Methoden kann nicht über den HTML-Code eines iFrames ausgerichtet werden.

Wenn der Nutzer für die Breite eines iFrames width="100%" angibt, hängt die Breite des iFrames von allen anderen Inhalten im Info-Pop-up ab. Er sollte bei der Berechnung der Layoutgröße im Wesentlichen ignoriert werden. Diese Regel gilt auch für alle anderen Blockelemente innerhalb des Info-Pop-ups.

JavaScript

JavaScript wird in den meisten Fällen unterstützt. Dialogfelder können nicht erstellt werden – Funktionen wie „alert()“ und „prompt()“ werden nicht angezeigt. Sie werden jedoch ebenso wie andere Fehler und Ausnahmen in die Systemkonsole geschrieben.

Preisvergleichsportal

CSS ist zulässig. Wie CSS in einem regulären Webbrowser können Sie mit CSS Stile für Text und Seitenelemente festlegen und die Größe und Darstellung des Info-Pop-ups steuern.

Google Earth 4.3

Das Element <description> unterstützt sowohl Text, als auch einen Teil der HTML-Formatierungselemente, einschließlich Tabellen (siehe KML-Beispiel unten). Andere webbasierte Technologien wie dynamische Seiten-Markups (PHP, JSP, ASP), Skriptsprachen (VBScript, JavaScript) oder Anwendungssprachen (Java, Python) werden nicht unterstützt. In Google Earth Version 4.2 wird das Video unterstützt. (siehe Beispiel unten).

Allgemeine Informationen

Wenn Ihre Beschreibung kein HTML-Markup enthält, wird sie in Google Earth formatiert. Zeilenumbrüche werden durch <br> und URLs mit Anchor-Tags ersetzt. Ein gültiger URL-String für das World Wide Web wird automatisch in einen Hyperlink zu dieser URL umgewandelt (z.B. http://www.google.com). Sie müssen folglich keine URL in die <a href="http://.."></a>-Tags einfügen, um einen einfachen Link zu erhalten.

Wenn Sie HTML-Code verwenden, um einen Hyperlink um ein bestimmtes Wort zu erstellen, oder wenn Sie Bilder in den HTML-Code einfügen, müssen Sie HTML-Entitätsverweise oder das CDATA-Element verwenden, um spitze Klammern, Apostrophe und andere Sonderzeichen zu maskieren. Das CDATA-Element weist den XML-Parser an, Sonderzeichen in Klammern zu ignorieren. Dieses Element hat die Form:

<![CDATA[
  special characters here
]]>

Wenn Sie das CDATA-Element nicht verwenden möchten, können Sie mithilfe von Entitätsreferenzen alle Sonderzeichen ersetzen.

<description>
  <![CDATA[
This is an image
<img src="icon.jpg">
  ]]>
</description>

Andere Funktionsweise, die über das <a>-Element festgelegt wird

KML unterstützt die Verwendung von zwei Attributen im <a>-Element: href und type.

Das Anchor-Element <a> enthält ein href-Attribut, das eine URL angibt.

Wenn die href-Datei eine KML-Datei ist und eine KML- oder KMZ-Dateierweiterung hat, lädt Google Earth diese Datei direkt, wenn der Nutzer darauf klickt. Wenn die URL mit einer Erweiterung endet, die Google Earth nicht bekannt ist (z. B. .html), wird die URL an den Browser gesendet.

href kann eine Fragment-URL sein, also eine URL mit einem #-Zeichen, gefolgt von einer KML-ID. Wenn der Nutzer auf einen Link klickt, der eine Fragment-URL enthält, fliegt der Browser standardmäßig zu dem Element, dessen ID mit dem Fragment übereinstimmt. Wenn das Element über ein LookAt- oder Kamera-Element verfügt, wird es vom angegebenen Blickwinkel aus angesehen.

Sie können die Funktionsweise weiter spezifizieren, indem Sie einen der folgenden Strings an die Fragment-URL anhängen:

;flyto (Standard) – zum Element fliegen
;Info-Pop-up – Info-Pop-up des Elements öffnen, ohne das Element zu fliegen
;balloonFlyto: Info-Pop-up des Elements öffnen und zum Element fliegen

Beispiel: Der folgende Code gibt an, dass die Datei CraftsFairs.kml geöffnet und die Ortsmarkierung mit der ID „Albuquerque“ geöffnet wird. Anschließend wird das Info-Pop-up geöffnet:

<description>
  <![CDATA[ 
    <a href="http://myServer.com/CraftsFairs.kml#Albuquerque;balloonFlyto">
      One of the Best Art Shows in the West</a>
  ]]>
</description>

Das Attribut type wird innerhalb des Elements <a> verwendet, wenn href nicht auf .KML oder .kmz endet, aber die Referenz im Kontext von KML interpretiert werden muss. Geben Sie Folgendes an:

type="application/vnd.google-earth.kml+xml"

In der folgenden URL wird z. B. das Attribut type verwendet, um Google Earth darüber zu informieren, dass sie versuchen sollte, die Datei zu laden, obwohl die Dateierweiterung .php lautet:

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">

<AbstractView>

Definiert einen Blickwinkel, der mit einem von einem Element abgeleiteten Element verknüpft ist. Weitere Informationen finden Sie unter <Camera> und <LookAt>.

<TimePrimitive>

Ordnet dieses Feature einem Zeitraum (<TimeSpan>) oder einem Zeitpunkt (<TimeStamp>) zu.

<styleUrl>

Die URL eines in einem Dokument definierten <Style>- oder <StyleMap>-Elements. Wenn sich der Stil in derselben Datei befindet, verwenden Sie eine Referenz #. Wenn der Stil in einer externen Datei definiert ist, verwenden Sie eine vollständige URL zusammen mit #-Verweis. Beispiele:

<styleUrl>#myIconStyleID</styleUrl>

<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>

<styleUrl>eateries.kml#my-lunch-spot</styleUrl>

<Stilauswahl>

Ein oder mehrere Stile und StyleMaps können definiert werden, um die Darstellung eines aus dem Feature oder der Geometrie abgeleiteten Elements in einer Ortsmarkierung anzupassen. Weitere Informationen finden Sie unter <BalloonStyle>, <ListStyle>, <StyleSelector> und die aus <ColorStyle> abgeleiteten Stile. Ein in einem Feature definierter Stil wird als „Inline-Style“ bezeichnet und gilt nur für das Feature, das es enthält. Ein Stil, der als untergeordnetes Element von <Document> definiert ist, wird als gemeinsam genutzter Stil bezeichnet. Für einen gemeinsamen Stil muss eine id definiert sein. Auf diese ID wird in <Document> von einem oder mehreren Elementen verwiesen. Wenn ein Stilelement sowohl in einem gemeinsamen Stil als auch in einem Inline-Style für ein Element definiert ist, d. h. ein Ordner, ein Boden-Overlay, ein Netzwerk-Link, eine Ortsmarkierung oder ein Bildschirm-Overlay, hat der Wert für den Inline-Stil Vorrang vor dem Wert für den gemeinsamen Stil.

<Region>

Mit einer Region verknüpfte Merkmale und Geometrie werden nur gezeichnet, wenn die Region aktiv ist. Weitere Informationen finden Sie unter <Region>.

<Metadata>

<ExtendedData>:

Damit können Sie einer KML-Datei benutzerdefinierte Daten hinzufügen. Bei diesen Daten kann es sich um (1) Daten handeln, die auf ein externes XML-Schema verweisen, (2) nicht typisierte Daten/Wert-Paare oder (3) typisierte Daten. Ein bestimmtes KML-Merkmal kann eine Kombination dieser Arten von benutzerdefinierten Daten enthalten.

Beispiel für die Verwendung von HTML-Elementen in einer Beschreibung

Dieses Beispiel zeigt den vollständigen Satz von HTML-Elementen, die vom Element <description> in Google Earth 4.3 unterstützt werden. Google Earth 5.0 und höher unterstützt vollständiges HTML und JavaScript.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
  <name>Feature.kml</name>
  <Snippet maxLines="4">
    The snippet is a way of
    providing an alternative
    description that will be
    shown in the List view.
  </Snippet> 
  <description>
    <![CDATA[
      Styles: <i>Italics</i>, <b>Bold</b>, <u>Underlined</u>, 
      <s>Strike Out</s>, subscript<sub>subscript</sub>,
      superscript<sup>superscript</sup>,  
      <big>Big</big>, <small>Small</small>, <tt>Typewriter</tt>,
      <em>Emphasized</em>, <strong>Strong</strong>, <code>Code</code>
      <hr />
      Fonts: 
      <font color="red">red by name</font>, 
      <font color="#408010">leaf green by hexadecimal RGB</font>, 
      <font size=1>size 1</font>, <font size=2>size 2</font>,
      <font size=3>size 3</font>, <font size=4>size 4</font>,
      <font size=5>size 5</font>, <font size=6>size 6</font>, 
      <font size=7>size 7</font>,
      <font face=times>Times</font>, 
      <font face=verdana>Verdana</font>, 
      <font face=arial>Arial</font>
      <br/>
      <hr />
      Links:
      <a href="http://doc.trolltech.com/3.3/qstylesheet.html">
      QT Rich Text Rendering
      </a>
      <br />
      <hr />
      Alignment:
      <br />
      <p align=left>left</p><p align=center>center</p>
      <p align=right>right</p>
      <hr />
      Ordered Lists:
      <br />
      <ol><li>First</li><li>Second</li><li>Third</li></ol>
      <ol type="a"><li>First</li><li>Second</li><li>Third</li></ol>
      <ol type="A"><li>First</li><li>Second</li><li>Third</li></ol>
      <hr />
      Unordered Lists:
      <br />
      <ul><li>A</li><li>B</li><li>C</li></ul>
      <ul type="circle"><li>A</li><li>B</li><li>C</li></ul>
      <ul type="square"><li>A</li><li>B</li><li>C</li></ul>
      <hr />
      Definitions:
      <br />
      <dl>
      <dt>Scrumpy</dt>
      <dd>Hard English cider from the west country</dd>
      <dt>Pentanque</dt>
      <dd>A form of boules where the goal is to throw metal ball as
      close as possible to a jack</dd>
      </dl>
      <hr />
      Block Quote:
      <br />
      <blockquote>
      We shall not cease from exploration<br />
      And the end of all our exploring<br />
      Will be to arrive where we started<br />
      And know the place for the first time
      </blockquote>
      <br />
      <hr />
      Centered:
      <br />
      <center>See, I have a Rhyme assisting<br />
      my feeble brain,<br />
      its tasks oft-times resisting!</center>
      <hr />
      Headings:
      <br />
      <h1>Header 1</h1>
      <h2>Header 2</h2>
      <h3>Header 3</h3>
      <h3>Header 4</h4>
      <h3>Header 5</h5>
      <hr />
      Images:
      <br />
      <img src="icon.jpg"> 
and we have a link http://www.google.com.]]>
  </description>
  <Point>
    <coordinates>-122.378927,37.826793,0</coordinates>
  </Point>
</Placemark>
</kml>

Beispiel für die Verwendung von Skriptelementen

In diesem Beispiel werden die Elemente <atom:author>, <atom:name> und <atom:link> aus dem Atom-Namespace verwendet. Beachten Sie, dass Sie innerhalb des <KML>-Elements auf diesen Namespace verweisen müssen.

<kml xmlns="http://www.opengis.net/kml/2.2"
     xmlns:atom="http://www.w3.org/2005/Atom"> 
  <Document>
    <atom:author>
      <atom:name>J. K. Rowling</atom:name>
    </atom:author>
    <atom:link href="http://www.harrypotter.com" />
    <Placemark>
      <name>Hogwarts</name>
      <Point>
        <coordinates>1,1</coordinates>
      </Point>
    </Placemark>
    <Placemark>
      <name>Little Hangleton</name>
      <Point>
        <coordinates>1,2</coordinates>
      </Point>
    </Placemark>
  </Document>
</kml>

Beispielvideo

In diesem Beispiel wird gezeigt, wie Sie ein Flash-Video in das Info-Pop-up einbetten.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <name>Video Example</name>
    <Style id="sn_blue-dot_copy3">
      <IconStyle>
        <Icon>
          <href>http://www.google.com/intl/en_us/mapfiles/ms/icons/blue-dot.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <Placemark>
      <name>Placemark</name>
      <description>
        <![CDATA[<div style="font-size:larger">
          <div>
            <div style="width: 212px; font-size: 12px;">
              <b>The Spaghetti Film</b>
            </div>
            <div style="font-size: 11px;">
              <a target="_blank" href="http://www.youtube.com/?v=FICUvrVlyXc">
                http://www.youtube.com/?v=FICUvrVlyXc</a><br>
            </div><br>
            <div style="margin-left: auto; margin-right:auto;">
              <object height="175" width="212">
                <param value="http://www.youtube.com/v/FICUvrVlyXc" name="movie">
                <param value="transparent" name="wmode">
                <embed wmode="transparent" type="application/x-shockwave-flash"
                   src="http://www.youtube.com/v/FICUvrVlyXc" height="175"
                   width="212">
               </object>
             </div>
           </div>
          </div>
          <div style="font-size: smaller; margin-top: 1em;">Saved from 
            <a href="http://maps.google.com/ig/add?synd=mpl&pid=mpl&moduleurl=
                http:%2F%2Fwww.google.com%2Fig%2Fmodules%2Fmapplets-youtube.xml&hl=en&gl=us">
                YouTubeVideos</a>
          </div>
         ]]>
      </description>
      <styleUrl>#sn_blue-dot_copy3</styleUrl>
      <Point>
        <coordinates>-93.47875999999999,45.083248,0</coordinates>
      </Point>
    </Placemark>
</Document>
</kml>

Erweitert

<Objekt>

Erweitert von

<Container>
<Overlay>
<Ortsmarkierung>
<NetworkLink>
<gx:Tour>

<gx:FlyTo>

Dieses Element ist eine Erweiterung des OGC KML 2.2-Standards und wird ab Google Earth 5.0 unterstützt. Weitere Informationen

Syntax

<gx:FlyTo id="ID">
  <gx:duration>0.0</gx:duration>         <!-- double -->
  <gx:flyToMode>bounce</gx:flyToMode>    <!-- smooth or bounce -->
  <!-- AbstractView -->                        <!-- Camera or LookAt -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

Beschreibung

<gx:FlyTo> gibt einen Punkt an, zu dem der Browser während einer Tour fliegen soll. Es muss ein Element des Typs Abstraktansicht enthalten und sollte die Elemente <gx:duration> und <gx:flyToMode> enthalten, mit denen die Flugzeit zum definierten Punkt vom aktuellen Punkt bzw. zur Flugmethode angegeben wird.

<gx:flyToMode>

Für <gx:flyToMode> sind zwei Werte zulässig: smooth und bounce.

Flüssige FlyTos ermöglichen einen ununterbrochenen Flug von einem Punkt zum nächsten (und weiter). Eine ununterbrochene Reihe glatter FlyTos beginnt bei null Geschwindigkeit und wird nicht an jedem Punkt langsam. Eine Reihe von fließenden FlyTos wird durch eines der folgenden Elemente beschädigt:
- <gx:flyToMode>bounce</gx:flyToMode>
- <gx:Wait>
Das bedeutet, dass die Geschwindigkeit in der gleichmäßigen FlyTo-Funktion unmittelbar vor einem der Elemente oben liegt. Eine Reihe von fließenden FlyTos wird nicht durch <gx:AnimierteUpdate>-Elemente unterbrochen.

Absprünge FlyTos beginnen und enden mit Nullgeschwindigkeit.

Beispiel

<gx:FlyTo>
  <gx:duration>2.55</gx:duration>
  <gx:flyToMode>smooth</gx:flyToMode>
  <Camera>
    <longitude>-113.084448</longitude>
    <latitude>36.567081</latitude>
    <altitude>41277.571403</altitude>
    <heading>116.150227</heading>
    <altitudeMode>absolute</altitudeMode>
  </Camera>
</gx:FlyTo>

Erweitert

<gx:TourPrimitive>

Enthält

<gx:Dauer>
<gx:flyToMode>
<Abstraktansicht>

<Folder>

Syntax

<Folder id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>

  <!-- specific to Folder -->
  <!-- 0 or more Feature elements -->
</Folder>

Beschreibung

Ein Ordner dient dazu, andere Elemente hierarchisch anzuordnen (Ordner, Ortsmarken, NetworkLinks oder Overlays). Ein Feature ist nur sichtbar, wenn es und alle seine Ancestors sichtbar sind.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Folder>
  <name>Folder.kml</name>
  <open>1</open>
  <description>
    A folder is a container that can hold multiple other objects
  </description>
  <Placemark>
    <name>Folder object 1 (Placemark)</name>
    <Point>
      <coordinates>-122.377588,37.830266,0</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <name>Folder object 2 (Polygon)</name>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.377830,37.830445,0
            -122.377576,37.830631,0
            -122.377840,37.830642,0
            -122.377830,37.830445,0
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </Placemark>
  <Placemark>
    <name>Folder object 3 (Path)</name>
    <LineString>
      <tessellate>1</tessellate>
      <coordinates>
        -122.378009,37.830128,0 -122.377885,37.830379,0
      </coordinates>
    </LineString>
  </Placemark>
</Folder>
</kml>

Erweitert

<Container>

Enthält

Alle aus <Feature> abgeleiteten Elemente

<Geometrie>

Syntax

<!-- abstract element; do not create -->
<!-- Geometry id="ID" -->
                                              <!-- Point,LineString,LinearRing,
                                               Polygon,MultiGeometry,Model,
                                               gx:Track -->
<!-- /Geometry -->

Beschreibung

Dies ist ein abstraktes Element und kann nicht direkt in einer KML-Datei verwendet werden. Sie stellt ein Platzhalterobjekt für alle abgeleiteten Geometrieobjekte bereit.

Erweitert

<Objekt>

Erweitert von

<Punkt>
<LineString>
<LinearRing>
<Polygon>
<MultiGeometrie>
<gx:MultiTrack>
<Modell>
<gx:Track>

<GroundOverlay>

Syntax

<GroundOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- inherited from Overlay element -->
  <color>ffffffff</color>                   <!-- kml:color -->
  <drawOrder>0</drawOrder>                  <!-- int -->
  <Icon>...</Icon>

  <!-- specific to GroundOverlay -->
  <altitude>0</altitude>                    <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
     <!-- kml:altitudeModeEnum: clampToGround or absolute -->
     <!-- or, substitute gx:altitudeMode: clampToSeaFloor or relativeToSeaFloor -->
  <LatLonBox>
    <north>...</north>                      <! kml:angle90 -->
    <south>...</south>                      <! kml:angle90 -->
    <east>...</east>                        <! kml:angle180 -->
    <west>...</west>                        <! kml:angle180 -->
    <rotation>0</rotation>                  <! kml:angle180 -->
  </LatLonBox>
  <gx:LatLonQuad>
    <coordinates>...</coordinates>          <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

Beschreibung

Mit diesem Element wird ein auf dem Gelände drapiertes Bild-Overlay gezeichnet. Das untergeordnete Element <href> von <Icon> gibt das Bild an, das als Overlay verwendet werden soll. Diese Datei kann sich entweder in einem lokalen Dateisystem oder auf einem Webserver befinden. Wenn dieses Element weggelassen wird oder kein <href>-Element enthält, wird ein Rechteck mit den vom Boden-Overlay definierten Farben LatLonBox gezeichnet.

Spezielle Elemente für Boden-Overlays

<altitude>

Gibt die Entfernung über der Erdoberfläche in Metern an und wird entsprechend dem Höhenmodus interpretiert.

<altitudeMode>

Gibt an, wie <height> interpretiert wird. Mögliche Werte sind:

clampToGround – (Standardeinstellung) Gibt an, dass die Höhenangabe ignoriert und das Overlay über dem Gelände eingeblendet wird.
absolute: Legt die Höhe des Overlays relativ zum Meeresspiegel fest, unabhängig von der tatsächlichen Höhe des Geländes unter dem Element. Wenn Sie die Höhe eines Overlays beispielsweise im Modus „Absolute Höhe“ auf 10 Meter festlegen, erscheint das Overlay auf Bodenhöhe, wenn das Gelände darunter auch 10 Meter über dem Meeresspiegel liegt. Wenn das Gelände 3 Meter über dem Meeresspiegel liegt, wird es 7 Meter über dem Gelände angezeigt.

<gx:heightMode>

Eine KML-Erweiterung im Namespace der Google-Erweiterung, die Höhen relativ zum Meeresboden zulässt. Mögliche Werte:

relativeToSeaFloor: Interpretiert die <height> als Wert in Metern über dem Meeresboden. Wenn der Punkt über Land und nicht über Meer liegt, wird <height> so interpretiert, dass er sich über dem Boden befindet.
clampToSeaFloor: Die Spezifikation <height> wird ignoriert und das Overlay wird über dem Meeresboden eingeblendet. Wenn der Punkt an Land und nicht auf See ist, wird das Overlay auf dem Boden positioniert.

<LatLonBox>

Gibt an, wo oben, unten, rechts und links in einem Begrenzungsrahmen für das Boden-Overlay ausgerichtet werden soll.

<north> Gibt den Breitengrad des nördlichen Rands des Markierungsrahmens in Dezimalgraden von 0 bis ±90 an.
<south> Gibt den Breitengrad des Südrands des Begrenzungsrahmens an, mit Dezimalgrad zwischen 0 und ±90.
<east> Gibt den Längengrad des östlichen Rands des Markierungsrahmens in Dezimalgraden von 0 bis ±180 an. Bei Overlays, die sich mit dem 180°-Längengrad überschneiden, können Werte über diesen Bereich hinaus erweitert werden.
<west> Gibt den Längengrad des Westrands des Markierungsrahmens in Dezimalgraden von 0 bis ±180 an. Bei Overlays, die sich mit dem 180°-Längengrad überschneiden, können Werte über diesen Bereich hinaus erweitert werden.
<rotation>: Gibt die Rotation des Overlays um seine Mitte in Grad an. Mögliche Werte sind ±180. Der Standardwert ist 0 (Norden). Drehungen werden in gegen den Uhrzeigersinn angegeben.

<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox>

<gx:LatLonQuad>

Wird für nicht rechteckige rechteckige Boden-Overlays verwendet.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<GroundOverlay>
   <name>GroundOverlay.kml</name>
   <color>7fffffff</color>
   <drawOrder>1</drawOrder>
   <Icon>
      <href>http://www.google.com/intl/en/images/logo.gif</href>
      <refreshMode>onInterval</refreshMode>
      <refreshInterval>86400</refreshInterval>
      <viewBoundScale>0.75</viewBoundScale>
   </Icon>
   <LatLonBox>
      <north>37.83234</north>
      <south>37.832122</south>
      <east>-122.373033</east>
      <west>-122.373724</west>
      <rotation>45</rotation>
   </LatLonBox>
</GroundOverlay>
</kml>

Erweitert

<Funktion>
<Overlay>

Enthalten durch

<Dokument>
<Ordner>

<Icon>

Syntax

<Icon id="ID">
  <!-- specific to Icon -->
  <href>...</href>                         <!-- anyURI -->
  <gx:x>0<gx:x/>                           <!-- int -->
  <gx:y>0<gx:y/>                           <!-- int -->
  <gx:w>-1<gx:w/>                          <!-- int -->
  <gx:h>-1<gx:h/>                          <!-- int -->
  <refreshMode>onChange</refreshMode>
    <!-- kml:refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>     <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- kml:viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>     <!-- float -->
  <viewBoundScale>1</viewBoundScale>       <!-- float -->
  <viewFormat>...</viewFormat>             <!-- string -->
  <httpQuery>...</httpQuery>               <!-- string -->
</Icon>

Beschreibung

Definiert ein Bild, das einem Symbolstil oder Overlay zugeordnet ist. Das erforderliche untergeordnete Element <href> definiert die Position des Bildes, das als Overlay oder Symbol für die Ortsmarkierung verwendet werden soll. Dieser Speicherort kann sich entweder auf einem lokalen Dateisystem oder auf einem Remote-Webserver befinden. Die Elemente <gx:x>, <gx:y>, <gx:w> und <gx:h> werden verwendet, um ein Symbol aus einem Bild auszuwählen, das mehrere Symbole enthält (oft auch als Symbolpalette bezeichnet).

<Icon>
  <href>Sunset.jpg</href>   <!-- Here, the image contains only one icon -->
</Icon>

<Icon>
  <href>/home/mydir/myiconpalette.jpg</href>
  <gx:w>138</gx:w>
  <gx:h>138</gx:h>
    <!-- Since x and y values are omitted, these measurements are made starting at
    the lower-left corner of the icon palette image -->
</Icon>

Symbolspezifische Elemente

<href>: Eine HTTP-Adresse oder eine lokale Dateispezifikation, die zum Laden eines Symbols verwendet wird.
<gx:x>
<gx:y>: Wenn <href> eine Symbolpalette angibt, geben diese Elemente die Abstände in Pixel von der linken unteren Ecke der Symbolpalette an.Wenn keine Werte für x und y angegeben sind, wird von der linken unteren Ecke der Symbolpalette ausgegangen, dass sie verwendet wird.
<gx:w>
<gx:h>: Wenn <href> eine Symbolpalette angibt, geben diese Elemente die Breite (<gx:w>) und die Höhe (<gx:h>) des Symbols in Pixeln an.
<refreshMode>: Eine Beschreibung des <refreshMode> und der anderen unten aufgeführten Elemente finden Sie unter <Link>.
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

Enthalten durch

<Boden-Overlay>
<Bildschirm-Overlay>
<Symbolstil>

<IconStyle>

Syntax

<IconStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum:normal or random -->

  <!-- specific to IconStyle -->
  <scale>1</scale>                   <!-- float -->
  <heading>0</heading>               <!-- float -->
  <Icon>
    <href>...</href>
  </Icon>
  <hotSpot x="0.5"  y="0.5"
    xunits="fraction" yunits="fraction"/>    <!-- kml:vec2 -->
</IconStyle>

Beschreibung

Gibt an, wie Symbole für Punkt-Ortsmarkierungen sowohl im Bereich „Orte“ als auch im 3D-Viewer von Google Earth gezeichnet werden. Das <Icon>-Element gibt das Symbolbild an. Das <scale>-Element gibt die Skalierung des Symbols x, y an. Die im <color>-Element von <IconStyle> angegebene Farbe wird mit der Farbe von <Icon> kombiniert.

Für IconStyle spezifische Elemente

<scale>

Die Größe des Symbols wird geändert.

Hinweis:Das <geomScale>-Tag wurde eingestellt. Verwenden Sie stattdessen <scale>.

<heading>

Richtung (also Norden, Süden, Osten, Westen), in Grad. Standard=0 (Norden). (siehe Diagramm) Die Werte reichen von 0 bis 360 Grad.

<Icon>

Ein benutzerdefiniertes Symbol. In <IconStyle> ist das einzige untergeordnete Element von <Icon> <href>:

<href>: Eine HTTP-Adresse oder eine lokale Dateispezifikation, die zum Laden eines Symbols verwendet wird.

<hotSpot x="0,5" y="0,5" xunits="fraction" yunits="fraction">

Gibt die Position innerhalb des Symbols an, die an dem in der Ortsmarkierung angegebenen <Point> verankert ist. Die Werte x und y können auf drei verschiedene Arten angegeben werden: als Pixel ("pixels"), als Anteil des Symbols ("fraction") oder als Pixel-Offset ("insetPixels"), der einen Abstand in Pixeln von der oberen rechten Ecke des Symbols angibt. Die Positionen x und y können unterschiedlich angegeben werden, z. B. x in Pixel und y als Bruch. Der Ursprung des Koordinatensystems ist die linke untere Ecke des Symbols.

x – entweder die Anzahl der Pixel, eine Bruchkomponente des Symbols oder ein Pixeleinsatz, der die x-Komponente eines Punkts auf dem Symbol angibt
y – entweder die Anzahl der Pixel, eine Bruchkomponente des Symbols oder ein Pixeleinsatz, der die y-Komponente eines Punkts auf dem Symbol angibt
xunits: Einheiten, in denen der Wert x angegeben ist. Ein Wert von fraction gibt an, dass der x-Wert ein Bruchteil des Symbols ist. Ein pixels-Wert gibt den x-Wert in Pixeln an. Der Wert insetPixels gibt den Einzug vom rechten Rand des Symbols an.
yunits: Einheiten, in denen der Wert y angegeben ist. Ein Wert von fraction gibt an, dass der y-Wert ein Bruchteil des Symbols ist. Ein Wert von pixels gibt den y-Wert in Pixeln an. Der Wert insetPixels gibt den Einzug vom oberen Rand des Symbols an.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
   <Style id="randomColorIcon">
      <IconStyle>
         <color>ff00ff00</color>
         <colorMode>random</colorMode>
         <scale>1.1</scale>
         <Icon>
            <href>http://maps.google.com/mapfiles/kml/pal3/icon21.png</href>
         </Icon>
      </IconStyle>
   </Style>
   <Placemark>
      <name>IconStyle.kml</name>
      <styleUrl>#randomColorIcon</styleUrl>
      <Point>
         <coordinates>-122.36868,37.831145,0</coordinates>
      </Point>
   </Placemark>
</Document>
</kml>

Erweitert

<Farbstil>

Enthalten durch

<Stil>

Enthält

<href> als untergeordnetes Element von <Icon>

<kml>

Syntax

<kml xmlns="http://www.opengis.net/kml/2.2" hint="target=sky"> ... </kml>

Beschreibung

Das Stammelement einer KML-Datei. Dieses Element ist ein Pflichtelement. Sie folgt der XML-Deklaration am Anfang der Datei. Das Attribut Hint wird Google Earth als Signal dafür verwendet, die Datei als Himmelsdaten darzustellen.

Das <KML>-Element kann auch den Namespace für externe XML-Schemas enthalten, auf die in der Datei verwiesen wird.

Ein einfaches <KML>-Element enthält 0 oder 1 Feature und 0 oder 1 NetworkLinkControl:

<kml xmlns="http://www.opengis.net/kml/2.2">
  <NetworkLinkControl> ... </NetworkLinkControl>
  <!-- 0 or 1 Feature elements -->
</kml>

<LabelStyle>

Syntax

<LabelStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to LabelStyle -->
  <scale>1</scale>                   <!-- float -->
</LabelStyle>

Beschreibung

Gibt an, wie der <name>-Wert eines Elements im 3D-Viewer gezeichnet wird. Für das Label (Name) können eine benutzerdefinierte Farbe, ein Farbmodus und eine Skalierung angegeben werden.

Hinweis: Das <labelColor>-Tag wurde eingestellt. Verwenden Sie stattdessen <LabelStyle>.

Speziell für <LabelStyle>

<scale>: Die Größe des Labels wird geändert.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
   <Style id="randomLabelColor">
      <LabelStyle>
         <color>ff0000cc</color>
         <colorMode>random</colorMode>
         <scale>1.5</scale>
      </LabelStyle>
   </Style>
   <Placemark>
      <name>LabelStyle.kml</name>
      <styleUrl>#randomLabelColor</styleUrl>
      <Point>
         <coordinates>-122.367375,37.829192,0</coordinates>
      </Point>
   </Placemark>
</Document>
</kml>

Erweitert

<Farbstil>

Enthalten durch

<Stil>

<gx:LatLonQuad>

Dieses Element ist eine Erweiterung des OGC KML 2.2-Standards und wird ab Google Earth 5.0 unterstützt. Weitere Informationen

Syntax

<GroundOverlay id="ID">
  ...
  <Icon>...</Icon>
  <altitude>0</altitude>
  <altitudeMode>clampToGround</altitudeMode>                   <!-- or absolute -->
         <!-- can substitute <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode> -->

  <gx:LatLonQuad>
    <coordinates>...</coordinates>              <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

Beschreibung

Erlaubt nicht rechteckige viereckige Overlays.

Gibt die Koordinaten der vier Eckpunkte eines Vierecks an, das den Overlay-Bereich definiert. Es müssen genau vier Koordinaten-Tupel angegeben werden, die jeweils aus Gleitkommawerten für Längen- und Breitengrad bestehen. Fügen Sie ein Leerzeichen zwischen Tupeln ein. Geben Sie keine Leerzeichen in einem Tupel an. Die Koordinaten müssen gegen den Uhrzeigersinn angegeben werden. Die erste Koordinate muss dabei der linken unteren Ecke des Bilds entsprechen. Die in diesen Ecken beschriebene Form muss konvex sein.

Wenn ein dritter Wert in ein Tupel (höhere Höhe) eingefügt wird, wird er ignoriert. Die Höhe wird mit <altitude> und <altitudeMode> (oder <gx:altitudeMode>) festgelegt und erstreckt sich über <GroundOverlay>. Zulässige Höhenmodi sind absolute, clampToGround und clampToSeaFloor.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">
<GroundOverlay>
  <name>gx:LatLonQuad Example</name>
  <Icon>
    <href>http://developers.google.com/kml/documentation/images/rectangle.gif</href>
    <viewBoundScale>0.75</viewBoundScale>
  </Icon>
  <gx:LatLonQuad>
    <coordinates>
      81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015
    </coordinates>
  </gx:LatLonQuad>
</GroundOverlay>
</kml>

Erweitert

<Objekt>

Enthalten durch

<Boden-Overlay>

<LinearRing>

Syntax

<LinearRing id="ID">
  <!-- specific to LinearRing -->
  <gx:altitudeOffset>0</gx:altitudeOffset>   <!-- double -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
    <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
    <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>             <!-- lon,lat[,alt] tuples -->
</LinearRing>

Beschreibung

Definiert einen geschlossenen Linienstring, normalerweise die äußere Begrenzung eines Polygons. Optional kann ein LinearRing auch als innere Begrenzung eines Polygons verwendet werden, um Löcher in diesem Polygon zu erstellen. Ein Polygon kann mehrere <LinearRing>-Elemente enthalten, die als innere Grenzen verwendet werden.

Hinweis: In Google Earth folgt ein Polygon mit einem <ElevationMode>-Wert von clampToGround Linien mit konstanter Lage. Ein LinearRing allein hat dagegen einen <ElevationMode>-Wert von clampToGround, das großen Kreislinien folgt.

Für LinearRing spezifische Elemente

<gx:heightOffset>

Eine KML-Erweiterung im Namespace der Google-Erweiterung, die ändert, wie die Höhenwerte gerendert werden. Mit diesem Offset können Sie einen gesamten LinearRing als Einheit nach oben oder unten verschieben, ohne die einzelnen Koordinatenwerte des LinearRings ändern zu müssen. Der LinearRing wird zwar mit dem Höhen-Offset angezeigt, die ursprünglichen Höhenwerte bleiben aber in der KML-Datei erhalten. Einheiten werden in Metern angegeben.

<extrude>

Boolescher Wert. Gibt an, ob der LinearRing mit dem Boden verbunden werden soll. Für die Extrudierung dieser Geometrie muss der Höhenmodus entweder relativeToGround, relativeToSeaFloor oder absolute sein. Nur die Eckpunkte des LinearRing werden extrudiert, nicht der Mittelpunkt der Geometrie. Die Eckpunkte werden zur Mitte der Erdkugel extrudiert.

<tessellate>

Boolescher Wert. Gibt an, ob der LinearRing dem Gelände folgen darf. Um die Tesselierung zu aktivieren, muss der Wert für <ElevationMode> clampToGround oder clampToSeaFloor sein. Sehr große LinearRings sollten eine Tesselierung ermöglichen, damit sie der Krümmung der Erde folgen. Andernfalls könnten sie in den Untergrund gehen und versteckt sein.

<altitudeMode>

Gibt an, wie height-Komponenten im <koordinaten>-Element interpretiert werden. Mögliche Werte sind:

clampToGround (Standardeinstellung): Gibt an, dass eine Höhenangabe ignoriert wird (z. B. im Tag <koordinatens>).
relativeToGround: Legt die Höhe des Elements relativ zur tatsächlichen Bodenhöhe eines bestimmten Standorts fest. Wenn die Bodenhöhe eines Ortes beispielsweise genau auf Meereshöhe und die Höhe eines Punkts auf 9 Meter festgelegt ist, beträgt die Höhe für das Symbol einer Ortsmarkierung mit Punkt 9 Meter in diesem Modus. Wenn die Koordinate jedoch über einem Ort festgelegt wird, an dem die Bodenhöhe 10 Meter über dem Meeresspiegel liegt, beträgt die Höhe der Koordinate 19 Meter. Dieser Modus wird häufig zum Platzieren von Telefonstöcken oder einem Skilift verwendet.
absolut: Die Höhe der Koordinate relativ zum Meeresspiegel ist unabhängig von der tatsächlichen Höhe des Geländes unter dem Element. Wenn Sie beispielsweise die Höhe einer Koordinate in einem absoluten Modus auf 10 m festlegen, wird das Symbol einer Ortsmarkierung auf Bodenhöhe angezeigt, wenn das Gelände darunter auch 10 m über dem Meeresspiegel liegt. Wenn das Gelände 3 Meter über dem Meeresspiegel liegt, wird die Ortsmarkierung um 7 Meter über dem Gelände angezeigt. Dieser Modus wird typischerweise für die Platzierung von Flugzeugen verwendet.

<gx:heightMode>

Eine KML-Erweiterung im Namespace der Google-Erweiterung, die Höhen relativ zum Meeresboden zulässt. Mögliche Werte:

relativeToSeaFloor: Interpretiert die <height> als Wert in Metern über dem Meeresboden. Wenn der Punkt über Land und nicht über Meer liegt, wird <height> so interpretiert, dass er sich über dem Boden befindet.
clampToSeaFloor: Die Spezifikation <height> wird ignoriert und der Punkt wird auf dem Meeresboden positioniert. Wenn der Punkt an Land und nicht auf See ist, wird er auf dem Boden platziert.

<koordinatens>(erforderlich)

Vier oder mehr Tupel, die jeweils aus Gleitkommawerten für Längengrad, Breitengrad und Höhe bestehen. Die Komponente height ist optional. Geben Sie keine Leerzeichen in einem Tupel an. Die letzte Koordinate muss mit der ersten Koordinate übereinstimmen. Koordinaten werden nur in Dezimalgraden ausgedrückt.

<SimpleField type="String" name="String">: Die Deklaration des benutzerdefinierten Felds, die sowohl den Typ als auch den Namen dieses Felds angeben muss. Wenn type oder name weggelassen wird, wird das Feld ignoriert. Der Typ kann einer der folgenden sein:

String

int

Uint

short

Ushort

float

double

bool; <displayName>

Der Name, der verwendet wird, wenn der Feldname dem Google Earth-Nutzer angezeigt wird. Verwenden Sie das Element [CDATA], um ein standardmäßiges HTML-Markup zu maskieren.