Questa pagina è stata tradotta dall'API Cloud Translation.

Riferimento KML

Questa sezione contiene un riferimento alfabetico per tutti gli elementi KML definiti nella versione 2.2 di KML e per gli elementi nello spazio dei nomi delle estensioni Google. La struttura ad albero degli elementi KML è riportata di seguito. In questo diagramma, gli elementi a destra di un determinato ramo nella struttura ad albero sono estensioni degli elementi a sinistra. Ad esempio, il segnaposto è un tipo speciale di Funzionalità. Contiene tutti gli elementi che appartengono alla funzionalità e aggiunge alcuni elementi specifici dell'elemento segnaposto.

KML è uno standard aperto ufficialmente denominato OpenGIS® KML Encoding Standard (OGC KML). È gestito dall'Open Geospatial Consortium, Inc. (OGC). La specifica completa per il codice KML OGC è disponibile all'indirizzo http://www.opengeospatial.org/standards/placeholder/.

Lo schema XML completo per KML si trova all'indirizzo http://schemas.opengis.net/placeholder/.

Nota: fai clic sul nome di un elemento del diagramma per passare alla relativa voce nella sezione di riferimento.

Tieni presente che gli elementi astratti (mostrati nelle caselle nel diagramma) non vengono effettivamente utilizzati nei file KML. Sono un modo utile per considerare un singolo elemento come base programmatica per più elementi derivati (ma diversi) simili. Capire questa gerarchia orientata agli oggetti è un ottimo modo per imparare a utilizzare KML, perché permette di vedere facilmente i raggruppamenti di elementi correlati.

A tutti gli elementi derivati da Oggetto può essere assegnato un ID. Questo id viene utilizzato dal meccanismo di aggiornamento del file KML (vedi <Update>) per i file caricati con un link di rete. Viene utilizzato anche dagli stili condivisi (vedi <Style>). L'id è un ID XML standard.

Dal momento che KML è una grammatica e un formato di file XML, i nomi dei tag sono sensibili alle maiuscole e devono essere visualizzati esattamente come mostrato qui. Se hai familiarità con XML, ti potrebbe interessare anche lo schema KML 2.2. Quando modifichi i file di testo KML, puoi caricare questo schema in qualsiasi editor XML e convalidare il codice KML.

Suggerimento: visualizza le funzionalità KML per le funzionalità di Google Earth

Ecco una pratica funzionalità di Google Earth che consente di visualizzare facilmente il file KML per qualsiasi funzionalità. In Google Earth, puoi fare clic con il tasto destro del mouse su un elemento nel riquadro Luoghi e copiarlo. Per visualizzare il file KML corrispondente all'oggetto copiato, apri il tuo editor di testo preferito e incolla la selezione.

Compatibilità

Le versioni KML hanno un sistema di numerazione doppio: majorVersion.minorVersion. Tutte le versioni con lo stesso majorVersion sono compatibili. Per questo motivo, se modifichi lo spazio dei nomi in "2.2" (ovvero xmlns="http://www.opengis.net/kml/2.2"), tutti i file KML 2.1 vengono convalidati nello schema KML 2.2.

Informazioni su questo riferimento

Ogni voce di riferimento include una sezione Sintassi che elenca gli elementi contenuti nell'elemento principale. Questa sezione Sintassi è un elenco informale, utilizzato per riassumere in modo semplice gli elementi. Questa sezione contiene inoltre quanto segue:

Valori predefiniti per ciascun elemento (o puntini di sospensione se è un elemento complesso o se non è presente alcun valore predefinito)
Il tipo del valore (vedi Campi KML)

La sezione Sintassi può essere copiata e utilizzata come modello per qualsiasi elemento non astratto di un file KML.

Spazio dei nomi delle estensioni KML e prefisso gx

Lo standard KML OGC offre un meccanismo per le estensioni, ovvero elementi aggiuntivi che contengono informazioni oltre a quelle disponibili nello standard (scopri di più sugli spazi dei nomi XML all'indirizzo w3.org). In seguito al lancio di Google Earth 5.0, Google ha fornito delle estensioni per KML per supportare una serie di nuove funzionalità. Queste estensioni utilizzano il prefisso gx e il seguente URI dello spazio dei nomi:

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

Questo URI dello spazio dei nomi deve essere aggiunto all'elemento <kml> in qualsiasi file KML utilizzando gli elementi con prefisso gx-:

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

Le estensioni per KML potrebbero non essere supportate in tutti i browser geografici. Se il tuo browser non supporta determinate estensioni, i dati in queste estensioni devono essere ignorati e il resto del file KML deve essere caricato senza errori.

Gli elementi che attualmente utilizzano il prefisso gx sono:

gx:modeMode
gx:Offset altitudine
gx:angoli
gx:aggiornamento animato
gx:Visibilità dei fumetti
gx:coord
gx:in ritardo
gx:drawOrder
gx:duration
GX:FlyTo
gx:modalitàToscana
GX:H
gx:horizFov
gx:interpolazione
gx:labelVisibilità
gx:LatLonQuad
gx:MultiTrack
gx:vieweroptions
gx:colore outer
gx:larghezza esterna
gx:Larghezzafisica
gx:playlist
gx:riproduzione
gx:SoundCue
gx:TimeSpan
gx:TimeStamp
gx:Tour
gx:TourControl
gx:TourPrimitive
gx:Traccia
gx:ViewerOptions
GX:W
gx:Attendi
GX:X
gx:y

Lo schema XML completo per gli elementi in questo spazio dei nomi delle estensioni si trova all'indirizzo http://developers.google.com/placeholder/kb/22gx.xsd.

Campi KML

KML utilizza tipi comuni di XML, come booleano, stringa, doppio,numero in virgola mobile e int. Inoltre, definisce una serie di tipi di elementi di campi. Nella tabella di seguito vengono elencati alcuni dei tipi di uso più comune definiti in KML e alcuni link a elementi di esempio che li utilizzano:

Tipo di campo	Valore	Esempio di utilizzo
HEIGHTModeEnum	clampToGround, relativeToGround, assoluto	Vedi <LookAt> e <Region>
angolo 90	un valore ≥-90 e ≤90	Visualizza < latitudine> in <Modello>
angolopos90	un valore ≥0 e ≤90	Visualizza <tilt> in <LookAt>
angolo 180	un valore ≥-180 e ≤ 180	Visualizza <longitudine> in <Modello>
angolo 360	un valore ≥-360 e ≤ 360	Vedi <intestazione> in <Orientamento>
colore	Valore esadecimale: aabbggrr	Visualizza gli elementi che estendono <ColorStyle>
colorModeEnum	normale, casuale	Visualizza gli elementi che estendono <ColorStyle>
data/ora	dateTime, date, gYearMonth, gYear	Vedi <TimeSpan> e <TimeStamp>
displayModeEnum.	predefinito, nascondi	Vedi <BalloonStyle>
gridOrigin.	in basso a sinistra, in alto a sinistra	Vedi <FotoOverlay>
updateModeEnum	onChange, onInterval, onExpire	Consulta <Link>
formaEnumerazione	rettangolare, cilindro, sfera	Vedi <FotoOverlay>
styleStateEnum	normale, evidenziare	Consulta <StyleMap>
unitsEnum	frazione, pixel, insetPixel	Visualizza <hotSpot> in <IconStyle>, <ScreenOverlay>
vec2	x=doppia xunits=placeholder:units	Visualizza <hotSpot> in <IconStyle>, <ScreenOverlay>
viewRefreshEnum	mai, onRequest, onStop, onRegion	Consulta <Link>

<AbstractView>

Sintassi

<!-- 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 -->

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Questo elemento è esteso dagli elementi < Camera> e <LookAt>.

Estende

<Oggetto>

Elementi specifici di AbstractView

<gx:ViewerOptions>: Questo elemento attiva modalità di visualizzazione speciali in Google Earth 6.0 e versioni successive. Ha uno o più elementi secondari <gx:option>. L'elemento <gx:option> ha un attributo name e un attributo enabled. name specifica uno dei seguenti valori: immagini di Street View ("Street View"), immagini storiche ("immagini storiche") ed effetti della luce solare per una determinata ora del giorno ("luce"). L'attributo enabled viene utilizzato per attivare o disattivare una determinata modalità di visualizzazione.
<gx:horizFov>: Definisce il campo visivo orizzontale dell'AbstractView durante un tour. Questo elemento non ha effetto su AbstractView al di fuori di un tour. <gx:horizFov> viene inserito automaticamente dal client di Google Earth (versioni 6.1 e successive) durante la registrazione del tour. Agli elementi AbstractView standard viene assegnato un valore 60; per le viste all'interno di Street View viene assegnato un valore pari a 85 per corrispondere al campo visivo standard di Street View in Google Earth. Una volta impostato, il valore verrà applicato alle viste successive fino a quando non verrà specificato un nuovo valore.

<gx:altitudineMode>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

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

Descrizione

Può essere utilizzato al posto dell'elemento <altitudeMode> standard OGC KML e accetta i seguenti valori oltre ai valori HEIGHTMode standard:

relativeToSeaFloor: interpreta l'altitudine come valore in metri sul livello del mare. Se la funzionalità KML è situata sopra la terraferma anziché sul mare, l'altitudine sarà interpretata come fuori terra.
clampToSeaFloor: la specifica dell'altitudine viene ignorata e la funzionalità KML verrà posizionata sul fondale marino. Se la funzionalità KML è sulla terraferma anziché in mare, clampToSeaFloor si applicherà invece a terra.

Come per <altitudeMode>, <gx:altitudeMode> incide su:

coordinata dell'altitudine all'interno dell'elemento <coordinates>
<minAltitude> e <maxAltitude> in <LatLonAltBox>
<altitude> in <Location>, <GroundOverlay> e AbstractView (<LookAt> e <Camera>).

Ulteriori informazioni sulle modalità altitudine sono disponibili nel capitolo Modalità altitudine della Guida per gli sviluppatori KML.

Esempio

modemode_reference.placeholder

<?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:Animazione

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

<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>

Descrizione

<gx:AnimatedUpdate> controlla le modifiche apportate nel tour alle funzionalità KML utilizzando <Update>. Le modifiche alle funzionalità KML non modificheranno il DOM, ovvero eventuali modifiche verranno annullate al termine del tour e non verranno salvate nel KML in qualsiasi momento.

<gx:AnimatedUpdate> deve contenere anche un valore <gx:duration> per specificare il periodo di tempo in secondi durante il quale viene eseguito l'aggiornamento. I campi numero intero, numero in virgola mobile e colore vengono animati senza interruzioni dall'originale al nuovo valore per tutta la durata; i valori booleani, delle stringhe e altri valori che non prestano interpolazione vengono aggiornati alla fine della durata.

Per informazioni su <gx:AnimatedUpdate> e sulla sequenza temporale del tour, consulta le Cronologia dei tour nel capitolo Tour della guida per gli sviluppatori KML.

<gx:duration>: Specifica per quanto tempo, in secondi, viene eseguito l'aggiornamento.
<gx:delayedStart>: Specifica il numero di secondi da attendere (dopo la posizione iniziale inclusa) prima di iniziare l'aggiornamento.

Esempio

L'esempio che segue mostra una variazione nelle dimensioni delle icone. Questa modifica verrà animata per un periodo di 5 secondi.

animatedupdate_example.placeholder

<?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>

Estende

<gx:TourPrimitive>.

Contiene

<gx:duration>
<Aggiorna>

<Stile fumetto>

Sintassi

<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>

Descrizione

Specifica come viene disegnato il fumetto descrittivo per i segnaposto. <bgColor>, se specificato, viene utilizzato come colore di sfondo del fumetto. Per un diagramma che mostra come viene visualizzato il fumetto predefinito della descrizione in Google Earth, consulta <Funzionalità>.

Elementi specifici per BalloonStyle

<bgColor>: (Facoltativo) Colore di sfondo del fumetto. I valori di colore e opacità (alpha) sono espressi in notazione esadecimale. L'intervallo di valori di un qualsiasi colore è compreso tra 0 e 255 (da 00 a ff). L'ordine delle espressioni è aabbggrr, dove aa=alpha (da 00 a ff); bb=blue (da 00 a ff); gg=green (da 00 a ff); rr=red (da 00 a ff). Per la versione alpha, 00 è completamente trasparente e ff è completamente opaco. Ad esempio, se vuoi applicare un colore blu a un overlay con il 50% di opacità, devi specificare: <bgColor>7fff0000</bgColor>, dove alpha=0x7f, blu=0xff, verde=0x00 e rosso=0x00. L'impostazione predefinita è bianco opaco (senza corrispondenza).
<textColor>: Colore in primo piano del testo. Il valore predefinito è nero (ff000000).
<testo>: Testo visualizzato nel fumetto. Se non viene specificato alcun testo, Google Earth disegna il fumetto predefinito (con la funzionalità <name> in grassetto, la funzionalità <description>, i link per le indicazioni stradali, uno sfondo bianco e una coda collegata alle coordinate del punto della funzionalità, se specificate).; Puoi aggiungere entità al tag <text> utilizzando il seguente formato per fare riferimento a un elemento secondario della funzionalità: $[name], $[description], $[address], $[id], $[Snippet]. Nell'attuale funzionalità, Google Earth cerca l'entità stringa corrispondente e sostituisce le informazioni presenti nel fumetto. Per includere A qui - da qui indicazioni stradali nel fumetto, utilizza il tag $[geDirections]. Per evitare che i link delle indicazioni stradali vengano visualizzati in un fumetto, includi l'elemento <text> con alcuni contenuti oppure con $[description] per sostituire l'elemento di base <description>.; Ad esempio, nel seguente estratto di KML, i campi $[name] e $[description] verranno sostituiti dai campi <name> e <description> che si trovano negli elementi Feature che utilizzano questo BalloonStyle:
<displayMode>: Se <displayMode> è default, Google Earth utilizza le informazioni fornite in <text> per creare un fumetto . Se <displayMode> è hide, Google Earth non mostrerà il fumetto. In Google Earth, se fai clic sull'icona Visualizzazione elenco per un segnaposto il cui <displayMode> viene nascosto, Google Earth vola fino al segnaposto.

Esempio

<?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>

Estende

<ColoreStile>

Contenuto da

<Stile>

Torna all'inizio

<gx:fumettoVisibilità>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

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

Descrizione

Attiva/disattiva la visibilità di un fumetto descrittivo. Il fumetto da aggiornare deve essere identificato dall'ID XML dell'oggetto (ad esempio <Placemark targetId="xxx">).

Esempi

Il primo esempio mostra <gx:balloonVisibility> con un segnaposto. Una volta caricato il segnaposto, viene visualizzato il fumetto della descrizione.
blobvisibilità_example.placeholder

<?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>

Il secondo esempio mostra l'utilizzo di <gx:balloonVisibility> in un tour. Durante il tour vengono aperti e chiusi diversi fumetti che forniscono informazioni allo spettatore.
mon°visibilità_tourexample.placeholder

<?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>

Estende

<Funzionalità>

<Fotocamera>

Sintassi

<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>

Descrizione

Definisce la videocamera virtuale che guarda la scena. Questo elemento definisce la posizione della videocamera rispetto alla superficie terrestre e la direzione visiva della videocamera. La fotocamera posizione è definita da <longitudine>, < latitudine>, <altitudine>, e <HEIGHTMode> o <gx:altitudineMode>. La direzione di visualizzazione della fotocamera è definita da <È> < Ogni elemento<bpt>

L'opzione <Videocamera> offre un controllo completo della libertà di sei gradi sulla visualizzazione, così puoi posizionare la videocamera nello spazio e ruotarla attorno agli assi X, Y e Z. Cosa ancora più importante, puoi inclinare la visualizzazione della videocamera in modo da osservare l'orizzonte del cielo.

<Videocamera> può anche contenere un valore TimePrimitive (<gx:TimeSpan> o <gx:TimeStamp>). I valori dell'ora in Fotocamera influiscono su immagini storiche, luce solare e visualizzazione degli elementi con timestamp. Per ulteriori informazioni, consulta la sezione Time with AbstractViews nel report Time and Animation della Guida per gli sviluppatori.

Definizione di una vista

In una caratteristica o in <NetworkLinkControl>, utilizza un oggetto <Videocamera> o <LookAt> (ma non entrambi nello stesso oggetto). L'oggetto <Videocamera> definisce il punto di vista in termini di posizione e orientamento dello spettatore. L'oggetto <Videocamera> consente di specificare una vista che non si trova sulla superficie della Terra. L'oggetto <LookAt> definisce il punto di vista in termini di ciò che viene visualizzato. L'oggetto <LookAt> ha un ambito più limitato rispetto a <Videocamera> e generalmente richiede che la direzione di visualizzazione intersechi la superficie terrestre.

Il seguente diagramma mostra gli assi X, Y e Z, che sono collegati alla videocamera virtuale.

L'asse X punta a destra della videocamera ed è chiamato vettore destro.
L'asse Y definisce la direzione "su" rispetto allo schermo e viene chiamato vettore verso l'alto.
L'asse Z punta dal centro dello schermo verso il punto d'occhio. La fotocamera guarda verso il basso sull'asse -Z, denominato vettore di visualizzazione.

Ordine delle trasformazioni

L'ordine di rotazione è importante. Per impostazione predefinita, la videocamera guarda verso il basso sull'asse -Z verso la Terra. Prima che vengano eseguite le rotazioni, la fotocamera viene tradotta lungo l'asse Z in <altitudine>. L'ordine delle trasformazioni è il seguente:

<altitude>: traduci lungo l'asse Z verso <altitudine>
<heading>: ruota attorno all'asse Z.
<tilt>: ruota attorno all'asse X.
<roll>: ruota di nuovo intorno all'asse Z.

Ogni volta che viene applicata una rotazione, due assi della videocamera ne modificano l'orientamento.

Elementi specifici della videocamera

<longitudine>

Longitudine della fotocamera virtuale (punto di vista). Distanza angolare in gradi, rispetto al meridiano di Prime. Valori a ovest dell'intervallo meridiano da -180 a 0 gradi. Valori a est dell'intervallo Meridiano da 0 a 180 gradi.

<latitudine>

Latitudine della videocamera virtuale. Gradi a nord o a sud dell'equatore (0 gradi). I valori sono compresi tra -90 e 90 gradi.

<altitudine>

Distanza della fotocamera dalla superficie terrestre, in metri. Interpretato in base alla fotocamera <HEIGHTMode> o <gx:HEIGHTMode>.

<intestazione>

Direzione (azimut) della fotocamera, in gradi. Valore predefinito=0 (vero nord). (vedi diagramma). I valori sono compresi tra 0 e 360 gradi.

<tilt>

Rotazione, in gradi, della fotocamera attorno all'asse X. Un valore pari a 0 indica che la vista è puntata verso il basso verso la Terra (il caso più comune). Un valore pari a 90 per <tilt> indica che la visualizzazione è rivolta all'orizzonte. I valori maggiori di 90 indicano che la vista è rivolta verso il cielo. I valori di <tilt> sono bloccati a +180 gradi.

<roll>

Rotazione, in gradi, della fotocamera intorno all'asse Z. I valori vanno da -180 a +180 gradi.

<altitudeMode>

Specifica come viene interpretata l'<altitudine> specificata per la videocamera. I valori possibili sono i seguenti:

relativeToGround - (valore predefinito) Interpreta l'<altitudine> come valore in metri dal suolo. Se il punto è sull'acqua, <altitudine> verrà interpretato come un valore in metri sul livello del mare. Consulta <gx:HEIGHTMode> di seguito per specificare i punti relativi al fondale marino.
clampToGround : per una videocamera, questa impostazione imposta anche il valore relativeToGround della videocamera, perché posizionare la videocamera esattamente all'altezza del terreno significa che l'occhio intersecherebbe il terreno (e la vista sarebbe bloccata).
assoluto: interpreta <altitudine> come un valore in metri sul livello del mare.

<gx:altitudineMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova su un terreno anziché sul mare, questo valore verrà interpretato come fuori terra.
clampToSeaFloor: la specifica <altitudine> viene ignorata e la fotocamera verrà posizionata sul fondale marino. Se il punto di accesso è a terra anziché al mare, la videocamera viene posizionata a terra.

Estende

<AbstractView>

Contenuto da

Qualsiasi elemento derivato da <Funzionalità>
<NetworkLinkControl>

Torna all'inizio

<ColorStyle>

Sintassi

<!-- 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 -->

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Fornisce elementi per specificare il colore e la modalità colore dei tipi di stile estesi.

Elementi specifici per ColorStyle

<colore>: I valori di colore e opacità (alpha) sono espressi in notazione esadecimale. L'intervallo di valori per ogni colore è compreso tra 0 e 255 (da 00 a ff). Per la versione alpha, 00 è completamente trasparente e ff è completamente opaco. L'ordine dell'espressione è aabbggrr, dove aa=alpha (da 00 a ff); bb=blue (da 00 a ff); gg=green (da 00 a ff); rr=red (da 00 a ff). Ad esempio, se vuoi applicare un colore blu a un overlay con il 50% di opacità, devi specificare: <color>7fff0000</color>, dove alpha=0x7f, blu=0xff, verde=0x00 e rosso=0x00.
<colorMode>: I valori per <colorMode> sono normali (nessun effetto) e casual. Un valore di casuale applica una scala lineare casuale alla base <color> come segue.

Per ottenere una selezione di colori davvero casuale, specifica una base <color> di bianco (senza corrispondenza).
Se specifichi un singolo componente di colore (ad esempio il valore ff0000ff per rosso), verranno selezionati i valori di colore casuale per quel componente (rosso). In questo caso, i valori sarebbero compresi tra 00 (nero) e ff (rosso completo).
Se specifichi valori per due o per tutti e tre i componenti di colore, a ogni componente di colore verrà applicata una scala lineare casuale con risultati che vanno dal nero ai valori massimi specificati per ogni componente.
L'opacità di un colore proviene dal componente alpha di <color> e non viene mai randomizzata.

Estende

<Oggetto>

Estensione eseguita da

<IconaStile>
<LabelStyle>
<LineStyle>
<PolyStyle>

Torna all'inizio

<Contenitore>

Sintassi

<!-- 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 -->

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Un elemento Container include una o più funzionalità e consente la creazione di gerarchie nidificate.

Estende

<Funzionalità>

Estensione eseguita da

<Documento>
<Cartella>

Torna all'inizio

<Documento>

Sintassi

<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>

Descrizione

Un documento è un contenitore per funzionalità e stili. Questo elemento è obbligatorio se il file KML utilizza gli stili condivisi. Ti consigliamo di utilizzare gli stili condivisi, che richiedono i seguenti passaggi:

Definire tutti gli stili in un documento. Assegna un ID univoco a ogni stile.

All'interno di un determinato elemento o stile, fai riferimento all'ID dello stile utilizzando l'elemento <styleUrl>.

Tieni presente che gli stili condivisi non vengono ereditati dalle funzionalità nel documento.

Ciascun elemento deve fare riferimento esplicito agli stili utilizzati in un elemento <styleUrl>. Per uno stile che si applica a un documento (come ListStyle), il documento stesso deve fare riferimento esplicitamente a <styleUrl>. Ad esempio:

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

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

Non inserire gli stili condivisi in una cartella.

L'esempio seguente illustra l'utilizzo di uno stile condiviso.

Esempio

<?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>

Estende

<Contenitore>

Contiene

0 o più elementi derivati da <Funzionalità>
0 o più elementi derivati da <StyleSelector>
0 o più elementi derivati da <Schema>

Torna all'inizio

<gx:duration>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

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

Descrizione

<gx:duration> estende gx:TourPrimitive specificando un intervallo di tempo per gli eventi. L'ora viene scritta in secondi utilizzando il tipo di dati double di XML.

Durata e <gx:FlyTo>

Quando viene inclusa una durata in un elemento <gx:FlyTo>, viene specificato il tempo necessario al browser per passare dal punto precedente al punto specificato.

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

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

Durata e <gx:AnimatedUpdate>

Specifica per quanto tempo deve essere eseguito l'aggiornamento. I campi numero intero, numero in virgola mobile e colore vengono animati senza interruzioni dall'originale al nuovo valore per tutta la durata; i valori booleani, delle stringhe e altri valori che non prestano interpolazione vengono aggiornati alla fine della durata.

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

    ....

  </Update>
</gx:AnimatedUpdate>

<ExtendedData>

Sintassi

<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>

Descrizione

L'elemento ExtendedData offre tre tecniche per aggiungere dati personalizzati a una funzionalità KML (NetworkLink, segnaposto, Ground Overlay, PhotoOverlay, ScreenOverlay, Document, Folder). Queste tecniche sono

Aggiungere coppie di dati/valore non digitate utilizzando l'elemento <Data> (di base)
Dichiarazione di nuovi campi digitati utilizzando l'elemento <Schema> e successiva implementazione tramite l'elemento <SchemaData> (avanzato)
Fare riferimento agli elementi XML definiti in altri spazi dei nomi facendo riferimento allo spazio dei nomi esterno all'interno del file KML (base)

Queste tecniche possono essere combinate all'interno di un singolo file KML o di una singola funzionalità per dati di dati diversi.

Per saperne di più, consulta la sezione Aggiunta di dati personalizzati in "Argomenti in KML".

Elementi specifici di ExtendedData

<Nome dati ="stringa">

Crea una coppia nome/valore non digitata. Il nome può avere due versioni: nome e displayName. L'attributo name viene utilizzato per identificare la coppia di dati all'interno del file KML. L'elemento displayName viene utilizzato quando in Google Earth viene visualizzato un nome correttamente formattato con spazi e formattazione HTML. Nell'elemento <text> di <BalloonStyle>, la notazione $[name/displayName] viene sostituita con <displayName>. Se sostituisci il valore dell'attributo name dell'elemento <Data> in questo formato (ad esempio, $[holeYardage], il valore dell'attributo viene sostituito con <value>. Per impostazione predefinita, il fumetto del segnaposto mostra il nome e il valore associato.

<nomedisplay>

Una versione facoltativa del nome name, da utilizzare per la visualizzazione.

<valore>

Valore della coppia di dati.

<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="qualsiasiURI">

Questo elemento viene utilizzato in combinazione con <Schema> per aggiungere dati personalizzati digitati a una funzionalità KML. L'elemento di schema (identificato dall'attributo schemaUrl) dichiara il tipo di dati personalizzato. Gli oggetti dati effettivi ("istanze" dei dati personalizzati) sono definiti mediante l'elemento SchemaData.

<schemaURL> può essere un URL completo, un riferimento a un ID schema definito in un file KML esterno o un riferimento a un ID schema definito nello stesso file KML. Tutte le seguenti specifiche sono accettabili:

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

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

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

L'elemento Schema è sempre un elemento figlio del documento. L'elemento ExtendedData è un elemento secondario della funzionalità che contiene i dati personalizzati.

<SimpleData name="string">: Questo elemento assegna un valore al campo di dati personalizzato identificato dall'attributo name. Il tipo e il nome di questo campo dati personalizzato vengono dichiarati nell'elemento <Schema>.; Ecco un esempio di definizione di due elementi di dati personalizzati:

<prefisso_nome:altro>: Questo elemento ti consente di aggiungere dati personalizzati non digitati. Assicurati di fare riferimento al prefisso dello spazio dei nomi nell'elemento <kb> del tuo file o come attributo dell'elemento <ExtendedData> e di anteporre il nome di ogni elemento di dati al prefisso dello spazio dei nomi. I dati personalizzati aggiunti in questo modo vengono conservati nel file KML, ma non vengono utilizzati in alcun modo da Google Earth. Viene sempre salvata insieme al file.; L'esempio seguente mostra l'utilizzo del prefisso dello spazio dei nomi "camp":

Contenuto da

Qualsiasi elemento derivato da <Funzionalità>

Vedi anche

Schema

<Funzionalità>

Sintassi

<!-- 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 -->

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Il seguente diagramma mostra in che modo alcuni elementi di una funzionalità vengono visualizzati in Google Earth.

Elementi specifici per la funzionalità

<nome>

Testo definito dall'utente visualizzato nel visualizzatore 3D come etichetta dell'oggetto, ad esempio per segnaposto, cartella o link di rete.

<visibilità>

Valore booleano. Specifica se la funzionalità è tracciata nel visualizzatore 3D quando è caricata inizialmente. Affinché una funzionalità sia visibile, è necessario che il tag <visibilità> di tutti i suoi predecessori sia impostato su 1. Ogni visualizzazione dell'elenco di Google Earth contiene una casella di controllo che consente all'utente di controllarne la visibilità.

<apri>

Valore booleano. Specifica se un documento o una cartella sembrano chiusi o aperti la prima volta che vengono caricati nel riquadro Luoghi. 0=compresso (impostazione predefinita), 1=espanso. Vedi anche <ListStyle>. Questo elemento si applica solo a Documento, Cartella e NetworkLink.

<atom:author>

KML 2.2 supporta nuovi elementi per l'inserimento nel file KML dei dati relativi all'autore e al sito web correlato. Queste informazioni vengono mostrate nei risultati di ricerca geografica, sia nei browser Earth come Google Earth sia in altre applicazioni come Google Maps. Gli elementi di scrittura utilizzati in KML sono i seguenti:

atom:author elemento - elemento principale per atom:name
atom:name: il nome dell'autore.
L'elemento atom:link contiene l'attributo href
Attributo href: URL della pagina web contenente il file KML/KMZ

Questi elementi sono definiti nel formato di syndication Atom. Le specifiche complete sono disponibili all'indirizzo http://atompub.org. (vedi l'esempio che segue).

L'elemento <atom:author> è l'elemento principale per <atom:name>, che specifica l'autore della funzionalità KML.

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

Specifica l'URL del sito web contenente questo file KML o YAML. Assicurati di includere lo spazio dei nomi per questo elemento in qualsiasi file KML che lo utilizza: xmlns:atom="http://www.w3.org/2005/Atom" (vedi l'esempio che segue).

<address>

Un valore stringa che rappresenta un indirizzo non strutturato scritto come una via standard, una città, una provincia o un codice postale. Puoi utilizzare il tag <address> per specificare la posizione di un punto anziché utilizzare le coordinate di latitudine e longitudine. Tuttavia, se viene fornito un <punto>, questo ha la precedenza sull'<indirizzo>. Per scoprire quali impostazioni internazionali sono supportate per questo tag in Google Earth, consulta la Guida di Google Maps.

<xal:AddressDetails>

Un indirizzo strutturato, formattato come xAL, o eXtensible Address Language, uno standard internazionale per la formattazione di indirizzi. <xal:AddressDetails> viene utilizzato dal file KML per la geocodifica solo in Google Maps. Per maggiori dettagli, consulta la documentazione relativa all'API di Google Maps. Attualmente, Google Earth non utilizza questo elemento; usa <indirizzo>. Assicurati di includere lo spazio dei nomi per questo elemento in qualsiasi file KML che lo utilizza: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<numeroditelefono>

Un valore stringa che rappresenta un numero di telefono. Questo elemento è utilizzato solo da Google Maps Mobile. Lo standard di settore per i telefoni cellulari abilitati per Java è RFC2806.
Per saperne di più, consulta http://www.ietf.org/rfc /rfc2806.txt.

<Snippet maxLines="2" >

Una breve descrizione della funzionalità. In Google Earth, la descrizione viene visualizzata nel riquadro Luoghi sotto il nome dell'elemento. Se non viene fornito uno snippet, vengono utilizzate le prime due righe di <description>. In Google Earth, se un segnaposto contiene sia una descrizione che uno snippet, lo <Snippet> viene visualizzato sotto il segnaposto nel riquadro Luoghi, mentre <description> viene visualizzato nel fumetto della descrizione del segnaposto. Questo tag non supporta il markup HTML. <Snippet> ha un attributo maxLines, un numero intero che specifica il numero massimo di righe da visualizzare.

<description>

Contenuti forniti dagli utenti che vengono visualizzati nel fumetto della descrizione.

I contenuti supportati per l'elemento <description> sono cambiati da Google Earth 4.3 a 5.0. Di seguito sono riportate informazioni specifiche per ciascuna versione, seguite da informazioni comuni a entrambe le versioni.

Google Earth 5.0

Google Earth 5.0 (e versioni successive) supporta contenuti di testo normale, HTML e JavaScript completi, nei fumetti di descrizione. I contenuti del tag della descrizione vengono visualizzati dal motore del browser web open source WebKit e vengono visualizzati come qualsiasi altro browser basato su WebKit.

Restrizioni generali

I link ai file locali non sono generalmente consentiti. In questo modo si impedisce che il codice dannoso danneggi il sistema o acceda ai tuoi dati. Se vuoi consentire l'accesso al tuo file system locale, seleziona Preferenze > Consenti l'accesso ai file locali e ai dati personali. I link ai file immagine nel file system locale sono sempre consentiti, se contenuti in un tag <img>.

È possibile accedere ai contenuti compressi in un file YAML, anche se nel file system locale.

I cookie sono abilitati, ma ai fini delle stesse norme sull'origine, i contenuti locali non condividono un dominio con altri contenuti (inclusi altri contenuti locali).

HTML

Il rendering dell'HTML avviene principalmente come per qualsiasi browser WebKit.

Le destinazioni vengono ignorate se incluse in codice HTML scritto direttamente nel file KML; tutti questi link vengono aperti come se il target fosse impostato su _blank. I target specificati vengono ignorati.

Per impostazione predefinita, HTML incluso in un iframe o generato dinamicamente con JavaScript o DHTML utilizzerà target="_self". È possibile specificare altri target e sono supportati.

Non è possibile scegliere come target i contenuti di file YAML, link di ancoraggio locali e metodi ;flyto da codice HTML contenuto in un iframe.

Se l'utente specifica width="100%" per la larghezza di un iframe, quest'ultimo dipenderà da tutti gli altri contenuti del fumetto, pertanto deve essere ignorato durante il calcolo delle dimensioni del layout. Questa regola si applica anche a qualsiasi altro elemento di blocco all'interno del fumetto.

JavaScript

È supportata la maggior parte di JavaScript. Impossibile creare finestre di dialogo: funzioni come Alert() e prompt() non verranno visualizzate. Tuttavia, verranno scritti nella console di sistema, insieme ad altri errori ed eccezioni.

CSS

Il CSS è consentito. Come con il CSS in un normale browser web, il CSS può essere utilizzato per modificare il testo, gli elementi delle pagine e per controllare le dimensioni e l'aspetto del fumetto descrittivo.

Google Earth 4.3

L'elemento <description> supporta testo normale e un sottoinsieme di elementi di formattazione HTML, incluse le tabelle (vedi l'esempio di file KML di seguito). Non supporta altre tecnologie basate sul Web, come il markup delle pagine dinamiche (PHP, JSP, ASP), i linguaggi di scripting (VBScript, JavaScript) o i linguaggi delle applicazioni (Java, Python). Nella versione 4.2 di Google Earth, i video sono supportati. Vedi la sezione Esempio di seguito.

Informazioni comuni

Se la descrizione non contiene markup HTML, Google Earth tenta di formattarla, sostituendo i caratteri di nuova riga con <br> e inserendo gli URL dei tag ancorati. Una stringa URL valida per il World Wide Web viene convertita automaticamente in un link ipertestuale a tale URL (ad es. http://www.google.com). Di conseguenza, non è necessario racchiudere un URL con i tag <a href="http://.."></a> per ottenere un link semplice.

Quando utilizzi l'HTML per creare un link ipertestuale attorno a una parola specifica o quando includi immagini nel codice HTML, devi utilizzare riferimenti all'entità HTML o l'elemento CDATA per uscire da parentesi angolari, apostrofi e altri caratteri speciali. L'elemento CDATA indica all'analizzatore sintattico XML di ignorare i caratteri speciali utilizzati tra parentesi. Questo elemento ha la seguente forma:

<![CDATA[
  special characters here
]]>

Se preferisci non utilizzare l'elemento CDATA, puoi utilizzare i riferimenti a entità per sostituire tutti i caratteri speciali.

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

Altro comportamento specificato tramite l'uso dell'<a>elemento

KML supporta l'utilizzo di due attributi all'interno dell'elemento <a>: href e type.

L'elemento di ancoraggio <a> contiene un attributo href che specifica un URL.

Se href è un file KML e ha un'estensione del file .ZIP o .pdfs, Google Earth carica il file direttamente quando l'utente vi fa clic sopra. Se l'URL termina con un'estensione non nota a Google Earth (ad esempio, .html), l'URL viene inviato al browser.

L'href può essere un URL con frammenti (vale a dire un URL con il simbolo # seguito da un identificatore KML). Quando l'utente fa clic su un link che include un URL con frammenti, per impostazione predefinita il browser raggiunge la funzionalità il cui ID corrisponde al frammento. Se l'elemento ha un elemento LookAt o Camera, la funzionalità viene visualizzata dal punto di vista specificato.

Il comportamento può essere ulteriormente specificato aggiungendo una delle tre stringhe seguenti all'URL del frammento:

;flyto (predefinito) - vai alla funzionalità
;chrome: apre il fumetto dell'elemento, ma non vola in aereo
;chromeFlyto: apri il palloncino dell'elemento e vai all'elemento

Ad esempio, il seguente codice indica di aprire il file CraftsFairs.kb, di volare verso il Segnaposto con ID "Albuquerque" e di aprire il relativo fumetto:

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

L'attributo type viene utilizzato all'interno dell'elemento <a> quando href non termina con .kb o .pdfs, ma il riferimento deve essere interpretato nel contesto del file KML. Specifica quanto segue:

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

Ad esempio, il seguente URL utilizza l'attributo type per informare Google Earth che dovrebbe cercare di caricare il file anche se l'estensione è .php:

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

<AbstractView>

Definisce un punto di vista associato a qualsiasi elemento derivato dalla funzionalità. Vedi <Videocamera> e <LookAt>.

<TimePrimitive>

Associa questa funzionalità a un periodo di tempo (<TimeSpan>) o a un momento (<TimeStamp>).

<styleUrl>

URL di un elemento <Style> o <StyleMap> definiti in un documento. Se lo stile è nello stesso file, utilizza un riferimento #. Se lo stile è definito in un file esterno, utilizza un URL completo insieme a # riferimento. Esempi:

<styleUrl>#myIconStyleID</styleUrl>

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

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

<StyleSelector>

Puoi definire uno o più stili e stili per personalizzare l'aspetto di qualsiasi elemento derivato dalla funzionalità o dalla geometria di un segnaposto. (Vedi <BalloonStyle>, <ListStyle>, <StyleSelector>, e gli stili derivati da <ColorStyle>.) Uno stile definito all'interno di un elemento è chiamato "stile in linea" e si applica solo all'elemento che la contiene. Uno stile definito come elemento secondario di un <documento> è chiamato "stile condiviso". Per uno stile condiviso deve essere definito un id. Questo ID fa riferimento a una o più funzionalità all'interno del <documento>. Nei casi in cui un elemento di stile viene definito sia in uno stile condiviso che in uno stile incorporato per una funzionalità, ovvero una cartella, una sovrapposizione al suolo, un link di rete, un segnaposto o un overlay schermo, il valore dello stile incorporato dell'elemento ha la precedenza sul valore dello stile condiviso.

<Regione>

Gli elementi e la geometria associati a una regione vengono tracciati solo quando quest'ultima è attiva. Consulta la sezione <Region>.

<Metadati>

<ExtendedData>

Consente di aggiungere dati personalizzati a un file KML. Questi dati possono essere (1) quelli che fanno riferimento a uno schema XML esterno, (2) dati non digitati/coppie di valori o (3) dati digitati. Una determinata funzionalità KML può contenere una combinazione di questi tipi di dati personalizzati.

Esempio di utilizzo di elementi HTML all'interno di una descrizione

Questo esempio illustra il set completo di elementi HTML supportati dall'elemento <description> in Google Earth 4.3. Google Earth 5.0 e versioni successive supportano HTML e JavaScript completi.

<?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>

Esempio di utilizzo degli elementi di ascription

Questo esempio mostra l'utilizzo degli elementi <atom:author>, <atom:name> e <atom:link> dallo spazio dei nomi Atom. Tieni presente che devi fare riferimento a questo spazio dei nomi all'interno dell'elemento <placeholder>.

<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>

Video di esempio

Questo esempio mostra come incorporare un video Flash all'interno del fumetto.

<?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>

Estende

<Oggetto>

Estensione eseguita da

<Contenitore>
<Overlay>
<Segnaposto>
<NetworkLink>
<gx:Tour>

<gx:FlyTo>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

<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>

Descrizione

<gx:FlyTo> specifica un punto dello spazio in cui il browser volerà durante un tour. Deve contenere un elemento AbstractView e diversi elementi <gx:duration> e <gx:flyToMode>, che specificano rispettivamente il tempo necessario per arrivare al punto definito dal punto corrente e il metodo del periodo di pubblicazione.

<gx:flyToMode>

I valori consentiti per <gx:flyToMode> sono due: smooth e bounce.

I FlyTo ottimali consentono un volo ininterrotto da un punto all'altro (e viceversa). Una serie ininterrotta di FlyTos fluidi inizierà e terminerà a velocità zero e non rallenterà ad ogni punto. Una serie di FlyTos fluidi è suddivisa per i seguenti elementi:
- <gx:flyToMode>bounce</gx:flyToMode>
- <gx:Wait>
Questo significa che la velocità sarà pari a zero nel fluido FlyTo che precede immediatamente gli elementi sopra riportati. Una serie di FlyTos fluidi non viene interrotta da elementi <gx:AnimatedUpdate>.

I FlyTo di bounce iniziano ciascuno e terminano a velocità zero.

Esempio

<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>

Estende

<gx:TourPrimitive>.

Contiene

<gx:duration>
<gx:flyToMode>
<AbstractView>

<Cartella>

Sintassi

<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>

Descrizione

Una cartella viene utilizzata per disporre altre funzionalità in modo gerarchico (cartelle, segnaposto, link di rete o overlay). Una funzione è visibile solo se è visibile insieme a tutti i suoi antenati.

Esempio

<?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>

Estende

<Contenitore>

Contiene

Qualsiasi elemento derivato da <Funzionalità>

<Geometria>

Sintassi

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

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Fornisce un oggetto segnaposto per tutti gli oggetti Geometry derivati.

Estende

<Oggetto>

Estensione eseguita da

<Punto>
<LineString>
<Anello lineare>
<Poligono>
<MultiGeometry>
<gx:MultiTrack>
<Modello>
<gx:Traccia>

<Overlay del terreno>

Sintassi

<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>

Descrizione

Questo elemento disegna un overlay immagine ricoperto di rilievo. L'elemento secondario <href> di <Icon> specifica l'immagine da utilizzare come overlay. Il file può trovarsi su un file system locale o su un server web. Se questo elemento viene omesso o non contiene <href>, viene tracciato un rettangolo usando il colore e i limiti LatLonBox definiti dall'overlay del terreno.

Elementi specifici per Ground Overlay

<altitudine>

specifica la distanza sopra la superficie terrestre, in metri, e viene interpretato in base alla modalità altitudine.

<altitudeMode>

specifica come viene interpretata l'<altitudine>. I valori possibili sono:

clampToGround (impostazione predefinita): indica di ignorare la specifica dell'altitudine e di nascondere l'overlay sul terreno.
assoluto: imposta l'altitudine dell'overlay rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sotto l'elemento. Ad esempio, se imposti l'altitudine di un overlay su 10 metri con una modalità di altitudine assoluta, l'overlay apparirà a livello del suolo se anche il terreno sottostante è a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, l'overlay apparirà in posizione elevata sopra il terreno di 7 metri.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova su un terreno anziché sul mare, questo valore verrà interpretato come fuori terra.
clampToSeaFloor: la specifica <altitudine> viene ignorata e l'overlay viene drappeggiato sul fondale marino. Se il punto si trova sulla terraferma invece che in mare, la sovrapposizione verrà posizionata sul pavimento.

<LatLonBox>

Specifica quando i lati superiore, inferiore, destro e sinistro di un riquadro di delimitazione sono allineati.

<north> Specifica la latitudine del bordo nord del riquadro di delimitazione, in gradi decimali da 0 a ±90.
<south> specifica la latitudine del bordo sud del riquadro di delimitazione, in gradi decimali da 0 a ±90.
<east> Specifica la longitudine del bordo est del riquadro di delimitazione, in gradi decimali da 0 a ±180. Per gli overlay che si sovrappongono al meridiano di 180° di longitudine, i valori possono estendersi oltre tale intervallo.
<west> Specifica la longitudine del bordo ovest del riquadro di delimitazione, in gradi decimali da 0 a ±180. Per gli overlay che si sovrappongono al meridiano di 180° di longitudine, i valori possono estendersi oltre tale intervallo.
<rotation> specifica la rotazione dell'overlay rispetto al centro. I valori possono essere ±180. Il valore predefinito è 0 (nord). Le rotazioni vengono specificate in una direzione in senso antiorario.

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

<gx:LatLonQuad>

Utilizzato per overlay al piano quadrate non rettangolari.

Esempio

<?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>

Estende

<Funzionalità>
<Overlay>

Contenuto da

<Documento>
<Cartella>

<Icona>

Sintassi

<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>

Descrizione

Definisce un'immagine associata a uno stile o a un overlay icona. L'elemento secondario <href> obbligatorio definisce la posizione dell'immagine da utilizzare come overlay o icona per il segnaposto. Questa posizione può trovarsi su un file system locale o su un server web remoto. Gli elementi <gx:x>, <gx:y>, <gx:w> e <gx:h> vengono utilizzati per selezionare un'icona da un'immagine che contiene più icone (spesso definita tavolozza delle icone).

<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>

Elementi specifici dell'icona

<href>: Un indirizzo HTTP o una specifica dei file locali utilizzata per caricare un'icona.
<gx:x>
<gx:y>: Se <href> specifica una tavolozza delle icone, questi elementi identificano gli offset, in pixel, dall'angolo inferiore sinistro della tavolozza delle icone.Se non vengono specificati valori per x e y, si presume che l'angolo inferiore sinistro della tavolozza delle icone sia l'angolo inferiore sinistro dell'icona da utilizzare.
<gx:w>
<gx:h>: Se <href> specifica una tavolozza delle icone, questi elementi specificano la larghezza (<gx:w>) e l'altezza (<gx:h>), in pixel, dell'icona da utilizzare.
<refreshMode>: Per una descrizione dell'elemento <updateMode> e degli altri elementi elencati di seguito, consulta <Link>.
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

Contenuto da

<Overlay del terreno>
<Overlay schermo>
<IconaStile>

<IconaStile>

Sintassi

<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>

Descrizione

Specifica come vengono disegnate le icone dei segnaposto del punto, sia nel riquadro Luoghi sia nel visualizzatore 3D di Google Earth. L'elemento <Icon> specifica l'immagine dell'icona. L'elemento <scale> specifica la scala x, y dell'icona. Il colore specificato nell'elemento <color> di <IconStyle> viene unito al colore di <Icon>.

Elementi specifici di IconStyle

<scala>

L'icona viene ridimensionata.

Nota: il tag <geomScale> è stato ritirato. Utilizza invece <scale>.

<intestazione>

Direzione (ovest, sud, sud, est, ovest), in gradi. Valore predefinito=0 (Nord). (vedi diagramma). I valori sono compresi tra 0 e 360 gradi.

<Icona>

Un'icona personalizzata. In <IconStyle>, l'unico elemento secondario di <Icon> è <href>:

<href>: un indirizzo HTTP o una specifica dei file locali utilizzata per caricare un'icona.

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

Specifica la posizione all'interno dell'icona "ancorata" al <punto> specificato nel segnaposto. I valori x e y possono essere specificati in tre modi diversi: come pixel ("pixels"), come frazioni dell'icona ("fraction") o come pixel incorporati ("insetPixels"), che è un offset in pixel dall'angolo in alto a destra dell'icona. Le posizioni x e y possono essere specificate in diversi modi, ad esempio x può essere in pixel e y può essere una frazione. L'origine del sistema di coordinate si trova nell'angolo in basso a sinistra dell'icona.

x: il numero di pixel, un componente frazionario dell'icona o un pixel inserito, che indica il componente x di un punto dell'icona.
y: il numero di pixel, un componente frazionario dell'icona o un riquadro pixel che indica il componente y di un punto dell'icona.
xunits: le unità in cui è specificato il valore x. Un valore fraction indica che il valore x è una frazione dell'icona. Un valore di pixel indica il valore x in pixel. Il valore insetPixels indica il rientro dal bordo destro dell'icona.
yunits: le unità in cui è specificato il valore y. Un valore fraction indica che il valore y è una frazione dell'icona. Un valore di pixel indica il valore y in pixel. Il valore insetPixels indica il rientro dal bordo superiore dell'icona.

Esempio

<?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>

Estende

<ColoreStile>

Contenuto da

<Stile>

Contiene

<href> come elemento secondario di <Icon>

<placeholder>

Sintassi

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

Descrizione

L'elemento principale di un file KML. Questo elemento è obbligatorio. Segue la dichiarazione XML all'inizio del file. L'attributo hint viene utilizzato come indicatore per Google Earth per visualizzare il file come dati celesti.

L'elemento <kb> può includere anche lo spazio dei nomi per gli schemi XML esterni a cui viene fatto riferimento all'interno del file.

Un elemento <placeholder> di base contiene 0 o 1 funzionalità e 0 o 1 NetworkLinkControl:

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

<LabelStyle>

Sintassi

<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>

Descrizione

Specifica come viene disegnato il <nome> di un elemento nel visualizzatore 3D. Puoi specificare un colore personalizzato, una modalità colore e una scala per l'etichetta (nome).

Nota: il tag <labelColor> è obsoleto. Usa <LabelStyle>.

Specifico per <LabelStyle>

<scala>: Ridimensiona l'etichetta.

Esempio

<?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>

Estende

<ColoreStile>

Contenuto da

<Stile>

<gx:LatLonQuad>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

<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>

Descrizione

Consente sovrapposizioni quadrate non rettangolari.

Specifica le coordinate dei quattro punti angolari di un quadrilatero che definiscono l'area di sovrapposizione. È necessario fornire esattamente quattro tuple coordinate, ciascuna composta da valori in virgola mobile per longitudine e latitudine. Inserisci uno spazio tra le tuple. Non inserire spazi all'interno di una tupla. Le coordinate devono essere specificate in senso antiorario con la prima coordinata corrispondente all'angolo inferiore sinistro dell'immagine sovrapposta. La forma descritta da questi angoli deve essere convessa.

Se viene inserito un terzo valore in una tupla (che rappresenta l'altitudine), verrà ignorato. L'altitudine è impostata utilizzando <altitude> e <altitudeMode> (o <gx:altitudeMode>) che estendono <GroundOverlay>. Le modalità di altitudine consentite sono assoluto, clampToGround e clampToSeaFloor.

Esempio

<?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>

Estende

<Oggetto>

Contenuto

<Overlay del terreno>

<LinearRing>

Sintassi

<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>

Descrizione

Definisce una stringa di linea chiusa, in genere il confine esterno di un poligono. Facoltativamente, un LinearRing può essere utilizzato anche come confine interno di un poligono per creare fori nel poligono. Un poligono può contenere più elementi <LinearRing> utilizzati come confini interni.

Nota: in Google Earth, un poligono con <HEIGHTMode> di clampToGround segue linee di direzione costanti, mentre un LinearRing (da solo) con <HEIGHTMode> di clampToGround segue grandi linee circolari.

Elementi specifici di LinearRing

<gx:OffsetOffset>

Nello spazio dei nomi delle estensioni Google, un'estensione KML modifica il modo in cui vengono visualizzati i valori di altitudine. Questo offset ti consente di spostare un intero LinearRing verso l'alto o verso il basso come unità senza modificare tutti i singoli valori delle coordinate che compongono il LinearRing. Anche se l'oggetto LinearRing viene visualizzato utilizzando il valore di offset altitudine, i valori originali dell'altitudine vengono conservati nel file KML. Le unità sono in metri.

<estrusione>

Valore booleano. Specifica se collegare l'anello lineare a terra. Per estrudere questa geometrica, la modalità altitudine deve essere relativeToGround, relativeToSeaFloor o assoluta. Vengono estrusi solo i vertici del LinearRing, non il centro della geometria. I vertici vengono estrusi verso il centro della sfera terrestre.

<tessellare>

Valore booleano. Specifica se consentire a LinearRing di seguire il rilievo. Per abilitare la definizione del tassello, il valore di <HEIGHTMode> deve essere clampToGround o clampToSeaFloor. Gli anelli lineari molto grandi dovrebbero consentire la tesellatura in modo che seguano la curvatura della terra (altrimenti possono rimanere sotterranei e nascosti).

<altitudeMode>

Specifica come vengono interpretati i componenti di altitudine nell'elemento <Coordinas>. I valori possibili sono:

clampToGround - (valore predefinito) Indica di ignorare una specifica dell'altitudine (ad es. nel tag < Coordinates>).
relativeToGround: imposta l'altitudine dell'elemento rispetto all'effettiva altitudine del suolo di una determinata posizione. Ad esempio, se l'altitudine del suolo di una località è esattamente al livello del mare e l'altitudine di un punto è impostata su 9 metri, questa modalità indica l'altitudine di un punto. Tuttavia, se la stessa coordinata è impostata su una posizione in cui l'altitudine del suolo è di 10 metri sul livello del mare, l'altitudine della coordinata è di 19 metri. Questa modalità è in genere consente di posizionare bastoncini per telefono o uno skilift.
assoluto: imposta l'altitudine delle coordinate rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sottostante. Ad esempio, se imposti l'altitudine di una coordinata su 10 metri in modalità di altitudine assoluta, l'icona di un segnaposto in linea apparirà a livello del suolo se anche il terreno sottostante si trova a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, il segnaposto viene visualizzato sopra il terreno di 7 metri. Un tipico utilizzo di questa modalità è per il posizionamento degli aerei.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova su un terreno anziché sul mare, questo valore verrà interpretato come fuori terra.
clampToSeaFloor: la specifica <altitudine> viene ignorata e il punto verrà posizionato sul fondale marino. Se il punto di accesso si trova a terra anziché al mare, verrà posizionato a terra.

< coordinate>(obbligatorio)

Quattro o più tuple, ciascuna composta da valori in virgola mobile per longitudine, latitudine e altitudine. Il componente altitudine è facoltativo. Non inserire spazi all'interno di una tupla. L'ultima coordinata deve essere uguale alla prima. Le coordinate sono espresse solo in gradi decimali.

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
  <name>LinearRing.kml</name>
  <Polygon>
    <outerBoundaryIs>
      <LinearRing>
        <coordinates>
          -122.365662,37.826988,0
          -122.365202,37.826302,0
          -122.364581,37.82655,0
          -122.365038,37.827237,0
          -122.365662,37.826988,0
        </coordinates>
      </LinearRing>
    </outerBoundaryIs>
  </Polygon>
</Placemark>
</kml>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<Segnaposto>
<InnerBoundaryIs>
<OuterBoundaryIs>

<LineString>

Sintassi

<LineString id="ID">
  <!-- specific to LineString -->
  <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 -->
  <gx:drawOrder>0</gx:drawOrder>            <!-- integer -->
  <coordinates>...</coordinates>            <!-- lon,lat[,alt] -->
</LineString>

Descrizione

Definisce un insieme collegato di segmenti di linee. Utilizza <LineStyle> per specificare il colore, la modalità di colore e la larghezza della linea. Quando si applica un'estrusione di una LineString, la linea si estende fino al suolo e forma un poligono che ricorda un po' come un muro o una recinzione. Per le stringhe Line estruse, la linea stessa utilizza l'attuale LineStyle, mentre l'estrusione utilizza l'attuale PolyStyle. Consulta il tutorial su KML per gli esempi di LineStrings (o percorsi).

Elementi specifici di LineString

<gx:HEIGHTOffset>

Nello spazio dei nomi delle estensioni Google, un'estensione KML modifica il modo in cui vengono visualizzati i valori di altitudine. Questo offset ti consente di spostare un'intera LineString verso l'alto o verso il basso come unità senza modificare tutti i singoli valori delle coordinate che formano la LineString. Anche se la stringa di riga viene visualizzata utilizzando il valore di offset altitudine, i valori originali dell'altitudine vengono conservati nel file KML. Le unità sono in metri.

<estrusione>

Valore booleano. Consente di specificare se connettere la LineString a terra. Per estruire una LineString, la modalità altitudine deve essere relativeToGround, relativeToSeaFloor o assoluta. I vertici in LineString sono estrusi al centro della sfera terrestre.

<tessellare>

Valore booleano. Consente di specificare se consentire alla LineString di seguire il rilievo. Per abilitare la definizione del tassello, la modalità altitudine deve essere clampToGround o clampToSeaFloor. I LineString molto grandi dovrebbero attivare la tessementazione in modo che seguano la curvatura della terra (altrimenti potrebbero rimanere sotterranei e nascosti).

<altitudeMode>

Specifica come vengono interpretati i componenti di altitudine nell'elemento <Coordinas>. I valori possibili sono:

clampToGround (impostazione predefinita): indica di ignorare una specifica dell'altitudine (ad es. nel tag < coordinates>).
relativeToGround: imposta l'altitudine dell'elemento rispetto all'effettiva altitudine del suolo di una determinata posizione. Ad esempio, se l'altitudine del suolo di una località è esattamente al livello del mare e l'altitudine di un punto è impostata su 9 metri, questa modalità indica l'altitudine di un punto. Tuttavia, se la stessa coordinata è impostata su una posizione in cui l'altitudine del suolo è di 10 metri sul livello del mare, l'altitudine della coordinata è di 19 metri. Questa modalità è in genere consente di posizionare bastoncini per telefono o uno skilift.
assoluto: imposta l'altitudine delle coordinate rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sottostante. Ad esempio, se imposti l'altitudine di una coordinata su 10 metri in modalità di altitudine assoluta, l'icona di un segnaposto in linea apparirà a livello del suolo se anche il terreno sottostante si trova a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, il segnaposto viene visualizzato sopra il terreno di 7 metri. Un tipico utilizzo di questa modalità è per il posizionamento degli aerei.

<gx:modeMode>

Un'estensione KML, nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova su un terreno anziché sul mare, questo valore verrà interpretato come fuori terra.
clampToSeaFloor: la specifica <altitudine> viene ignorata e il punto verrà posizionato sul fondale marino. Se il punto di accesso si trova a terra anziché al mare, verrà posizionato a terra.

<gx:drawOrder>

Un valore intero che specifica l'ordine in cui vengono tracciate più stringhe di righe. Le LineString disegnate per prime potrebbero essere parzialmente o completamente oscurate da LineStrings con un ordine di disegno successivo. Questo elemento può essere richiesto insieme agli elementi <gx:outerColor> e <gx:outerWidth> in <LineStyle> quando le righe con due colori si incrociano.

< coordinate>(obbligatorio)

Due o più tuple coordinate, ciascuna composta da valori in virgola mobile per longitudine, latitudine e altitudine. Il componente altitudine è facoltativo. Inserisci uno spazio tra le tuple. Non inserire spazi all'interno di una tupla.

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>LineString.kml</name>
  <open>1</open>
  <LookAt>
    <longitude>-122.36415</longitude>
    <latitude>37.824553</latitude>
    <altitude>0</altitude>
    <range>150</range>
    <tilt>50</tilt>
    <heading>0</heading>
  </LookAt>
  <Placemark>
    <name>unextruded</name>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <coordinates>
        -122.364383,37.824664,0 -122.364152,37.824322,0
      </coordinates>
    </LineString>
  </Placemark>
  <Placemark>
    <name>extruded</name>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <altitudeMode>relativeToGround</altitudeMode>
      <coordinates>
        -122.364167,37.824787,50 -122.363917,37.824423,50
      </coordinates>
    </LineString>
  </Placemark>
</Document>
</kml>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<Segnaposto>

<LineStyle>

Sintassi

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

  <!-- specific to LineStyle -->
  <width>1</width>                            <!-- float -->
  <gx:outerColor>ffffffff</gx:outerColor>     <!-- kml:color -->
  <gx:outerWidth>0.0</gx:outerWidth>          <!-- float -->
  <gx:physicalWidth>0.0</gx:physicalWidth>    <!-- float -->
  <gx:labelVisibility>0</gx:labelVisibility>  <!-- boolean -->
</LineStyle>

Descrizione

Specifica lo stile del disegno (colore, modalità colore e spessore linea) per tutte le geometrie delle linee. La geometrica della linea include i contorni dei poligoni contorni e l'estremo "tether" delle icone dei segnaposto (se l'estrusione è abilitata).

Elementi specifici di LineStyle

<larghezza>

Larghezza della linea, in pixel.

<gx:outerColor>

Colore della porzione della linea definita da <gx:outerWidth>. Tieni presente che gli elementi <gx:outerColor> e <gx:outerWidth> vengono ignorati quando viene applicato <LineStyle> a < poligono> e <LinearRing>.

<gx:outerWidth>

Un valore compreso tra 0,0 e 1,0 che specifica la proporzione della riga che utilizza <gx:outerColor>. Si applica solo alle righe che impostano la larghezza con <gx:physicalWidth>; non si applica alle righe che utilizzano <width>. Vedi anche <gx:drawOrder> in <LineString>. Potrebbe essere necessario un valore dell'ordine di disegno se le righe a due colori si incrociano tra loro, ad esempio per mostrare gli svincoli autostradali.

<gx:Larghezzafisica>

Larghezza fisica della linea, in metri.

<gx:labelVisibility>

Un valore booleano che definisce se visualizzare o meno un'etichetta di testo su una LineString. L'etichetta di una LineString è contenuta nell'elemento <name> che è un elemento di pari livello di <LineString> (ovvero contenuti all'interno dello stesso elemento <Placemark>).

Nella versione 6.1 e successive di Google Earth non vengono mostrate etichette per impostazione predefinita, ma devono essere attivate per ogni LineString impostando <gx:labelVisibility> su 1.

Problema noto di Google Earth 6.1: per le stringhe LineString senza un elemento <gx:physicalWidth> viene visualizzata soltanto l'etichetta se la lunghezza della riga è superiore a 100 metri * il numero di caratteri nell'etichetta. Ad esempio, un'etichetta con sette caratteri ("example") verrà visualizzata solo se la riga è superiore a 700 m. Non influisce su LineStrings con un valore <gx:physicalWidth>.

Esempio

L'esempio seguente mostra una linea rossa opaca del 50% con una larghezza di 4 pixel.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>LineStyle.kml</name>
  <open>1</open>
  <Style id="linestyleExample">
    <LineStyle>
      <color>7f0000ff</color>
      <width>4</width>
      <gx:labelVisibility>1</gx:labelVisibility>
    </LineStyle>
  </Style>
  <Placemark>
    <name>LineStyle Example</name>
    <styleUrl>#linestyleExample</styleUrl>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <coordinates>
        -122.364383,37.824664,0 -122.364152,37.824322,0
      </coordinates>
    </LineString>
  </Placemark>
</Document>
</kml>

Estende

<ColoreStile>

Contenuto da

<Stile>

<Link>

Sintassi

<Link id="ID">
  <!-- specific to Link -->
  <href>...</href>                      <!-- string -->
  <refreshMode>onChange</refreshMode>
    <!-- refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>  <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>  <!-- float -->
  <viewBoundScale>1</viewBoundScale>    <!-- float -->
  <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]</viewFormat>
                                        <!-- string -->
  <httpQuery>...</httpQuery>            <!-- string -->
</Link>

Descrizione

<Link> specifica la posizione di uno dei seguenti elementi:

File KML recuperati da link di rete
File immagine utilizzati in qualsiasi overlay (l'elemento <Icon> specifica l'immagine in un overlay; <Icon> ha gli stessi campi di <Link>)
File del modello utilizzati nell'elemento <Model>

Il file viene caricato e aggiornato in modo condizionale, a seconda dei parametri di aggiornamento forniti qui. È possibile specificare due insiemi diversi di parametri di aggiornamento: un altro si basa sul time (<updateMode> e <updateInterval>) e l'altro si basa sulla vista "camera" corrente (<viewRefreshMode> e <viewRefreshTime>). Inoltre, Link specifica se scalare i parametri del riquadro di delimitazione che vengono inviati al server (<viewBoundScale>) e forniscono un insieme di parametri di visualizzazione facoltativi, nonché l'invio della versione> al server

Quando viene recuperato un file, l'URL che viene inviato al server è composto da tre informazioni:

href (Hypertext Reference) che specifica il file da caricare.
una stringa di formato arbitraria creata da (a) parametri specificati nell'elemento <viewFormat> o (b) parametri del riquadro di delimitazione (impostazione predefinita e utilizzata se nessun file <viewFormat> è incluso nel file).
una seconda stringa di formato specificata nell'elemento <httpQuery>.

Se il file specificato in <href> è un file locale, gli elementi <viewFormat> e <httpQuery> non vengono utilizzati.

L'elemento <Link> sostituisce l'elemento <Url> di <NetworkLink> contenuto nelle release KML precedenti e aggiunge funzionalità per l'elemento <Region> (introdotto in KML 2.1). In Google Earth 3.0 e versioni precedenti, l'elemento <Link> viene ignorato.

Elementi specifici per il collegamento

<href>

Un URL (un indirizzo HTTP o una specifica dei file locali). Quando l'elemento principale di <Link> è NetworkLink, <href> è un file KML. Quando l'elemento principale di <Link> è un modello, <href> è un file COLLADA. Quando il tag principale di <Icon> (stessi campi di <Link>) è un overlay, <href> è un'immagine. Gli URL relativi possono essere utilizzati in questo tag e vengono valutati in base al file KML contenitore. Consulta File KMZ per maggiori dettagli sulla creazione di riferimenti relativi nei file KML e WebRTC.

<updateMode>

Specifica una modalità di aggiornamento basata sul tempo, che può essere una delle seguenti:

onChange: aggiorna quando il file viene caricato e ogni volta che i parametri del link cambiano (impostazione predefinita).
onInterval: aggiorna ogni n secondi (specificato in <updateInterval>).
onExpire: aggiorna il file quando viene raggiunta la data di scadenza. Se un file recuperato ha un NetworkLinkControl, il tempo di <expires> ha la precedenza sui tempi di scadenza specificati nelle intestazioni HTTP. Se non viene specificato alcun orario <expires>, viene utilizzata l'intestazione HTTP max-age (se presente). Se max-age non è presente, viene utilizzata l'intestazione HTTP Expiration (se presente). Per i dettagli sui campi di intestazione HTTP, consulta la sezione RFC261b di Hypertext Transfer Protocol - HTTP 1.1.

<updateInterval>

Indica per aggiornare il file ogni n secondi.

<viewRefreshMode>

Specifica come viene aggiornato il link quando cambia la "fotocamera".

Può essere uno dei seguenti:

mai (impostazione predefinita): ignora le modifiche nella visualizzazione. Ignora anche i parametri <viewFormat>, se presenti.
onStop: aggiorna il file n secondi dopo l'arresto del movimento, dove n è specificato in <viewRefreshTime>.
onRequest: aggiorna il file solo quando l'utente lo richiede esplicitamente. Ad esempio, in Google Earth l'utente fa clic con il tasto destro del mouse e seleziona Aggiorna nel menu contestuale.
onRegion: aggiorna il file quando la regione diventa attiva. Consulta la sezione <Region>.

<viewRefreshTime>

Dopo aver interrotto il movimento della videocamera, specifica il numero di secondi da attendere prima di aggiornare la visualizzazione. Vedi <viewRefreshMode> e onStop in alto.

<viewBoundScale>

Scala i parametri BBOX prima di inviarli al server. Un valore inferiore a 1 specifica di utilizzare meno della visualizzazione completa (schermata). Un valore maggiore di 1 specifica di recuperare un'area che si estende oltre i bordi della vista corrente.

<viewFormat>

Specifica il formato della stringa di query che viene aggiunta alla riga <href> del link prima che il file venga recuperato. Se <href> specifica un file locale, questo elemento viene ignorato.

Se specifichi <viewRefreshMode> di onStop e non includi il tag <viewFormat> nel file, vengono aggiunte automaticamente le seguenti informazioni alla stringa di query:

BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNord]

Queste informazioni corrispondono alla specifica del riquadro di delimitazione WMS (Web Map Service).

Se specifichi un tag <viewFormat> vuoto, non vengono aggiunte informazioni alla stringa di query.

Puoi anche specificare un set personalizzato di parametri di visualizzazione da aggiungere alla stringa di query. Se fornisci una stringa di formato, questa viene utilizzata anziché le informazioni BBOX. Se vuoi avere anche le informazioni BBOX, devi aggiungere questi parametri insieme ai parametri personalizzati.

Nella stringa di formato puoi utilizzare uno qualsiasi dei seguenti parametri (Google Earth sostituirà il valore attuale appropriato al momento della creazione della stringa di query):

[lookatLon], [lookatLat] : longitudine e latitudine del punto visualizzato da <LookAt>
[lookatRange], [lookatTilt], [lookatHeader]: valori utilizzati dall'elemento <LookAt> (consulta le descrizioni di <range>, <tilt> e <header> in <LookAt>)
[lookatterraLon], [lookat TerreLat], [lookatterraAlt]]: punto sul terreno in gradi/metri che <LookAt> sta visualizzando
[cameraLon], [cameraLat], [cameraAlt]: gradi/metri dell'obiettivo per la videocamera
[horizFov], [vertFov] : campo visivo orizzontale orizzontale della videocamera
[horizPixels], [vertPixels] - dimensioni in pixel del visualizzatore 3D
[terrainEnabled]: indica se il visualizzatore 3D mostra i rilievi

<httpQuery>

Aggiunge informazioni alla stringa di query in base ai parametri specificati. (Google Earth sostituisce il valore corrente appropriato al momento della creazione della stringa di query.) Sono supportati i seguenti parametri:

[clientVersione]
[VersioneVersione]
[nomeclient]
[lingua]

Esempio

<NetworkLink>
  <name>NE US Radar</name>
  <flyToView>1</flyToView>
  <Link>
    <href>http://www.example.com/geotiff/NE/MergedReflectivityQComposite.kml</href>
    <refreshMode>onInterval</refreshMode>
    <refreshInterval>30</refreshInterval>
    <viewRefreshMode>onStop</viewRefreshMode>
    <viewRefreshTime>7</viewRefreshTime>
    <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth];CAMERA=\
      [lookatLon],[lookatLat],[lookatRange],[lookatTilt],[lookatHeading];VIEW=\
      [horizFov],[vertFov],[horizPixels],[vertPixels],[terrainEnabled]</viewFormat>
  </Link>
</NetworkLink>

<ListStyle>

Sintassi

<ListStyle id="ID">
  <!-- specific to ListStyle -->
  <listItemType>check</listItemType> <!-- kml:listItemTypeEnum:check,
                                          checkOffOnly,checkHideChildren,
                                         radioFolder -->
  <bgColor>ffffffff</bgColor>        <!-- kml:color -->
  <ItemIcon>                         <!-- 0 or more ItemIcon elements -->
    <state>open</state>
      <!-- kml:itemIconModeEnum:open, closed, error, fetching0, fetching1, or fetching2 -->
    <href>...</href>                 <!-- anyURI -->
  </ItemIcon>
</ListStyle>

Descrizione

Specifica come viene mostrata una funzionalità nella visualizzazione elenco. La visualizzazione elenco è una gerarchia di contenitori e elementi secondari; in Google Earth si tratta del riquadro Luoghi.

Elementi specifici di ListStyle

<listItemType>

Specifica come viene mostrata una funzionalità nella visualizzazione elenco. I valori possibili sono:

check (valore predefinito): la visibilità dell'elemento è collegata alla casella di controllo dell'elemento.
radioFolder: se specificato per un contenitore, è visibile solo uno degli elementi del contenitore alla volta
checkOffOnly: se specificato per un contenitore o un link di rete, impedisce che tutti gli elementi vengano resi visibili contemporaneamente, ovvero l'utente può disattivare tutti i contenuti del contenitore o del link di rete, ma non può attivarli contemporaneamente. Questa impostazione è utile per i container o i link di rete che contengono grandi quantità di dati.
checkNascondiChild: utilizza una normale casella di controllo per la visibilità, ma non visualizzare i contenitori del contenitore o del link di rete nella visualizzazione elenco. Una casella di controllo consente all'utente di attivare/disattivare la visibilità degli oggetti secondari nel visualizzatore.

<bgColor>

Il colore di sfondo dello snippet. I valori di colore e opacità sono espressi in notazione esadecimale. L'intervallo di valori per ogni colore è compreso tra 0 e 255 (da 00 a ff). Per la versione alpha, 00 è completamente trasparente e ff è completamente opaco. L'ordine dell'espressione è aabbggrr, dove aa=alpha (da 00 a ff); bb=blue (da 00 a ff); gg=green (da 00 a ff); rr=red (da 00 a ff). Ad esempio, se vuoi applicare un colore blu a un overlay con il 50% di opacità, devi specificare: <color>7fff0000</color>, dove alpha=0x7f, blu=0xff, verde=0x00 e rosso=0x00.

<ItemIcon>

L'icona utilizzata nella visualizzazione elenco che riflette lo stato del recupero di una cartella o di un link. Le icone associate alle modalità aperte e chiuse vengono utilizzate per le cartelle e i link di rete. Le icone associate alle modalità error e fetching0, fetching1 e fetching2 vengono utilizzate per i link di rete. La seguente schermata mostra le icone di Google Earth in questi stati:

<stato>: Specifica lo stato attuale di NetworkLink o Folder. I valori possibili sono open, closed, error, fetching0, fetching1 e fetching2. È possibile combinare questi valori inserendo uno spazio tra due valori (senza virgola).
<href>: Specifica l'URI dell'immagine utilizzata nella Visualizzazione elenco per l'elemento.

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>ListStyle.kml</name>
  <open>1</open>
  <Style id="bgColorExample">
    <ListStyle>
      <bgColor>ff336699</bgColor>
    </ListStyle>
  </Style>
  <Style id="checkHideChildrenExample">
    <ListStyle>
      <listItemType>checkHideChildren</listItemType>
    </ListStyle>
  </Style>
  <Style id="radioFolderExample">
    <ListStyle>
      <listItemType>radioFolder</listItemType>
    </ListStyle>
  </Style>
  <Folder>
    <name>ListStyle Examples</name>
    <open>1</open>
    <Folder>
      <name>bgColor example</name>
      <open>1</open>
      <Placemark>
        <name>pl1</name>
        <Point>
          <coordinates>-122.362815,37.822931,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl2</name>
        <Point>
          <coordinates>-122.362825,37.822931,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl3</name>
        <Point>
          <coordinates>-122.362835,37.822931,0</coordinates>
        </Point>
      </Placemark>
      <styleUrl>#bgColorExample</styleUrl>
    </Folder>
    <Folder>
      <name>checkHideChildren example</name>
      <open>1</open>
      <Placemark>
        <name>pl4</name>
        <Point>
          <coordinates>-122.362845,37.822941,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl5</name>
        <Point>
          <coordinates>-122.362855,37.822941,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl6</name>
        <Point>
          <coordinates>-122.362865,37.822941,0</coordinates>
        </Point>
      </Placemark>
      <styleUrl>#checkHideChildrenExample</styleUrl>
    </Folder>
    <Folder>
      <name>radioFolder example</name>
      <open>1</open>
      <Placemark>
        <name>pl7</name>
        <Point>
          <coordinates>-122.362875,37.822951,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl8</name>
        <Point>
          <coordinates>-122.362885,37.822951,0</coordinates>
        </Point>
      </Placemark>
      <Placemark>
        <name>pl9</name>
        <Point>
          <coordinates>-122.362895,37.822951,0</coordinates>
        </Point>
      </Placemark>
      <styleUrl>#radioFolderExample</styleUrl>
    </Folder>
  </Folder>
</Document>
</kml>

Estende

<Oggetto>

Contenuto da

<Stile>

<LookAt>

Sintassi

<LookAt 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 LookAt -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos90 -->
  <range></range>                     <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
          <!--kml:altitudeModeEnum:clampToGround, relativeToGround, absolute -->
          <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->

</LookAt>

Descrizione

Definisce una videocamera virtuale associata a qualsiasi elemento derivato dalla funzionalità. L'elemento LookAt posiziona la "fotocamera" in relazione all'oggetto visualizzato. In Google Earth, la vista "vola verso" questo punto di osservazione LookAt quando l'utente fa doppio clic su un elemento nel riquadro Luoghi o fa doppio clic su un'icona nel visualizzatore 3D.

Elementi specifici di LookAt

<longitudine>

Longitudine del punto che la fotocamera sta guardando. Distanza angolare in gradi, rispetto al meridiano di Prime. Valori a ovest dell'intervallo meridiano da -180 a 0 gradi. Valori a est dell'intervallo Meridiano da 0 a 180 gradi.

<latitudine>

Latitudine del punto che la fotocamera sta guardando. Gradi a nord o a sud dell'equatore (0 gradi). I valori sono compresi tra -90 e 90 gradi.

<altitudine>

Distanza dalla superficie terrestre, in metri. Interpretato in base alla modalità altitudine di LookAt.

<intestazione>

Direzione (ovest, sud, sud, est, ovest), in gradi. Valore predefinito=0 (Nord). Vedi il diagramma che segue. I valori sono compresi tra 0 e 360 gradi.

<tilt>

Angolo tra la direzione della posizione della LookAt e la normalità rispetto alla superficie della terra. Vedi il diagramma che segue. I valori sono compresi tra 0 e 90 gradi. I valori di <tilt> non possono essere negativi. Un valore <tilt> di 0 gradi indica la visualizzazione direttamente dall'alto. Un valore <tilt> di 90° indica la visualizzazione lungo l'orizzonte.

<range>(obbligatorio)

Distanza in metri dal punto specificato da <longitudine>, < latitudine> e <altitudine> alla posizione LookAt. Vedi il diagramma che segue.

<altitudeMode>

Specifica come viene interpretata l'<altitudine> specificata per il punto LookAt. I valori possibili sono i seguenti:

clampToGround : (impostazione predefinita) indica di ignorare la specifica <HEIGHT> e posizionare la posizione LookAt a terra.
relativeToGround: interpreta l'<altitudine> come un valore in metri dal suolo.
assoluto: interpreta <altitudine> come un valore in metri sul livello del mare.

<gx:altitudineMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova su un terreno anziché sul mare, questo valore verrà interpretato come fuori terra.
clampToSeaFloor: la specifica < Altitum> viene ignorata e l'area LookAt verrà posizionata sul fondale marino. Se il punto di accesso è sulla terraferma e non al mare, il LookAt verrà posizionato a terra.

Questo diagramma mostra gli elementi <range>, <tilt> e <HEIGHT>:

Questo diagramma illustra l'elemento <header>:

<?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>LookAt.kml</name>
    <LookAt>
      <gx:TimeStamp>
        <when>1994</when>
      </gx:TimeStamp>
      <longitude>-122.363</longitude>
      <latitude>37.81</latitude>
      <altitude>2000</altitude>
      <range>500</range>
      <tilt>45</tilt>
      <heading>0</heading>
      <altitudeMode>relativeToGround</altitudeMode>
    </LookAt>
    <Point>
      <coordinates>-122.363,37.82,0</coordinates>
    </Point>
  </Placemark>
</kml>

Estende

<Visualizzazione astratta>

Contenuto da

Qualsiasi elemento derivato da <Funzionalità>
<NetworkLinkControl>

<Modello>

Sintassi

<Model id="ID">
  <!-- specific to Model -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround,relativeToGround,or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <Location>
    <longitude></longitude> <!-- kml:angle180 -->
    <latitude></latitude>   <!-- kml:angle90 -->
    <altitude>0</altitude>  <!-- double -->
  </Location>
  <Orientation>
    <heading>0</heading>    <!-- kml:angle360 -->
    <tilt>0</tilt>          <!-- kml:anglepos180 -->
    <roll>0</roll>          <!-- kml:angle180 -->
  </Orientation>
  <Scale>
    <x>1</x>                <!-- double -->
    <y>1</y>                <!-- double -->
    <z>1</z>                <!-- double -->
  </Scale>
  <Link>...</Link>
  <ResourceMap>
    <Alias>
      <targetHref>...</targetHref>   <!-- anyURI -->
      <sourceHref>...</sourceHref>   <!-- anyURI -->
    </Alias>
  </ResourceMap>
</Model>

Descrizione

Un oggetto 3D descritto in un file COLLADA (cui si fa riferimento nel tag <Link>). I file COLLADA hanno un'estensione .dae. I modelli vengono creati in un proprio spazio coordinato, quindi vengono posizionati, posizionati e scalati in Google Earth. Per maggiori dettagli, consulta la pagina "Argomenti in KML" nella sezione Modelli.

Google Earth supporta il profilo comune COLLADA, con le seguenti eccezioni:

Google Earth supporta solo triangoli e linee come tipi primitivi. Il numero massimo di triangoli consentito è 21.845.
Google Earth non supporta animazioni e skin.
Google Earth non supporta i riferimenti a geometrie esterne.

Elementi specifici del modello

<altitudeMode>

Specifica come viene interpretata l'<altitudine> specificata in <Località>. I valori possibili sono i seguenti:

clampToGround (impostazione predefinita): indica di ignorare la specifica <HEIGHT> e posizionare il modello a terra.
relativeToGround: interpreta l'<altitudine> come un valore in metri dal suolo.
assoluto: interpreta <altitudine> come un valore in metri sul livello del mare.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova su un terreno anziché sul mare, questo valore verrà interpretato come fuori terra.
clampToSeaFloor: la specifica <altitudine> viene ignorata e il modello verrà posizionato sul fondale marino. Se il punto si trova sulla terraferma invece che in mare, il Modello verrà posizionato a terra.

<Località>

Specifica le coordinate esatte dell'origine del modello in latitudine, longitudine e altitudine. Le misurazioni di latitudine e longitudine sono proiezioni lat-lon standard con dato WGS84. Altitudine è la distanza sopra la superficie terrestre, in metri, ed è interpretata secondo un criterio <HEIGHTMode> o <gx:HEIGHTMode>.

<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location>

<Orientamento>

Descrive la rotazione del sistema di coordinate di un modello 3D per posizionare l'oggetto in Google Earth. Vedi i diagrammi seguenti.

<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation>

Le rotazioni vengono applicate a un modello nel seguente ordine:

<roll>
<tilt>
<intestazione>

<intestazione>: Rotazione sull'asse z (normale sulla superficie terrestre). Un valore pari a 0 (valore predefinito) equivale a Nord. Una rotazione positiva ruota in senso orario attorno all'asse z e viene specificata in gradi da 0 a 360.
<tilt>: Rotazione sull'asse x. Una rotazione positiva ruota in senso orario attorno all'asse x e viene specificata in gradi da 0 a 180.
<roll>: Rotazione sull'asse y. Una rotazione positiva ruota in senso orario attorno all'asse y e viene specificata in gradi da 0 a 180.; Questo diagramma mostra l'orientamento tipico degli assi di un modello:

<Scala>

Scala un modello lungo gli assi x, y e z nello spazio di coordinata del modello.

<Scale>
  <x>2.5</x>
  <y>2.5</y>
  <z>3.5</z>
</Scale>

<Link>

Specifica il file da caricare e i parametri di aggiornamento facoltativi. Consulta la sezione <Link>.

<ResourceMap>

Specifica 0 o più elementi <Alias>, ognuno dei quali è una mappatura del percorso del file di texture dal file Collada originale al file KML o TTM contenente il modello. Questo elemento consente di spostare e rinominare i file di texture senza dover aggiornare il file Collada originale che fa riferimento a quelle texture. Un elemento <ResourceMap> può contenere più mappature da file Collada diversi (di origine) in uno stesso file YAML (target).

<Alias>
  <targetHref>../images/foo.jpg</targetHref>
  <sourceHref>c:\mytextures\foo.jpg</sourceHref>
</Alias>

<Alias> contiene una mappatura da un elemento <sourceHref> a un elemento <targetHref>:

<targetHref>.: Specifica il file di texture che verrà recuperato da Google Earth. Può essere un riferimento relativo a un file immagine all'interno dell'archivio .pdfs o un riferimento assoluto al file (ad esempio un URL).
<origineHref>: È il percorso specificato per il file di texture nel file Collada.dae.

In Google Earth, se questa mappatura non viene fornita, vengono utilizzate le seguenti regole per individuare le texture a cui viene fatto riferimento nel file Collada (.dae):

Nessun percorso: se il nome della trama non include un percorso, Google Earth cerca la trama nella stessa directory del file .dae che vi fa riferimento.
Percorso relativo: se il nome della trama include un percorso relativo (ad esempio ../images/mytexture.jpg), Google Earth interpreta il percorso come relativo rispetto al file .dae che vi fa riferimento.
Percorso assoluto: se il nome della texture è un percorso assoluto (c:\mytexture.jpg) o un percorso di rete (ad esempio, http://myserver.com/mytexture.jpg), Google Earth cerca il file nella posizione specificata, indipendentemente da dove si trova il file .dae.

Esempio

<Model id="khModel543"> 
  <altitudeMode>relativeToGround</altitudeMode> 
  <Location> 
    <longitude>39.55375305703105</longitude> 
    <latitude>-118.9813220168456</latitude> 
    <altitude>1223</altitude> 
  </Location> 
  <Orientation> 
    <heading>45.0</heading> 
    <tilt>10.0</tilt> 
    <roll>0.0</roll> 
  </Orientation> 
  <Scale> 
    <x>1.0</x> 
    <y>1.0</y> 
    <z>1.0</z> 
  </Scale> 
  <Link> 
    <href>house.dae</href> 
    <refreshMode>once</refreshMode> 
  </Link> 
  <ResourceMap>
    <Alias>
      <targetHref>../files/CU-Macky---Center-StairsnoCulling.jpg</targetHref>
      <sourceHref>CU-Macky---Center-StairsnoCulling.jpg</sourceHref>
    </Alias>
    <Alias>
      <targetHref>../files/CU-Macky-4sideturretnoCulling.jpg</targetHref>
      <sourceHref>CU-Macky-4sideturretnoCulling.jpg</sourceHref>
    </Alias>
    <Alias>
      <targetHref>../files/CU-Macky-Back-NorthnoCulling.jpg</targetHref>
      <sourceHref>CU-Macky-Back-NorthnoCulling.jpg</sourceHref>
    </Alias>
  </ResourceMap>
</Model>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<Segnaposto>

<MultiGeometry>

Sintassi

<MultiGeometry id="ID">
  <!-- specific to MultiGeometry -->
  <!-- 0 or more Geometry elements -->
</MultiGeometry>

Descrizione

Un container con zero o più primitive di geometrica associate alla stessa funzionalità.

Nota: il tag <GeometryCollection> è stato ritirato. Usa <MultiGeometry>.

Elementi specifici della multiGeometria

0 o più elementi <Geometry>

Esempio

<Placemark>
  <name>SF Marina Harbor Master</name>
  <visibility>0</visibility>
  <MultiGeometry>
    <LineString>
      <!-- north wall -->
      <coordinates>
        -122.4425587930444,37.80666418607323,0
        -122.4428379594768,37.80663578323093,0
      </coordinates>
    </LineString>
    <LineString>
      <!-- south wall -->
      <coordinates>
        -122.4425509770566,37.80662588061205,0
        -122.4428340530617,37.8065999493009,0
      </coordinates>
    </LineString>
  </MultiGeometry>
</Placemark>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<Segnaposto>

<gx:MultiTrack>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.2 e versioni successive. Scopri di più

Sintassi

<gx:MultiTrack id="ID">
  <!-- specific to MultiTrack -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:interpolate>0<gx:interpolate>   <!-- boolean -->
  <gx:Track>...</gx:Track>            <!-- one or more gx:Track elements -->
</gx:MultiTrack>

Descrizione

Un elemento multitraccia viene utilizzato per combinare più elementi in un'unica unità concettuale. Ad esempio, supponi di raccogliere dati GPS relativi a una corsa in bici di un giorno che include diverse aree di sosta e una sosta per pranzo. A causa delle interruzioni nel tempo, una corsa in bici potrebbe essere visualizzata come quattro tracce diverse quando gli orari e le posizioni vengono tracciati. Il raggruppamento di questi elementi <gx:Track> in un contenitore <gx:MultiTrack> viene visualizzato in Google Earth come sezioni di un singolo percorso. Quando l'icona raggiunge la fine di un segmento, questo si sposta all'inizio del segmento successivo. L'elemento <gx:interpolate> specifica se effettuare l'interruzione alla fine di una traccia e passare immediatamente all'inizio di quella successiva oppure se interagire con i valori mancanti tra le due tracce.

Elementi specifici di gx:MultiTrack

Specifica come vengono interpretati i componenti di altitudine nell'elemento <Coordinas>. I valori possibili sono:

clampToGround : (valore predefinito) indica di ignorare una specifica dell'altitudine, ad esempio nell'elemento <gx:coord>.
relativeToGround: imposta l'altitudine dell'elemento rispetto all'effettiva altitudine del suolo di una determinata posizione. Ad esempio, se l'altitudine del suolo di una località è esattamente al livello del mare e l'altitudine di un punto è impostata su 9 metri, questa modalità indica l'altitudine di un punto. Tuttavia, se la stessa coordinata è impostata su una posizione in cui l'altitudine del suolo è di 10 metri sul livello del mare, l'altitudine della coordinata è di 19 metri.
assoluto: imposta l'altitudine delle coordinate rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sottostante. Ad esempio, se imposti l'altitudine di una coordinata su 10 metri in modalità di altitudine assoluta, l'icona di un segnaposto in linea apparirà a livello del suolo se anche il terreno sottostante si trova a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, il segnaposto viene visualizzato sopra il terreno di 7 metri.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'altitudine come valore in metri sul livello del mare. Se il punto si trova sopra il terreno anziché sul mare, l'altitudine sarà interpretata come se fosse sopra terra.
clampToSeaFloor: la specifica dell'altitudine viene ignorata e il punto verrà posizionato sul fondale marino. Se il punto di accesso si trova a terra anziché al mare, verrà posizionato a terra.

<gx:interpolate>

Valore booleano. Se la multitraccia contiene più elementi <gx:Track>, specifica se interpolare i valori mancanti tra la fine della prima traccia e l'inizio di quella successiva. Quando viene utilizzato il valore predefinito (0), l'icona o il modello vengono interrotti alla fine di una traccia e torna all'inizio di quella successiva.

Contiene

<gx:Traccia>

<NetworkLink>

Sintassi

<NetworkLink 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 NetworkLink -->
  <refreshVisibility>0</refreshVisibility> <!-- boolean -->
  <flyToView>0</flyToView>                 <!-- boolean -->
  <Link>...</Link>
</NetworkLink>

Descrizione

Fa riferimento a un file KML o a un archivio WebRTC su una rete locale o remota. Utilizza l'elemento <Link> per specificare la posizione del file KML. All'interno di questo elemento, puoi definire le opzioni di aggiornamento per l'aggiornamento del file in base al tempo e alla modifica della videocamera. NetworkLinks può essere utilizzato in combinazione con una regione per gestire set di dati di grandi dimensioni in modo efficiente.

Elementi specifici di NetworkLink

<AggiornaVisibilità>: Valore booleano. Un valore pari a 0 lascia la visibilità delle funzionalità sotto il controllo dell'utente di Google Earth. Imposta il valore su 1 per reimpostare la visibilità delle funzionalità ogni volta che NetworkLink viene aggiornato. Ad esempio, supponi che un segnaposto all'interno del file KML collegato abbia <visibilità> impostato su 1 e NetworkLink abbia <AggiornaVisibilità> impostato su 1. Al primo caricamento del file in Google Earth, l'utente può deselezionare la casella di controllo accanto all'elemento per disattivare la visualizzazione nel visualizzatore 3D. Tuttavia, quando il link di rete viene aggiornato, il segnaposto diventa di nuovo visibile, poiché il suo stato di visibilità originale era VERO.
<flyToView>: Valore booleano. Il valore 1 fa sì che Google Earth passi in volo alla visualizzazione di LookAt o Camera in NetworkLinkControl (se esistente). Se NetworkLinkControl non contiene un elemento AbstractView, Google Earth vola sull'elemento LookAt o Camera nell'elemento secondario Feature elementi all'interno dell'elemento <kb> nel file aggiornato. Se per l'elemento <placeholder> non sono stati specificati valori LookAt o Fotocamera, la vista rimane invariata. Ad esempio, Google Earth raggiungerebbe "in volo" la vista <LookAt> del documento principale e non la vista <LookAt> dei segnaposto contenuti nel documento.
<Link>(obbligatorio)

Esempio

<Document>
  <visibility>1</visibility>
  <NetworkLink>
    <name>NE US Radar</name>
    <refreshVisibility>1</refreshVisibility>
    <flyToView>1</flyToView>
    <Link>...</Link></NetworkLink>
</Document>

Estende

<Funzionalità>

Contenuto da

Qualsiasi elemento derivato da <Container>

<NetworkLinkControl>

Sintassi

<NetworkLinkControl>
  <minRefreshPeriod>0</minRefreshPeriod>           <!-- float -->
  <maxSessionLength>-1</maxSessionLength>          <!-- float --> 
  <cookie>...</cookie>                             <!-- string -->
  <message>...</message>                           <!-- string -->
  <linkName>...</linkName>                         <!-- string -->
  <linkDescription>...</linkDescription>           <!-- string -->
  <linkSnippet maxLines="2">...</linkSnippet>      <!-- string -->
  <expires>...</expires>                           <!-- kml:dateTime -->
  <Update>...</Update>                             <!-- Change,Create,Delete -->
  <AbstractView>...</AbstractView>                 <!-- LookAt or Camera -->
</NetworkLinkControl>

Descrizione

Controlla il comportamento dei file recuperati da <NetworkLink>.

Elementi specifici di NetworkLinkControl

<minRefreshPeriod>: Specificato in secondi, <minRefreshPeriod> è il tempo minimo consentito tra i recuperi del file. Questo parametro consente ai server di limitare i recuperi di un determinato file e di personalizzare le frequenze di aggiornamento in base alla frequenza di modifica prevista per i dati. Ad esempio, un utente potrebbe impostare un aggiornamento dei link su 5 secondi, ma potresti impostare un periodo minimo di aggiornamento di 3600 per limitare gli aggiornamenti a una volta ogni ora.
<maxSessionLength>: Specificato in secondi, <maxSessionLength> è il tempo massimo entro il quale il client NetworkLink può rimanere connesso. Il valore predefinito -1 indica di non terminare la sessione in modo esplicito.
<cookie>: Utilizza questo elemento per aggiungere una stringa alla query dell'URL al prossimo aggiornamento del link di rete. Puoi utilizzare questi dati nello script per fornire una gestione più intelligente lato server, tra cui l'esecuzione di query sulle versioni e la distribuzione condizionale dei file.
<message>: Puoi inviare un messaggio popup, ad esempio linee guida per l'utilizzo del link di rete. Il messaggio viene visualizzato quando il link di rete viene caricato per la prima volta in Google Earth o quando viene modificato nel controllo del link di rete.
<nomeLink>: Puoi controllare il nome del link di rete dal server, in modo che le modifiche apportate al nome lato client vengano sostituite dal server.
<linkDescription>: Puoi controllare la descrizione del link di rete dal server in modo che le modifiche apportate alla descrizione sul lato client vengano sostituite dal server.
<linkSnippet maxLines="2" >: Puoi controllare lo snippet del link di rete dal server, in modo che le modifiche apportate allo snippet sul lato client vengano sostituite dal server. <linkSnippet> ha un attributo maxLines, un numero intero che specifica il numero massimo di righe da visualizzare.
<scade>: Puoi specificare la data/l'ora in cui aggiornare il link. Questa specifica ha effetto solo se <updateMode> in <Link> ha un valore onExpire. Consulta la sezione <updateMode>
<Aggiorna>: Con <Update>, puoi specificare un numero qualsiasi di tag Modifica, Crea ed Elimina per un file .ZIP o un archivio .pdfs che sono stati caricati in precedenza con un link di rete. Consulta la sezione <Aggiorna>.
<AbstractView>

Esempio

<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLinkControl>
   <message>This is a pop-up message. You will only see this once</message>
   <cookie>cookie=sometext</cookie>
   <linkName>New KML features</linkName>
   <linkDescription><![CDATA[KML now has new features available!]]></linkDescription>
</NetworkLinkControl>
</kml>

Estende

È un elemento secondario diretto dell'elemento < attività >.

Contenuto da

<placeholder>

Vedi anche

<Aggiorna>
<Link di rete>

<Oggetto>

Sintassi

<!-- abstract element; do not create -->
<!-- Object id="ID" targetId="NCName" -->
<!-- /Object> -->

Descrizione

Questa è una classe di base astratta e non può essere utilizzata direttamente in un file KML. Fornisce l'attributo id, che consente l'identificazione univoca di un elemento KML, e l'attributo targetId, che viene utilizzato per fare riferimento agli oggetti che sono già stati caricati in Google Earth. L'attributo id deve essere assegnato se deve essere utilizzato il meccanismo <Update>.

<Overlay>

Sintassi

<!-- abstract element; do not create -->
<!-- Overlay id="ID" -->                    <!-- GroundOverlay,ScreenOverlay -->
  <!-- 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 Overlay -->
  <color>ffffffff</color>                   <!-- kml:color -->
  <drawOrder>0</drawOrder>                  <!-- int -->
  <Icon>
    <href>...</href>
  </Icon>
<!-- /Overlay -->

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. <Overlay> è il tipo di base per gli overlay immagine tracciati sulla superficie del pianeta o sullo schermo. <Icon> specifica l'immagine da utilizzare e può essere configurata per ricaricare le immagini in base a un timer o a modifiche della fotocamera. Questo elemento include anche le specifiche per l'ordine di sovrapposizione di più overlay e per aggiungere valori di colore e trasparenza all'immagine di base.

Elementi specifici per gli overlay

<colore>

I valori dei colori sono espressi in notazione esadecimale, compresi i valori di opacità (alpha). L'ordine delle espressioni è alfa, blu, verde, rosso (aabbggrr). L'intervallo di valori di qualsiasi colore è compreso tra 0 e 255 (da 00 a ff). per l'opacità, 00 è completamente trasparente e ff è completamente opaco). Ad esempio, se vuoi applicare un colore blu a un overlay con il 50% di opacità, devi specificare: <color>7fff0000</color>

Nota: l'elemento <geomColor> è stato ritirato. Usa <color>.

<drawOrder>

Questo elemento definisce l'ordine di sovrapposizione delle immagini negli overlay sovrapposti. Gli overlay con valori <drawOrder> più elevati vengono disegnati sopra gli overlay con valori <drawOrder> più bassi.

<Icona>

Definisce l'immagine associata all'overlay. L'elemento <href> definisce la posizione dell'immagine da utilizzare come overlay. La posizione può trovarsi su un file system locale o su un server web. Se questo elemento viene omesso o non contiene <href>, viene disegnato un rettangolo usando il colore e le dimensioni definiti dall'overlay del terreno o dello schermo.

<Icon>
   <href>icon.jpg</href>
</Icon>

Estende

<Funzionalità>

Estensione eseguita da

<Overlay del terreno>
<Overlay foto>
<Overlay schermo>

<FotoOverlay>

Sintassi

<PhotoOverlay>
  <!-- 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>
    <href>...</href>                    <!-- anyURI -->
    ...
  </Icon>

  <!-- specific to PhotoOverlay -->
  <rotation>0</rotation>                <!-- kml:angle180 -->
  <ViewVolume>
    <leftFov>0</leftFov>                <!-- kml:angle180 -->
    <rightFov>0</rightFov>              <!-- kml:angle180 -->
    <bottomFov>0</bottomFov>            <!-- kml:angle90 -->
    <topFov>0</topFov>                  <!-- kml:angle90 -->
    <near>0</near>                      <!-- double -->
  </ViewVolume>
  <ImagePyramid>
    <tileSize>256</tileSize>            <!-- int -->
    <maxWidth>...</maxWidth>            <!-- int -->
    <maxHeight>...</maxHeight>          <!-- int -->
    <gridOrigin>lowerLeft</gridOrigin> <!-- lowerLeft or upperLeft -->
  </ImagePyramid>
  <Point>
    <coordinates>...</coordinates>      <!-- lon,lat[,alt] -->
  </Point>
  <shape>rectangle</shape>               <!-- kml:shape -->
</PhotoOverlay>

Descrizione

L'elemento <FotoOverlay> ti consente di individuare geograficamente una fotografia sulla Terra e di specificare i parametri di visualizzazione per questa sovrapposizione di foto. Overlay foto può essere un semplice rettangolo 2D, un cilindro parziale o pieno oppure una sfera (per panoramiche sferiche). L'overlay viene posizionato nella posizione specificata e orientato verso il punto di vista.

Poiché <FotoOverlay> deriva da <Feature>, può contenere uno dei due elementi derivati da <AbstractView>, <Videocamera> o <LookAt>. La fotocamera (o LookAt) specifica un punto di vista e una direzione di visualizzazione (denominata anche vettore di vista). L'overlay foto viene posizionato in relazione al punto di vista. Nello specifico, il piano di un'immagine rettangolare 2D è ortogonale (ad angolo retto rispetto) al vettore di visualizzazione. La normalità di questo piano, ossia la parte anteriore, ovvero la parte con la foto, è orientata verso il punto di vista.

L'URL dell'immagine FotoOverlay è specificato nel tag <Icon>, che viene ereditato da <Overlay>. Il tag <Icon> deve contenere un elemento <href> che specifichi il file immagine da utilizzare per FotoOverlay. Nel caso di un'immagine molto grande, <href> è un URL speciale che viene indicizzato in una piramide di immagini con risoluzioni diverse (vedi ImagePyramid).

Per saperne di più, consulta la pagina "Argomenti in KML" su FotoOverlay.

Elementi specifici per Overlay foto

<rotazione>

Regola il modo in cui la foto viene posizionata all'interno del campo visivo. Questo elemento è utile se la foto è stata ruotata e si discosta leggermente da una visualizzazione orizzontale desiderata.

<ViewVolume>

Definisci la porzione visibile della scena corrente. La specifica del campo visivo è analoga a quella per l'apertura dell'obiettivo in una fotocamera fisica. Un piccolo campo visivo, come un teleobiettivo, si concentra su una piccola parte della scena. Un campo visivo ampio, ad esempio un grandangolo, si concentra su gran parte della scena.

<leftFov>: Angolo, in gradi, tra la direzione di visualizzazione della videocamera e il lato sinistro del volume della visualizzazione.
<rightFov>: Angolo in gradi tra la direzione di visualizzazione della videocamera e il lato destro del volume della visualizzazione.
<bottomFov>: Angolo, in gradi, tra la direzione di visualizzazione della videocamera e la parte inferiore del volume di visualizzazione.
<topFov>: Angolo in gradi tra la direzione di visualizzazione della videocamera e la parte superiore del volume di visualizzazione.
<vicino a>: Misurazione in metri lungo la direzione di visualizzazione dal punto di vista della fotocamera alla forma dell'overlay foto.

Il campo visivo di un overlay di foto è definito da quattro piani, ognuno dei quali è specificato da un angolo relativo al vettore vista. Questi quattro piani definiscono i lati superiore, inferiore, sinistro e destro del campo visivo, che hanno la forma di una piramide troncata, come mostrato qui:

I seguenti diagrammi mostrano i quattro angoli di campo visivo all'interno di questa piramide:

<Pyramid immagine>

Per le immagini di grandi dimensioni, dovrai costruire una piramide di immagini, che è un insieme gerarchico di immagini, ciascuna delle quali è una versione a risoluzione inferiore dell'immagine originale. Ciascuna immagine della piramide è suddivisa in riquadri, in modo che vengano caricate solo le parti visualizzate. Google Earth calcola il punto di vista corrente e carica i riquadri appropriati in base alla distanza dell'utente dall'immagine. Man mano che il punto di vista si avvicina al overlay di foto, Google Earth carica riquadri a risoluzione più elevata. Poiché non è possibile visualizzare contemporaneamente sullo schermo tutti i pixel dell'immagine originale, questa pre-elaborazione consente a Google Earth di ottenere le massime prestazioni perché carica solo le parti dell'immagine che sono visualizzate e solo i dettagli in pixel che possono essere distinguibili dall'utente nel punto di vista corrente.

Quando specifichi una piramide di immagini, devi anche modificare il <href> nell'elemento <Icon> per includere le specifiche per i riquadri da caricare.

<tileSize>: Dimensioni delle schede, in pixel. Le schede devono essere quadrate e <tileSize> deve essere una potenza di 2. È consigliabile utilizzare una dimensione 256 (valore predefinito) o 512. L'immagine originale è divisa in riquadri di queste dimensioni, a diverse risoluzioni.
<maxWidth>: Larghezza in pixel dell'immagine originale.
<maxHeight>: Altezza in pixel dell'immagine originale.
<gridOrigin>: Indica da dove iniziare la numerazione delle caselle in ogni livello della piramide. Un valore lowerLeft specifica che la riga 1, colonna 1 di ogni livello, si trova nell'angolo in basso a sinistra della griglia.

<punto>

L'elemento <Point> funge da <Point> all'interno di un elemento <Segnaposto>. Disegna un'icona per contrassegnare la posizione della sovrapposizione di foto. L'icona tracciata è specificata dai campi <styleUrl> e <StyleSelector>, proprio come per <Segnaposto>.

<forma>

L'overlay foto viene proiettato su <Shape>, che può essere uno dei seguenti:

rettangolare (predefinito): per una foto normale

cilindro: per le panoramiche, che possono essere parziali o complete.

Sphere: per i panorami sferici

Esempio

<PhotoOverlay>
  <!-- Feature elements -->
  <name>A simple non-pyramidal photo</name>
  <description>High above the ocean</description>
  <!-- Overlay elements -->
  <Icon>
  <!-- A simple normal jpeg image -->
  <href>small-photo.jpg</href>
  </Icon>
  <!-- PhotoOverlay elements -->
  <!-- default: <rotation> default is 0 -->
  <ViewVolume>
    <near>1000</near>
    <leftFov>-60</leftFov>
    <rightFov>60</rightFov>
    <bottomFov>-45</bottomFov>
    <topFov>45</topFov>
  </ViewVolume>
  <!-- if no ImagePyramid only level 0 is shown,
       fine for a non-pyramidal image -->
  <Point>
    <coordinates>1,1</coordinates>
  </Point>
  <!-- default: <shape> -->
</PhotoOverlay>

Estende

<Overlay>

Contenuto da

<Cartella>, <Documento> o <kb>

<Segnaposto>

Sintassi

<Placemark 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 Placemark element -->
  <Geometry>...</Geometry>
</Placemark>

Descrizione

Un segnaposto è una funzionalità con una geometria associata. In Google Earth, un segnaposto viene visualizzato come voce dell'elenco nel riquadro Luoghi. A un segnaposto con un punto è associata un'icona che contrassegna un punto sulla Terra nel visualizzatore 3D. Nel visualizzatore 3D di Google Earth un segnaposto del punto è l'unico oggetto su cui puoi fare clic o passare il mouse. Gli altri oggetti Geometry non hanno un'icona nel visualizzatore 3D. Per offrire all'utente qualcosa su cui fare clic nel visualizzatore 3D, devi creare un oggetto MultiGeometry contenente sia un punto sia l'altro oggetto Geometry.

Elementi specifici del segnaposto

0 o un elemento <Geometry>

Esempio

<Placemark>
  <name>Google Earth - New Placemark</name>
  <description>Some Descriptive text.</description>
  <LookAt>
    <longitude>-90.86879847669974</longitude>
    <latitude>48.25330383601299</latitude>
    <range>440.8</range>
    <tilt>8.3</tilt>
    <heading>2.7</heading>
  </LookAt>
  <Point>
    <coordinates>-90.86948943473118,48.25450093195546,0</coordinates>
  </Point>
</Placemark>

Estende

<Funzionalità>

Contenuto da

<Documento>
<Cartella>

Vedi anche

<Icona>

<Punto>

Sintassi

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

Descrizione

Una posizione geografica definita da longitudine, latitudine e altitudine (facoltativa). Quando un punto è contenuto da un segnaposto, il punto stesso determina la posizione del nome e dell'icona del segnaposto. Quando un punto viene estruso, è collegato al suolo tramite una linea. Questo "tether" utilizza l'attuale riga LineStyle.

Elementi specifici per il punto

<estrusione>

Valore booleano. Specifica se collegare il punto al suolo tramite una linea. Per estrudere un punto, il valore di <HEIGHTMode> deve essere relativeToGround, relativeToSeaFloor o assoluto. La punta viene estrusa verso il centro della sfera terrestre.

<altitudeMode>

Specifica come vengono interpretati i componenti di altitudine nell'elemento <Coordinas>. I valori possibili sono:

clampToGround (impostazione predefinita): indica di ignorare una specifica dell'altitudine (ad es. nel tag < coordinates>).
relativeToGround: imposta l'altitudine dell'elemento rispetto all'effettiva altitudine del suolo di una determinata posizione. Ad esempio, se l'altitudine del suolo di una località è esattamente al livello del mare e l'altitudine di un punto è impostata su 9 metri, questa modalità indica l'altitudine di un punto. Tuttavia, se la stessa coordinata è impostata su una posizione in cui l'altitudine del suolo è di 10 metri sul livello del mare, l'altitudine della coordinata è di 19 metri. Questa modalità è in genere consente di posizionare bastoncini per telefono o uno skilift.
assoluto: imposta l'altitudine delle coordinate rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sottostante. Ad esempio, se imposti l'altitudine di una coordinata su 10 metri in modalità di altitudine assoluta, l'icona di un segnaposto in linea apparirà a livello del suolo se anche il terreno sottostante si trova a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, il segnaposto viene visualizzato sopra il terreno di 7 metri. Un tipico utilizzo di questa modalità è per il posizionamento degli aerei.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'altitudine come valore in metri sul livello del mare. Se il punto si trova sopra il terreno anziché sul mare, l'altitudine sarà interpretata come se fosse sopra terra.
clampToSeaFloor: la specifica dell'altitudine viene ignorata e il punto verrà posizionato sul fondale marino. Se il punto di accesso si trova a terra anziché al mare, verrà posizionato a terra.

< coordinate>(obbligatorio)

Una sola tupla costituita da valori in virgola mobile per longitudine, latitudine e altitudine (in quest'ordine). I valori di longitudine e latitudine sono in gradi, dove:

longitudine ≥ -180 e <= 180
latitudine ≥ -90 e ≤ 90
I valori (facoltativo) sono visualizzati in metri sul livello del mare (facoltativo)

Non includere spazi tra i tre valori che descrivono una coordinata.

Esempio

<Point>
  <coordinates>-90.86948943473118,48.25450093195546</coordinates>
</Point>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<Segnaposto>

<Poligono>

Sintassi

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

Descrizione

Un poligono è definito da un confine esterno e da 0 o più confini interni. I confini, a loro volta, sono definiti da LinearRing. Quando un poligono viene estruso, i suoi confini sono collegati a terra per formare poligoni aggiuntivi che conferiscono l'aspetto di un edificio o di una casella. I poligoni estrusi utilizzano <PolyStyle> per colore, modalità di colore e riempimento.

Le <coordinate> per i poligoni devono essere specificate in ordine antiorario. I poligoni seguono la "regola del destro", che prevede che se posizioni le dita della mano destra nella direzione in cui sono specificate le coordinate, il tuo pollice punta nella direzione generale della normalità geometrica del poligono. Nelle grafiche 3D, la normalità geometrica viene utilizzata per l'illuminazione e punta il dito lontano dalla faccia anteriore del poligono. Poiché Google Earth riempie solo la parte anteriore dei poligoni, otterrai l'effetto desiderato solo quando le coordinate sono specificate nell'ordine corretto. In caso contrario, il poligono sarà in grigio.

Elementi specifici del poligono

<estrusione>

Valore booleano. Specifica se collegare il poligono a terra. Per estruire un poligono, la modalità altitudine deve essere relativeToGround, relativeToSeaFloor o assoluta. Solo i vertici sono estrusi, non la geometria stessa (ad esempio, un rettangolo si trasforma in una casella con cinque facce). I vertici del Poligono vengono estrusi verso il centro della sfera della Terra.

<tessellare>

Questo campo non è utilizzato da Poligono. Per consentire a un poligono di seguire il rilievo (ovvero per abilitare la definizione del tetto) specifica una modalità altitudine di clampToGround o clampToSeaFloor.

<altitudeMode>

Specifica come vengono interpretati i componenti di altitudine nell'elemento <Coordinas>. I valori possibili sono:

clampToGround (impostazione predefinita): indica di ignorare una specifica dell'altitudine (ad es. nel tag < coordinates>).
relativeToGround: imposta l'altitudine dell'elemento rispetto all'effettiva altitudine del suolo di una determinata posizione. Ad esempio, se l'altitudine del suolo di una località è esattamente al livello del mare e l'altitudine di un punto è impostata su 9 metri, questa modalità indica l'altitudine di un punto. Tuttavia, se la stessa coordinata è impostata su una posizione in cui l'altitudine del suolo è di 10 metri sul livello del mare, l'altitudine della coordinata è di 19 metri. Questa modalità è in genere consente di posizionare bastoncini per telefono o uno skilift.
assoluto: imposta l'altitudine delle coordinate rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sottostante. Ad esempio, se imposti l'altitudine di una coordinata su 10 metri in modalità di altitudine assoluta, l'icona di un segnaposto in linea apparirà a livello del suolo se anche il terreno sottostante si trova a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, il segnaposto viene visualizzato sopra il terreno di 7 metri. Un tipico utilizzo di questa modalità è per il posizionamento degli aerei.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'<altitudine> come valore in metri sul livello del mare. Se il punto si trova sopra il terreno anziché sul mare, l'altitudine sarà interpretata come se fosse sopra terra.
clampToSeaFloor: la specifica dell'altitudine viene ignorata e il punto verrà posizionato sul fondale marino. Se il punto di accesso si trova a terra anziché al mare, verrà posizionato a terra.

<outerBoundaryIs>(obbligatorio)

Contiene un elemento <LinearRing>.

<innerBoundaryI>

Contiene un elemento <LinearRing>. Un poligono può contenere più elementi <innerBoundaryIs> che creano più ritagli all'interno del poligono.

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>Polygon.kml</name>
  <open>0</open>
  <Placemark>
    <name>hollow box</name>
    <Polygon>
      <extrude>1</extrude>
      <altitudeMode>relativeToGround</altitudeMode>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.366278,37.818844,30
            -122.365248,37.819267,30
            -122.365640,37.819861,30
            -122.366669,37.819429,30
            -122.366278,37.818844,30
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
      <innerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.366212,37.818977,30
            -122.365424,37.819294,30
            -122.365704,37.819731,30
            -122.366488,37.819402,30
            -122.366212,37.818977,30
          </coordinates>
        </LinearRing>
      </innerBoundaryIs>
    </Polygon>
  </Placemark>
</Document>
</kml>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<Segnaposto>

<PolyStyle>

Sintassi

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

  <!-- specific to PolyStyle -->
  <fill>1</fill>                     <!-- boolean -->
  <outline>1</outline>               <!-- boolean -->
</PolyStyle>

Descrizione

Specifica lo stile di disegno per tutti i poligoni, comprese le estrusioni di poligoni (che assomigliano alle pareti degli edifici) e gli estrusioni di linee (che assomigliano a recinti solidi).

Elementi specifici di PolyStyle

<riempi>: Valore booleano. Specifica se riempire il poligono.
<outline>: Valore booleano. Specifica se delineare il poligono. I contorni poligonali utilizzano lo stile LineStyle corrente.

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>PolygonStyle.kml</name>
  <open>1</open>
  <Style id="examplePolyStyle">
    <PolyStyle>
      <color>ff0000cc</color>
      <colorMode>random</colorMode>
    </PolyStyle>
  </Style>
  <Placemark>
    <name>hollow box</name>
    <styleUrl>#examplePolyStyle</styleUrl>
    <Polygon>
      <extrude>1</extrude>
      <altitudeMode>relativeToGround</altitudeMode>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.3662784465226,37.81884427772081,30
            -122.3652480684771,37.81926777010555,30
            -122.365640222455,37.81986126286519,30
            -122.36666937925,37.81942987753481,30
            -122.3662784465226,37.81884427772081,30
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
      <innerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.366212593918,37.81897719083808,30
            -122.3654241733188,37.81929450992014,30
            -122.3657048517827,37.81973175302663,30
            -122.3664882465854,37.81940249291773,30
            -122.366212593918,37.81897719083808,30
          </coordinates>
        </LinearRing>
      </innerBoundaryIs>
    </Polygon>
  </Placemark>
</Document>
</kml>

Estende

<ColoreStile>

Contenuto da

<Stile>

<Regione>

Sintassi

<Region id="ID"> 
  <LatLonAltBox>
    <north></north>                            <!-- required; kml:angle90 -->
    <south></south>                            <!-- required; kml:angle90 -->
    <east></east>                              <!-- required; kml:angle180 -->
    <west></west>                              <!-- required; kml:angle180 -->
    <minAltitude>0</minAltitude>               <!-- float -->
    <maxAltitude>0</maxAltitude>               <!-- float -->
    <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  </LatLonAltBox>
  <Lod>
    <minLodPixels>0</minLodPixels>             <!-- float -->
    <maxLodPixels>-1</maxLodPixels>            <!-- float -->
    <minFadeExtent>0</minFadeExtent>           <!-- float -->
    <maxFadeExtent>0</maxFadeExtent>           <!-- float -->
  </Lod>
</Region>

Descrizione

Una regione contiene un riquadro di delimitazione (<LatLonAltBox>) che descrive un'area di interesse definita da coordinate geografiche e altitudini. Inoltre, una regione contiene un'estensione del livello di dettaglio (<Lod>) che definisce un intervallo di validità della regione associata in termini di dimensioni dello schermo previste. Si dice che una regione è "attiva" quando il riquadro di delimitazione è all'interno della visualizzazione dell'utente e vengono soddisfatti i requisiti del LOD. Gli oggetti associati a un'area geografica vengono disegnati solo quando quest'ultima è attiva. Quando <viewRefreshMode> è onRegion, il link o l'icona viene caricato solo quando la regione è attiva. Per maggiori dettagli, consulta la pagina "Argomenti in KML" in Regioni. In una gerarchia Container o NetworkLink, questo calcolo utilizza l'area geografica più vicina nella gerarchia.

Elementi specifici per la regione

<LatLonAltBox>(obbligatorio)

Un riquadro di delimitazione che descrive un'area di interesse definita da coordinate geografiche e altitudini. I valori predefiniti e i campi obbligatori sono i seguenti:

<HEIGHTMode> o <gx:HEIGHTMode>: I valori possibili per <HEIGHTMode> sono clampToGround, relativeToGround e assoluto. I valori possibili per <gx:HEIGHTMode> sono clampToSeaFloor e relativeToSeaFloor. Vedi anche <LatLonBox>.
<minAltitudine>: Specificato in metri (e influisce sulle specifiche della modalità altitudine).
<maxAltitude>: Specificato in metri (e influisce sulle specifiche della modalità altitudine).
<north> (obbligatorio): Specifica la latitudine del bordo nord del riquadro di delimitazione, in gradi decimali da 0 a ±90.
<south> (obbligatorio): Specifica la latitudine del bordo sud del riquadro di delimitazione, in gradi decimali da 0 a ±90.
<east> (obbligatorio)
: Specifica la longitudine del bordo est del riquadro di delimitazione, in gradi decimali da 0 a ±180.
<west> (obbligatorio): Specifica la longitudine del bordo ovest del riquadro di delimitazione, in gradi decimali da 0 a ± 180.

<LatLonAltBox>
  <north>43.374</north>
  <south>42.983</south>
  <east>-0.335</east>
  <west>-1.423</west>
  <minAltitude>0</minAltitude>
  <maxAltitude>0</maxAltitude>
</LatLonAltBox>

<Lod>

Lod è un'abbreviazione di Livello di dettaglio. <Lod> indica le dimensioni della regione proiettata sullo schermo che è necessario affinché la regione venga considerata "attiva". Specifica anche le dimensioni della rampa di pixel utilizzata per la dissolvenza in entrata (da trasparente a opaco) e di dissolvenza in uscita (da opaco a trasparente). Vedi il seguente diagramma per una rappresentazione visiva di questi parametri.

<Lod>
  <minLodPixels>256</minLodPixels>
  <maxLodPixels>-1</maxLodPixels>
  <minFadeExtent>0</minFadeExtent>
  <maxFadeExtent>0</maxFadeExtent>
</Lod>

<minLodPixels> (obbligatorio)

Definisce un quadrato nello spazio dello schermo, con i lati del valore specificato in pixel. Ad esempio, 128 definisce un quadrato di 128 x 128 pixel. Il riquadro di delimitazione della regione deve essere più grande di questo quadrato (e più piccolo del quadrato maxLodPixels) affinché la regione sia attiva.

Ulteriori dettagli sono disponibili nel capitolo Utilizzo delle regioni della Guida per gli sviluppatori, nonché nel tutorial Come evitare il sovraccarico con le regioni della documentazione di Google Earth per il Sociale.

<maxLodPixels>

Misurazione in pixel dello schermo che rappresenta il limite massimo dell'intervallo di visibilità per una determinata area geografica. Il valore predefinito -1 indica "da attivo a dimensione infinita".

<minFadeExtent>

Distanza in cui la geometrica sfuma, da completamente opaca a completamente trasparente. Questo valore di rampa, espresso in pixel dello schermo, viene applicato all'estremità minima dei limiti di LOD (visibilità).

<maxFadeExtent>

Distanza in cui la geometria sfuma gradualmente, da completamente trasparente a completamente opaca. Il valore di questa soglia, espresso in pixel di schermo, viene applicato al limite massimo dei limiti di visibilità (LOD).

Nel diagramma seguente, se P=la dimensione dei pixel prevista, i numeri cerchiati indicano quanto segue:

if (P < minLodPixels)
  opacity=0                                 //#1 in diagram
else if(P < minLodPixels + minFadeExtent)
  opacity=(P - minLodPixels)/minFadeExtent  //#2 in diagram
else if (P < maxLodPixels - maxFadeExtent)
  opacity=1                                 //#3 in diagram
else if (P < maxLodPixels)
  opacity=(maxLodPixels-P)/maxFadeExtent    //#4 in diagram
else
  opacity=0                                 //#5 in diagram

Esempio di <Region>

<Region>
  <LatLonAltBox>
    <north>50.625</north>
    <south>45</south>
    <east>28.125</east>
    <west>22.5</west>
    <minAltitude>10</minAltitude>
    <maxAltitude>50</maxAltitude>
  </LatLonAltBox>
  <Lod>
    <minLodPixels>128</minLodPixels>
    <maxLodPixels>1024</maxLodPixels>
    <minFadeExtent>128</minFadeExtent>
    <maxFadeExtent>128</maxFadeExtent>
  </Lod>
</Region>

Estende

<Oggetto>

Contenuto da

Qualsiasi elemento derivato da <Funzionalità>

<Schema>

Sintassi

<Schema name="string" id="ID">
  <SimpleField type="string" name="string">
    <displayName>...</displayName>            <!-- string -->
  </SimpleField>
</Schema>

Descrizione

Specifica uno schema KML personalizzato utilizzato per aggiungere dati personalizzati alle funzionalità KML. L'attributo "id" è obbligatorio e deve essere univoco all'interno del file KML. <Schema> è sempre un elemento secondario di <Documento>.

Elementi specifici dello schema

Un elemento di schema contiene uno o più elementi SimpleField. Nel campo SimpleField, lo schema dichiara il tipo e il nome del campo personalizzato. Specifica facoltativamente un displayName (il modulo facile da usare, con spazi e punteggiatura corretta per la visualizzazione in Google Earth) per questo campo personalizzato.

<SimpleField type="string" name="string">

La dichiarazione del campo personalizzato, che deve specificare sia il tipo sia il nome di questo campo. Se il valore type o name viene omesso, il campo viene ignorato. Il tipo può essere uno dei seguenti:

string
int
suggerimento
video breve
breve
numero in virgola mobile
double
bool

<nomedisplay>: Il nome eventualmente utilizzato da utilizzare quando il nome del campo viene mostrato all'utente di Google Earth. Utilizza l'elemento [CDATA] per l'escape del markup HTML standard.

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <Schema name="TrailHeadType" id="TrailHeadTypeId">
    <SimpleField type="string" name="TrailHeadName">
      <displayName><![CDATA[<b>Trail Head Name</b>]]></displayName>
    </SimpleField>
    <SimpleField type="double" name="TrailLength">
      <displayName><![CDATA[<i>The length in miles</i>]]></displayName>
    </SimpleField>
    <SimpleField type="int" name="ElevationGain">
      <displayName><![CDATA[<i>change in altitude</i>]]></displayName>
    </SimpleField>
  </Schema> 
</Document>
</kml>

Estende

Questo è un elemento principale.

Contenuto da

<Documento>

Vedi anche

<SchemaDati>

<Overlay schermo>

Sintassi

<ScreenOverlay 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 ScreenOverlay -->
  <overlayXY x="double" y="double" xunits="fraction" yunits="fraction"/>
    <!-- vec2 -->
    <!-- xunits and yunits can be one of: fraction, pixels, or insetPixels -->
  <screenXY x="double" y="double" xunits="fraction" yunits="fraction"/>
    <!-- vec2 -->
  <rotationXY x="double" y="double" xunits="fraction" yunits"fraction"/>
    <!-- vec2 -->
  <size x="double" y="double" xunits="fraction" yunits="fraction"/>
    <!-- vec2 -->
  <rotation>0</rotation>                   <!-- float -->
 </ScreenOverlay>

Descrizione

Questo elemento disegna un overlay immagine fisso sullo schermo. Gli utilizzi di esempio per gli overlay schermo sono bussola, loghi e avvisi. Il dimensionamento dell'overlay schermo è determinato dall'elemento <size>. Il posizionamento dell'overlay viene gestito mappando un punto nell'immagine specificato da <overlayXY> a un punto dello schermo specificato da <screenXY>. Quindi l'immagine viene ruotata di <rotation> gradi rispetto a un punto rispetto alla schermata specificata da <rotationXY>.

L'elemento secondario <href> di <Icon> specifica l'immagine da utilizzare come overlay. Il file può trovarsi su un file system locale o su un server web. Se questo elemento viene omesso o non contiene <href>, viene disegnato un rettangolo usando il colore e la dimensione definiti dall'overlay dello schermo.

Elementi specifici per overlay schermo

<overlayXY>

Specifica un punto sull'immagine overlay (o fuori da) mappata sulla coordinata dello schermo (<screenXY>). Richiede i valori x e y e le unità per questi valori.

I valori x e y possono essere specificati in tre modi diversi: come pixel ("pixels"), come frazioni dell'immagine ("fraction") o come pixel incorporati ("insetPixels"), che è un offset in pixel dall'angolo in alto a destra dell'immagine. Le posizioni x e y possono essere specificate in diversi modi, ad esempio x può essere in pixel e y può essere una frazione. L'origine del sistema di coordinate si trova nell'angolo in basso a sinistra dell'immagine.

x: il numero di pixel, un componente frazionario dell'immagine o un pixel inserito, che indica il componente x di un punto sull'immagine overlay.
y: il numero di pixel, un componente frazionario dell'immagine o un pixel inserito, che indica il componente y di un punto sull'immagine overlay.
xunits: le unità in cui è specificato il valore x. Un valore "fraction" indica che il valore x è una frazione dell'immagine. Un valore pari a "pixels" indica il valore x in pixel. Il valore "insetPixels" indica il rientro dal bordo destro dell'immagine.
yunits: le unità in cui è specificato il valore y. Un valore "fraction" indica che il valore y è una frazione dell'immagine. Un valore pari a "pixels" indica il valore y in pixel. Il valore "insetPixels" indica il rientro dal bordo superiore dell'immagine.

<screenXY>

Specifica un punto in relazione all'origine dello schermo a cui è mappata l'immagine di overlay. I valori x e y possono essere specificati in tre modi diversi: come pixel ("pixels"), come frazioni dello schermo ("fraction") o come pixel incorporati ("insetPixels"), che è un offset in pixel dall'angolo in alto a destra dello schermo. Le posizioni x e y possono essere specificate in diversi modi, ad esempio x può essere in pixel e y può essere una frazione. L'origine del sistema di coordinate si trova nell'angolo in basso a sinistra dello schermo.

x: il numero di pixel, un componente frazionario dello schermo o un riquadro pixel che indica il componente x di un punto sullo schermo.
y: il numero di pixel, un componente frazionario dello schermo o un riquadro pixel che indica il componente y di un punto sullo schermo.
xunits: le unità in cui è specificato il valore x. Un valore pari a "fraction" indica che il valore x è una frazione della schermata. Un valore pari a "pixels" indica il valore x in pixel. Il valore "insetPixels" indica il rientro dal bordo destro dello schermo.
yunits: le unità in cui è specificato il valore y. Un valore di fraction indica che il valore y è una frazione della schermata. Un valore pari a "pixels" indica il valore y in pixel. Il valore "insetPixels" indica il rientro dal bordo superiore dello schermo.

Ad esempio, <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> indica un punto al centro dello schermo.

Ecco alcuni esempi:

Centra l'immagine:

<ScreenOverlay>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

Posiziona l'immagine in alto a sinistra:

<ScreenOverlay>
  <overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="0" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

Posiziona l'immagine a destra dello schermo:

<ScreenOverlay>
  <overlayXY x="1" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="1" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

<rotazioneXY>

Punta rispetto allo schermo su cui viene ruotato l'overlay dello schermo.

<size>

Specifica le dimensioni dell'immagine per l'overlay dello schermo, come segue:

Un valore -1 indica di utilizzare la dimensione nativa
Un valore pari a 0 indica che verranno mantenute le proporzioni
Un valore di n imposta il valore della dimensione

Ad esempio:

Per forzare l'immagine a mantenere le dimensioni x e y originali, imposta i valori su -1:

<size x="-1" y="-1" xunits="fraction" yunits="fraction"/>

Per forzare l'immagine a mantenere la sua dimensione orizzontale, ma occupare il 20% dello spazio verticale dello schermo:

<size x="-1" y="0.2" xunits="fraction" yunits="fraction"/>

Per forzare il ridimensionamento dell'immagine a 100 x 500 px:

<size x="100" y="500" xunits="pixels" yunits="pixels"/>

<rotazione>

Indica l'angolo di rotazione dell'oggetto padre. Il valore 0 indica nessuna rotazione. Il valore è un angolo in gradi in senso antiorario che inizia dal nord. Utilizza ±180 per indicare la rotazione dell'oggetto padre da 0. Il centro di <rotation>, se non (.5,.5), è specificato in <rotationXY>.

Esempio

L'esempio riportato di seguito posiziona un'immagine al centro esatto dello schermo, utilizzando le dimensioni, l'altezza e le proporzioni originali dell'immagine.

<ScreenOverlay id="khScreenOverlay756">
  <name>Simple crosshairs</name>
  <description>This screen overlay uses fractional positioning
   to put the image in the exact center of the screen</description>
  <Icon>
    <href>http://myserver/myimage.jpg</href>
  </Icon>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <rotation>39.37878630116985</rotation>
  <size x="0" y="0" xunits="pixels" yunits="pixels"/>
</ScreenOverlay>

Estende

<Funzionalità>
<Overlay>

Contenuto da

<Documento>
<Cartella>

<Stile>

Sintassi

<Style id="ID">
<!-- extends StyleSelector -->

<!-- specific to Style -->
  <IconStyle>...</IconStyle>
  <LabelStyle>...</LabelStyle>
  <LineStyle>...</LineStyle>
  <PolyStyle>...</PolyStyle>
  <BalloonStyle>...</BalloonStyle>
  <ListStyle>...</ListStyle>
</Style>

Descrizione

Uno stile definisce un gruppo di stili indirizzabile a cui possono fare riferimento gli stili e le funzionalità. Gli stili influiscono sul modo in cui la Geometria viene presentata nel visualizzatore 3D e il modo in cui le funzionalità vengono visualizzate nel riquadro Luoghi della visualizzazione Elenco. Gli stili condivisi vengono raccolti in un <documento> e devono avere un id definito, in modo che possano essere utilizzati come riferimento dalle singole funzionalità che li utilizzano.

Utilizza un id per fare riferimento allo stile utilizzando <styleUrl>.

Esempio

<Document>
  <!-- Begin Style Definitions -->
  <Style id="myDefaultStyles">
    <IconStyle>
      <color>a1ff00ff</color>
      <scale>1.399999976158142</scale>
      <Icon>
        <href>http://myserver.com/icon.jpg</href>
      </Icon>
    </IconStyle>
    <LabelStyle>
      <color>7fffaaff</color>
      <scale>1.5</scale>
    </LabelStyle>
    <LineStyle>
      <color>ff0000ff</color>
      <width>15</width>
    </LineStyle>
    <PolyStyle>
      <color>7f7faaaa</color>
      <colorMode>random</colorMode>
    </PolyStyle>
  </Style>
  <!-- End Style Definitions -->
  <!-- Placemark #1 -->
  <Placemark>
    <name>Google Earth - New Polygon</name>
    <description>Here is some descriptive text</description>
    <styleUrl>#myDefaultStyles</styleUrl>
    . . .
  </Placemark>
  <!-- Placemark #2 -->
  <Placemark>
    <name>Google Earth - New Path</name>
    <styleUrl>#myDefaultStyles</styleUrl>
      . . . .
  </Placemark>
</Document>
</kml>

Estende

<Selettore della selezione>

Contenuto da

qualsiasi <funzionalità>

Elementi specifici per lo stile

<Stile fumetto>
<IconaStile>
<LabelStyle>
<LineStyle>
<ListStyle>.
<PolyStyle>

<StyleMap>

Sintassi

<StyleMap id="ID">
  <!-- extends StyleSelector -->
  <!-- elements specific to StyleMap -->
  <Pair id="ID">
    <key>normal</key>              <!-- kml:styleStateEnum:  normal or highlight -->
    <styleUrl>...</styleUrl> or <Style>...</Style>
  </Pair>
</StyleMap>

Descrizione

Una mappa <StyleMap> viene mappata tra due stili diversi. In genere un elemento <StyleMap> viene utilizzato per fornire stili separati normali ed evidenziati per un segnaposto, in modo che la versione evidenziata venga visualizzata quando l'utente passa il mouse sopra l'icona in Google Earth.

Elementi specifici di StyleMap

<Pair>(obbligatorio)

Definisce una coppia chiave-valore che mappa una modalità (normale o highlight) all'elemento <styleUrl> predefinito. <pair> contiene due elementi (entrambi obbligatori):

<key>, che identifica la chiave
<styleUrl> o <Style>, che fa riferimento allo stile. In <styleUrl>, per gli elementi di stile di riferimento locali rispetto al documento KML viene utilizzato un # riferimento semplice. Per gli stili contenuti in file esterni, utilizza un URL completo insieme a # riferimento. Ad esempio:

<Pair> 
  <key>normal</key>
  <styleUrl>http://myserver.com/populationProject.xml#example_style_off</styleUrl>
</Pair>

Esempio

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>StyleMap.kml</name>
  <open>1</open>
  <Style id="normalState">
    <IconStyle>
      <scale>1.0</scale>
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pal3/icon55.png</href>
      </Icon>
    </IconStyle>
    <LabelStyle>
      <scale>1.0</scale>
    </LabelStyle>
  </Style>
  <Style id="highlightState">
    <IconStyle>
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pal3/icon60.png</href>
      </Icon>
      <scale>1.1</scale>
    </IconStyle>
    <LabelStyle>
      <scale>1.1</scale>
      <color>ff0000c0</color>
    </LabelStyle>
  </Style>
  <StyleMap id="styleMapExample">
    <Pair>
      <key>normal</key>
      <styleUrl>#normalState</styleUrl>
    </Pair>
    <Pair>
      <key>highlight</key>
      <styleUrl>#highlightState</styleUrl>
    </Pair>
  </StyleMap>
  <Placemark>
    <name>StyleMap example</name>
    <styleUrl>#styleMapExample</styleUrl>
    <Point>
      <coordinates>-122.368987,37.817634,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

Estende

<Selettore della selezione>

Contenuto da

qualsiasi <funzionalità>

<StyleSelector>

Sintassi

<!-- abstract element; do not create -->
<!-- StyleSelector id="ID" -->                 <!-- Style,StyleMap -->
<!-- /StyleSelector -->

Description (Descrizione)

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. È il tipo di base per gli elementi <Style> e <StyleMap>. L'elemento StyleMap seleziona uno stile in base alla modalità corrente del segnaposto. Un elemento derivato da StyleSelector è identificato in modo univoco dal suo id e dal suo url.

Elementi specifici di StyleSelector

Questo elemento astratto non contiene elementi secondari.

Estende

<Oggetto>

Estensione eseguita da

<Stile>
<StyleMap>

<TimePrimitive>

Sintassi

<!-- abstract element; do not create -->
<!-- TimePrimitive id="ID" -->            <!-- TimeSpan,TimeStamp -->
  <!-- extends Object -->
<!-- /TimePrimitive -->

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Questo elemento è esteso dagli elementi <TimeSpan> e <TimeStamp>.

Estende

<Oggetto>

Estensione eseguita da

<TimeSpan>
<TimeStamp>

<TimeSpan>

Sintassi

<TimeSpan id="ID">
  <begin>...</begin>     <!-- kml:dateTime -->
  <end>...</end>         <!-- kml:dateTime -->
</TimeSpan>

Descrizione

Rappresenta un'estensione nel tempo delimitata da dateTimes di inizio e fine.

Se il valore di <begin> oppure <end> non è presente, significa che la fine del ciclo non è limitata (vedi Esempio di seguito).

Il campo dateTime viene definito in base al tempo schema XML (consulta la parte 2 dello schema XML: Datatypes Second Edition). Il valore può essere espresso come aaaa-mm-ggThh:mm:ss.ssszzzzzz, dove T è il separatore tra la data e l'ora e il fuso orario è Z (per UTC) o zzzzzz, che rappresenta ±hh:mm in relazione a UTC. Inoltre, il valore può essere espresso solo come data. Consulta <TimeStamp> per gli esempi.

Elementi specifici di TimeSpan

<inizio>: Descrive l'istante iniziale di un periodo di tempo. Se assente, l'inizio del ciclo non è limitato.
<end>: Descrive l'istante finale di un periodo di tempo. Se assente, la fine del ciclo non ha limiti.

Esempio

L'esempio seguente mostra il periodo che rappresenta la statualità del Colorado. Contiene solo un tag <begin> perché il Colorado è diventato uno stato il 1° agosto 1876 e continua a esserlo:

<Placemark>
  <name>Colorado</name>
  .
  .
  .
  <TimeSpan>
    <begin>1876-08-01</begin>
  </TimeSpan>
</Placemark>

Estende

<TimePrimitive>

Contenuto da

Qualsiasi elemento derivato da <Funzionalità>

<TimeStamp>

Sintassi

<TimeStamp id="ID">
  <when>...</when>      <!-- kml:dateTime -->
</TimeStamp>

Descrizione

Rappresenta un momento specifico. Si tratta di un elemento semplice e non contiene elementi secondari. Il suo valore è dateTime, specificato nell'ora XML (consulta la parte 2 dello schema XML: Datatypes Second Edition). La precisione di TimeStamp è determinata dal valore dateTime nell'elemento <when>.

Elementi specifici per TimeStamp

<quando>

Specifica un solo momento specifico. Il valore è un valore dateTime, che può essere uno dei seguenti:

dateTime fornisce una seconda risoluzione
date offre risoluzione giornaliera
gYearMonth dà una risoluzione mensile
gYear offre una risoluzione per l'anno

I seguenti esempi mostrano risoluzioni diverse per il valore <when>:

gYear (AAAA)

<TimeStamp>
  <when>1997</when>
</TimeStamp>

gYearMonth (AAAA-MM)

<TimeStamp>
  <when>1997-07</when>
</TimeStamp>

date (AAAA-MM-GG)

<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp>

dateTime (AAAA-MM-GGThh:mm:ssZ)
Qui, T è il separatore tra il calendario e la notazione oraria e Z indica UTC. I secondi sono obbligatori.

<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>

dateTime (AAAA-MM-GGThh:mm:sszzzzzz)
Questo esempio fornisce l'ora locale e poi la conversione ± in UTC.

<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

Estende

<TimePrimitive>

Contenuto da

Tutti gli elementi che estendono <Feature>

<gx:TimeSpan> e <gx:TimeStamp>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Una copia degli elementi <TimeSpan> e <TimeStamp> nello spazio dei nomi delle estensioni. Ciò consente l'inclusione di valori temporali in AbstractViews (<Camera> e <LookAt>). I valori temporali vengono utilizzati per controllare le immagini storiche, la luce del sole e la visibilità delle funzionalità con timestamp.

Esempio

<?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>Views with Time</name>
    <open>1</open>
    <description>
      In Google Earth, enable historical imagery and sunlight,
      then click on each placemark to fly to that point in time.
    </description>

    <Placemark>
      <name>Sutro Baths in 1946</name>
      <Camera>
        <gx:TimeStamp>
          <when>1946-07-29T05:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.518172</longitude>
        <latitude>37.778036</latitude>
        <altitude>221.0</altitude>
        <heading>70.0</heading>
        <tilt>75.0</tilt>
      </Camera>
    </Placemark>

    <Placemark>
      <name>Palace of Fine Arts in 2002</name>
      <Camera>
        <gx:TimeStamp>
          <when>2002-07-09T19:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.444633</longitude>
        <latitude>37.801899</latitude>
        <altitude>139.629438</altitude>
        <heading>-70.0</heading>
        <tilt>75</tilt>
      </Camera>
    </Placemark>

  </Document>
</kml>

<gx:Tour>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

<gx:Tour id="ID">
  <name>...</name>
  <description>...</description>
  <gx:Playlist>

    <!-- any number of gx:TourPrimitive elements -->

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

Descrizione

<gx:Tour> può contenere un singolo elemento <gx:Playlist>, che a sua volta contiene un elenco ordinato di elementi gx:TourPrimitive che definiscono un tour in qualsiasi browser KML. Scopri di più sui tour.

Esempio

Puoi trovare numerosi esempi di tour nel capitolo Tour della Guida per gli sviluppatori KML.

Contiene

gx:Playlist: contiene un numero qualsiasi di elementi gx:TourPrimitive. Un elemento <gx:Tour> può contenere zero o uno <gx:Playlist>.

<gx:Tour>
  <gx:Playlist>
    <!-- gx:TourPrimitive -->
      ...
    <!-- /gx:TourPrimitive -->

    <!--- Any number of gx:TourPrimitive elements can be included --->
  </gx:Playlist>
</gx:Tour>

<gx:TourPrimitive>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.0 e versioni successive. Scopri di più

Sintassi

<gx:Tour>
  <gx:Playlist>

    <!-- abstract element; do not create -->
    <!-- gx:TourPrimitive -->    <!-- gx:AnimatedUpdate, gx:FlyTo, gx:TourControl, gx:SoundCue, gx:Wait -->
        <!-- extends Object -->
    <!-- /gx:TourPrimitive -->

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

Descrizione

Si tratta di un elemento astratto e non può essere utilizzato direttamente in un file KML. Questo elemento è esteso dagli elementi <gx:FlyTo>, <gx:AnimatedUpdate>, <gx:TourControl>, <gx:Wait> e <gx:SoundCue>.

Gli elementi estesi da gx:TourPrimitive forniscono istruzioni ai browser KML durante i tour, inclusi i punti di partenza e la durata dei voli, le pause, gli aggiornamenti alle funzionalità KML e i file audio da riprodurre.

Questi elementi devono essere contenuti all'interno di un elemento <gx:Playlist>, che a sua volta è contenuto in un elemento <gx:Tour>.

Esempio

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

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

    <Style>
      <IconStyle id="iconstyle">
        <scale>1.0</scale>
      </IconStyle>
    </Style>

    <Placemark id="mountainpin1">
      <name>New Zealand's Southern Alps</name>
      <styleUrl>#style</styleUrl>
      <Point>
        <coordinates>170.144,-43.605,0</coordinates>
      </Point>
    </Placemark>

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

        <!-- The order and duration of TourPrimitives is important;
             in this example, the AnimatedUpdate needs
             6.5 seconds to complete. The FlyTo provides 4.1,
             and the Wait 2.4, giving the update time to
             complete before the Tour ends. AnimatedUpdates
             don't hold Tours open, but FlyTos and Waits do.

             For more information, refer to:
             http://developers.google.com/kml/documentation/touring#tourtimelines
        -->

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

        <gx:FlyTo>
          <gx:duration>4.1</gx:duration>
          <Camera>
            <longitude>170.157</longitude>
            <latitude>-43.671</latitude>
            <altitude>9700</altitude>
            <heading>-6.333</heading>
            <tilt>33.5</tilt>
            <roll>0</roll>
          </Camera>
        </gx:FlyTo>

        <gx:Wait>
          <gx:duration>2.4</gx:duration>  <!-- waiting for the AnimatedUpdate to complete -->
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>
  </Document>
</kml>

Contenuto

<gx:Playlist>

Esteso da

<gx:Aggiornamento animato>
<gx:FlyTo>
<gx:SoundCue>
```
<gx:SoundCue id="ID">
  <href>http://www.example.com/audio/trumpets.mp3</href>   
  <gx:delayedStart>0</gx:delayedStart>                     
</gx:SoundCue>
```
Contiene un elemento <href> che specifica un file audio da riprodurre, in formato MP3, M4A o AAC. Non contiene una durata. Il file audio viene riprodotto in parallelo al resto del tour, quindi la primitiva del tour viene eseguita subito dopo aver raggiunto la primitiva <gx:SoundCue>. Se un altro file audio viene ignorato prima della fine della riproduzione del primo, i file vengono misti. L'elemento <gx:delayedStart> specifica il ritardo dell'inizio dell'audio per un determinato numero di secondi prima di riprodurre il file.
<gx:TourControl>
```
<gx:TourControl id="ID">
  <gx:playMode>pause</gx:playMode>    
</gx:TourControl>
```
Contiene un singolo elemento <gx:playMode>, che consente di mettere in pausa il tour finché un utente non interviene per continuare con il tour.
<gx:Wait>
```
<gx:Wait id="ID">
  <gx:duration>0.0</gx:duration>    
</gx:Wait>
```
La fotocamera rimane ferma, in corrispondenza dell'ultima definizione gx:AbstractView, per il numero di secondi specificato prima della riproduzione del successivo gx:TourPrimitive. Tieni presente che l'attesa non mette in pausa la sequenza temporale del tour: i file audio attualmente in riproduzione e gli aggiornamenti animati continueranno a essere riprodotti mentre la videocamera è in attesa.

Estende

<Oggetto>

<gx:Traccia>

Questo elemento è un'estensione dello standard OGC KML 2.2 ed è supportato in Google Earth 5.2 e versioni successive. Scopri di più

Sintassi

<gx:Track id="ID">
  <!-- specific to Track -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <when>...</when>                         <!-- kml:dateTime -->
  <gx:coord>...</gx:coord>                 <!-- string -->
  <gx:angles>...</gx:angles>               <!-- string -->
  <Model>...</Model>
  <ExtendedData>
    <SchemaData schemaUrl="anyURI">
      <gx:SimpleArrayData kml:name="string">
        <gx:value>...</gx:value>            <!-- string -->
      </gx:SimpleArrayData>
    <SchemaData>
  </ExtendedData>
</gx:Track>

Descrizione

Una traccia descrive il modo in cui un oggetto si muove nel mondo in un determinato periodo di tempo. Questa funzionalità ti consente di creare un oggetto visibile in Google Earth (un'icona punto o un modello) che codifica più posizioni per lo stesso oggetto più volte. In Google Earth, il dispositivo di scorrimento temporale consente all'utente di spostare la visualizzazione nel tempo, animando la posizione dell'oggetto.

Un elemento gx:MultiTrack viene utilizzato per raccogliere più tracce in un'unità concettuale con un'icona (o un modello) associata che si muove lungo il percorso. Questa funzionalità è utile se hai più tracce per lo stesso oggetto reale. L'elemento booleano <gx:interpolate> di una variabile <gx:MultiTrack> specifica se interpolare tra le tracce di una traccia multipla. Se questo valore è 0, il punto o il modello si ferma alla fine di una traccia e salta all'inizio di quella successiva. Ad esempio, se vuoi che un singolo segnaposto rappresenti i tuoi viaggi in due giorni e che l'unità GPS sia stata disattivata per quattro ore durante questo periodo, dovrai mostrare una discontinuità tra i punti di accensione e riaccensione dell'unità. Se il valore di <gx:interpolate> è 1, i valori tra la fine della prima traccia e l'inizio della traccia successiva vengono interpolati in modo che la traccia appaia come un percorso continuo.

Consulta la Guida dell'utente di Google Earth per informazioni su come importare i dati GPS in Google Earth.

Perché le tracce sono utili?

Le versioni precedenti di KML (pre-Google Earth 5.2) consentivano di associare un elemento temporale a qualsiasi funzionalità (segnaposto, overlay del terreno e così via). Tuttavia, puoi associare un solo elemento temporale a una determinata funzionalità. Le rotte sono un meccanismo più efficiente per associare dati temporali a funzionalità visibili, in quanto crei una sola funzionalità che può essere associata a più elementi temporali man mano che l'oggetto si sposta nello spazio.

Inoltre, l'elemento track è più potente del meccanismo precedente (descritto nel capitolo Tempo e animazione della Guida per gli sviluppatori KML) perché <Track> fornisce un meccanismo per interpolare la posizione dell'oggetto in qualsiasi momento lungo il suo percorso. Con questa nuova funzionalità, Google Earth visualizza un grafico dei profili di altitudine e velocità (più dati personalizzati, se presenti) per l'oggetto nel tempo.

Dati "sparsi"

Quando mancano valori di dati per le posizioni della traccia, è possibile fornire tag <coord/> (<coord></coord>) o <angles/> (<angles></angles>) vuoti per bilanciare gli array. Un tag <coord/> o <angles/> vuoto indica che non esistono dati di questo tipo per un determinato punto dati e che il valore deve essere interpolato tra i due punti dati ben specificati più vicini. Questo comportamento si applica anche a ExtendedData per una traccia. Qualsiasi elemento tranne <quando> può essere vuoto e verrà interpolato tra i due elementi più specifici più vicini.

Elementi specifici per il tracciamento

<altitudeMode>

Specifica come vengono interpretati i componenti di altitudine nell'elemento <Coordinas>. I valori possibili sono:

clampToGround (impostazione predefinita): indica di ignorare una specifica dell'altitudine (ad es. nel tag <gx:coord>).
relativeToGround: imposta l'altitudine dell'elemento rispetto all'effettiva altitudine del suolo di una determinata posizione. Ad esempio, se l'altitudine del suolo di una località è esattamente al livello del mare e l'altitudine di un punto è impostata su 9 metri, questa modalità indica l'altitudine di un punto. Tuttavia, se la stessa coordinata è impostata su una posizione in cui l'altitudine del suolo è di 10 metri sul livello del mare, l'altitudine della coordinata è di 19 metri.
assoluto: imposta l'altitudine delle coordinate rispetto al livello del mare, indipendentemente dall'altitudine effettiva del terreno sottostante. Ad esempio, se imposti l'altitudine di una coordinata su 10 metri in modalità di altitudine assoluta, l'icona di un segnaposto in linea apparirà a livello del suolo se anche il terreno sottostante si trova a 10 metri sul livello del mare. Se il terreno è a 3 metri sul livello del mare, il segnaposto viene visualizzato sopra il terreno di 7 metri.

<gx:modeMode>

Un'estensione KML nello spazio dei nomi delle estensioni Google, che consente l'altitudine rispetto al fondale marino. I valori sono:

relativeToSeaFloor: interpreta l'altitudine come valore in metri sul livello del mare. Se il punto si trova sopra il terreno anziché sul mare, l'altitudine sarà interpretata come se fosse sopra terra.
clampToSeaFloor: la specifica dell'altitudine viene ignorata e il punto verrà posizionato sul fondale marino. Se il punto di accesso si trova a terra anziché al mare, verrà posizionato a terra.

<quando>

Un valore time che corrisponde a una position (specificato in un elemento <gx:coord>). Il numero di elementi <when> in un elemento <Track> deve essere uguale al numero di elementi <gx:coord> (e degli elementi <gx:angles>, se inclusi).

<gx:coord>

Un valore di coordinato costituito da tre valori per longitudine, latitudine e altitudine, senza separatori di virgola. Ad esempio:

<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

Tieni presente che la sintassi dell'elemento <gx:coord> è diversa dalla sintassi per l'elemento < coordinates, che utilizza le virgole per separare i componenti di longitudine, latitudine e altitudine. Il numero di elementi specificati deve essere uguale al numero di elementi time () e posizione (). Se necessario, puoi specificare un elemento <gx:coord> vuoto per un valore mancante.

<gx:angles>

Questo valore viene utilizzato per specificare un valore di intestazione, inclinazione e rotazione aggiuntivo per l'icona o il modello per ogni volta/posizione all'interno della traccia. I tre valori in virgola mobile vengono elencati senza separatori di virgola e rappresentano i gradi di rotazione. Se <gx:angles> non è specificato, Google Earth deduce l'intestazione, l'inclinazione e la rotazione dell'oggetto dalla sua traccia. Il numero di elementi <gx:angles> specificati deve essere uguale al numero di elementi tempo (<when>) e posizione (<gx:coord>). Se necessario, puoi specificare un elemento <gx:angles> vuoto per un valore mancante.

Attualmente, le icone supportano solo l'intestazione, ma i modelli supportano tutti e tre i valori.

Ecco un esempio di impostazione di questo valore:

<gx:angles>45.54676 66.2342 77.0</gx:angles>

<Modello>

Se specificato, il modello sostituisce l'icona del punto usata per indicare la posizione corrente sulla pista. Quando specificato <Model> in <gx:Track>, ecco come funzionano gli elementi secondari della funzione <Model>:

L'elemento <Location> viene ignorato.
L'elemento <HEIGHTMode> viene ignorato.
Il valore <Orientation> viene combinato con l'orientamento della traccia nel seguente modo. Innanzitutto, viene applicata la rotazione <Orientamento>, che porta il modello dal suo sistema di coordinate locale (x, y, z) a un orientamento verso destra verso nord. Successivamente, viene applicata una rotazione che corrisponde all'interpolazione dei valori <gx:angles> che interessano l'intestazione, l'inclinazione e la rotazione del modello durante lo spostamento lungo la traccia. Se non vengono specificati angoli, l'intestazione e la inclinazione vengono dedotte dal movimento del modello.
Suggerimento: se hai dubbi su come specificare l'orientamento, ometti l'elemento <Orientation> da <Model> e osserva in che modo Google Earth posiziona il modello mentre si sposta lungo il percorso. Se noti che la parte anteriore del modello è rivolta verso il lato, modifica l'elemento <header> in <Orientation> per ruotare il modello in modo che sia rivolto verso la parte anteriore. Se il modello non è verticale, prova a modificare gli elementi <tilt> o <roll>.

<ExtendedData>

Elementi di dati personalizzati definiti in uno <Schema> in precedenza nel file KML.

Spesso è utile aggiungere dati estesi associati a ogni posizione/ora in una traccia. Le corse in bicicletta, ad esempio, potrebbero includere dati per battito cardiaco, ritmo e potenza, come mostrato in Esempio di monitoraggio con dati estesi. Nello <schema> definisci un <gx:SimpleArrayField> per ogni tipo di dati personalizzato. Quindi, per ogni tipo di dati, includi un elemento <gx:SimpleArrayData> contenente gli elementi <gx:value> che corrispondono a ogni ora/posizione nel percorso. Per ulteriori informazioni sull'aggiunta di nuovi campi di dati, consulta il capitolo sull'aggiunta di dati personalizzati della guida per gli sviluppatori KML. In Google Earth, i dati personalizzati vengono visualizzati nel profilo elevazione della traccia.

Esempio semplice

Questo esempio molto semplice mostra come creare "matrici" di valori parallele per <quando> e <gx:coord>. Il numero di valori di tempo e posizione deve essere uguale.

<?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">
<Folder>
  <Placemark>
    <gx:Track>
      <when>2010-05-28T02:02:09Z</when>
      <when>2010-05-28T02:02:35Z</when>
      <when>2010-05-28T02:02:44Z</when>
      <when>2010-05-28T02:02:53Z</when>
      <when>2010-05-28T02:02:54Z</when>
      <when>2010-05-28T02:02:55Z</when>
      <when>2010-05-28T02:02:56Z</when>
      <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
      <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
      <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
      <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
      <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
      <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
      <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
    </gx:Track>
  </Placemark>
</Folder>
</kml>

Esempio di monitoraggio con dati estesi

Il tipo di grassetto in questo esempio evidenzia gli elementi utilizzati per definire e specificare dati personalizzati per una corsa in bici. I campi dei dati personalizzati sono denominati internamente "hearrate", "cadence" e "power". L'elemento <Schema> definisce il nome da visualizzare per ogni set di valori (Frequenza cardiaca, Cadenza e Potenza) e specifica il tipo di dati per ogni nuovo campo (frequenza e frequenza sono di tipo int, mentre l'alimentazione è di tipo float). In Google Earth, questi dati personalizzati vengono visualizzati con il profilo altitudine per la traccia.

Questo esempio mostra una rappresentazione più realistica di una traccia, con icone personalizzate e stili distinti per icone e linee normali per evidenziazioni e modalità normali. Tuttavia, tieni presente che l'esempio include solo sette insiemi di valori dei dati. L'esempio effettivo include decine di migliaia di valori. (Dati gentilmente concessi da Sean Broeder. Questi dati sono stati raccolti con un Garmin Edge 705 con un cardiofrequenzimetro e un misuratore di potenza associati.

<?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>GPS device</name>
    <Snippet>Created Wed Jun 2 15:33:39 2010</Snippet>

    <!-- Normal track style -->
    <LookAt>
      <gx:TimeSpan>
        <begin>2010-05-28T02:02:09Z</begin>
        <end>2010-05-28T02:02:56Z</end>
      </gx:TimeSpan>
      <longitude>-122.205544</longitude>
      <latitude>37.373386</latitude>
      <range>1300.000000</range>
    </LookAt>
    <Style id="track_n">
      <IconStyle>
        <scale>.5</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
      <LabelStyle>
        <scale>0</scale>
      </LabelStyle>

    </Style>
    <!-- Highlighted track style -->
    <Style id="track_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="track">
      <Pair>
        <key>normal</key>
        <styleUrl>#track_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#track_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal multiTrack style -->
    <Style id="multiTrack_n">
      <IconStyle>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>

    </Style>
    <!-- Highlighted multiTrack style -->
    <Style id="multiTrack_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>8</width>
      </LineStyle>
    </Style>
    <StyleMap id="multiTrack">
      <Pair>
        <key>normal</key>
        <styleUrl>#multiTrack_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#multiTrack_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal waypoint style -->
    <Style id="waypoint_n">
      <IconStyle>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <!-- Highlighted waypoint style -->
    <Style id="waypoint_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="waypoint">
      <Pair>
        <key>normal</key>
        <styleUrl>#waypoint_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#waypoint_h</styleUrl>
      </Pair>
    </StyleMap>
    <Style id="lineStyle">
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>
    </Style>
    <Schema id="schema">
      <gx:SimpleArrayField name="heartrate" type="int">
        <displayName>Heart Rate</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="cadence" type="int">
        <displayName>Cadence</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="power" type="float">
        <displayName>Power</displayName>
      </gx:SimpleArrayField>
    </Schema>
    <Folder>
      <name>Tracks</name>
      <Placemark>
        <name>2010-05-28T01:16:35.000Z</name>
        <styleUrl>#multiTrack</styleUrl>
        <gx:Track>
          <when>2010-05-28T02:02:09Z</when>
          <when>2010-05-28T02:02:35Z</when>
          <when>2010-05-28T02:02:44Z</when>
          <when>2010-05-28T02:02:53Z</when>
          <when>2010-05-28T02:02:54Z</when>
          <when>2010-05-28T02:02:55Z</when>
          <when>2010-05-28T02:02:56Z</when>
          <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
          <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
          <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
          <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
          <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
          <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
          <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
          <ExtendedData>
            <SchemaData schemaUrl="#schema">
              <gx:SimpleArrayData name="cadence">
                <gx:value>86</gx:value>
                <gx:value>103</gx:value>
                <gx:value>108</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="heartrate">
                <gx:value>181</gx:value>
                <gx:value>177</gx:value>
                <gx:value>175</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="power">
                <gx:value>327.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>179.0</gx:value>
                <gx:value>162.0</gx:value>
                <gx:value>166.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>183.0</gx:value>
              </gx:SimpleArrayData>
            </SchemaData>
          </ExtendedData>
        </gx:Track>
      </Placemark>
    </Folder>
  </Document>
</kml>

Estende

<Geometria>

Contenuto da

<MultiGeometry>
<gx:MultiTrack>
<Segnaposto>

<Aggiorna>

Sintassi

<Update>
  <targetHref>...</targetHref>    <!-- URL -->
  <Change>...</Change>
  <Create>...</Create>
  <Delete>...</Delete>
</Update>

Descrizione

Consente di specificare un'aggiunta, una modifica o un'eliminazione ai dati KML che sono già stati caricati utilizzando l'URL specificato. Il tag <targetHref> specifica il file .ZIP o .pdfs di cui modificare i dati (in Google Earth). <Update> è sempre incluso in NetworkLinkControl. Inoltre, il file contenente l'elemento NetworkLinkControl deve essere stato caricato da un NetworkLink. Per un esempio dettagliato del funzionamento dell'aggiornamento, consulta la pagina "Argomenti in KML" in Aggiornamenti.

Elementi specifici da aggiornare

Può contenere un numero qualsiasi di elementi <Change>, <Create> ed <Delete>, che verranno elaborati in ordine.

<targetHref>(obbligatorio): Un URL che specifica il file .swf o .pdfs i cui dati (in Google Earth) devono essere modificati da un elemento <Update>. Questo file KML deve essere già stato caricato tramite un <NetworkLink>. Nel file, l'elemento da modificare deve già avere un attributo id esplicito.
<Cambia>: Modifica i valori in un elemento che è già stato caricato con un <NetworkLink>. All'interno dell'elemento Change, l'elemento secondario da modificare deve includere un attributo targetId che faccia riferimento all'id dell'elemento originale.; Questo aggiornamento può essere considerato un "aggiornamento temporaneo": nell'elemento modificato solo i valori elencati in <Cambia> vengono sostituiti e tutti gli altri valori restano invariati. Quando viene applicata <Cambia> a un insieme di coordinate, le nuove coordinate sostituiscono quelle correnti.; Gli elementi secondari di questo elemento sono gli elementi da modificare, che vengono identificati dall'attributo targetId.
<Crea>: Aggiunge nuovi elementi a una cartella o a un documento che sono già stati caricati tramite un <NetworkLink>. L'elemento <targetHref> in <Update> specifica l'URL del file .swf o .pdfs contenente la cartella o il documento originali. All'interno di quel file, la cartella o il documento che deve contenere i nuovi dati deve avere già un id esplicito. Questo id è indicato come attributo targetId della cartella o del documento all'interno di <Create> che contiene l'elemento da aggiungere.; Una volta creato e caricato un oggetto in Google Earth, l'oggetto prende in considerazione l'URL del Documento principale della cartella principale. Per eseguire i successivi aggiornamenti degli oggetti aggiunti con il meccanismo Update/Create, imposta il valore <targetHref> sull'URL del documento o della cartella originale (non sull'URL del file che ha caricato gli aggiornamenti intermedi).
<Elimina>: Elimina le caratteristiche di un elemento complesso che è già stato caricato tramite un <NetworkLink>. L'elemento <targetHref> in <Update> specifica il file .ZIP o .pdfs contenente i dati da eliminare. All'interno di quel file, l'elemento da eliminare deve già avere un id esplicito. L'elemento <Delete> fa riferimento a questo id nell'attributo targetId.; Gli elementi secondari di <Delete>, che sono gli unici elementi che possono essere eliminati, sono Document, Folder, GroundOverlay, Segnaposto e Overlay schermo.

Esempio di <Change>

<NetworkLinkControl>
  <Update>
    <targetHref>http://www/~sam/January14Data/Point.kml</targetHref>
    <Change> 
      <Point targetId="point123">
        <coordinates>-95.48,40.43,0</coordinates>
      </Point>
    </Change>
  </Update>
</NetworkLinkControl>

Esempio di <Create>

Questo esempio crea un nuovo segnaposto in un documento creato in precedenza con un id di "region24". Tieni presente che se vuoi apportare i successivi aggiornamenti a "placemark891", utilizzerai comunque http://myserver.com/Point.\"> come <targetHref>.

<Update>
  <targetHref>http://myserver.com/Point.kml</targetHref>
  <Create>
    <Document targetId="region24">
      <Placemark id="placemark891">
        <Point>
          <coordinates>-95.48,40.43,0</coordinates>
        </Point>
      </Placemark>
    </Document>
  </Create> 
</Update>

Esempio di <Delete>

Questo esempio elimina un segnaposto caricato in precedenza in Google Earth. Questo segnaposto potrebbe essere stato caricato direttamente da un NetworkLink con l'URL specificato oppure potrebbe essere stato caricato da un successivo aggiornamento del documento originale.

<Update>
  <targetHref>http://www.foo.com/Point.kml</targetHref>
  <Delete>
    <Placemark targetId="pa3556"></Placemark>
  </Delete>
</Update>

Contenuto da

<NetworkLinkControl>

<URL>

Nota: questo elemento è stato ritirato nella versione 2.1 di KML e viene sostituito da <Link>, che fornisce le funzionalità aggiuntive di Regioni. Il tag <Url> continuerà a funzionare in Google Earth, ma consigliamo di utilizzare il tag <Link> più recente.

Utilizza questo elemento per impostare la posizione del link al file KML, per definire le opzioni di aggiornamento per le modifiche al server e nel visualizzatore e per completare una variabile per restituire informazioni utili al client.

Torna all'inizio