Guida per gli sviluppatori
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
In questa sezione sono incluse le pagine con ulteriori informazioni sui principali elementi KML e su come utilizzarli.
- File KMZAggiornati
Scopri come pacchettizzare (e comprimere) il file KML e tutte le relative immagini, overlay, icone e file audio in un'unica unità ordinata che può essere pubblicata o inviata per email come singola entità.
- Tour
- Google Earth 5.0 introduce i tour: il movimento controllato da KML attraverso lo spazio e il tempo. Gli elementi correlati ai tour sono contenuti nello spazio dei nomi delle estensioni di Google.
- Modalità altitudine
- Grazie all'introduzione di elementi nello spazio dei nomi delle estensioni di Google, Google Earth 5.0 può portare gli spettatori sott'acqua con le nuove modalità clampToSeaFloor e relativeToSeaFloor. Questo capitolo illustra anche le modalità tradizionali fuori terra.
- Tempo e animazione
- A qualsiasi funzionalità in KML possono essere associati dati temporali. Quando un file KML contiene una funzionalità con elementi TimeSpan o TimeStamp, Google Earth mostra un dispositivo di scorrimento temporale. Utilizzando il dispositivo di scorrimento e il pulsante di riproduzione, l'utente può "riprodurre" l'intera sequenza o selezionare singoli periodi di tempo per la visualizzazione.
- Fotocamere
- L'elemento Fotocamera offre un metodo aggiuntivo per specificare il punto di vista per una funzionalità. Le fotocamere vengono utilizzate con gli overlay di foto, un'altra funzionalità aggiunta in KML 2.2. <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.
- Overlay foto
- L'elemento PhotoOverlay ti consente di posizionare geograficamente una foto sul pianeta e di specificare la posizione e l'orientamento della fotocamera che esegue la visualizzazione di questo overlay di foto. Overlay foto può essere un semplice rettangolo 2D, un cilindro parziale o pieno oppure una sfera (per panoramiche sferiche). L'elemento secondario ImagePyramid di PhotoOverlay fornisce una gestione efficiente delle fotografie arbitrariamente grandi in Google Earth.
- Dati di Sky in KML
- Ora puoi visualizzare i dati celesti in Google Earth. In questa pagina viene spiegato come configurare il file KML per visualizzare il cielo, con suggerimenti per la conversione delle coordinate celesti standard in Google Earth in modalità Sky.
- Aggiunta di dati personalizzati
- Puoi aggiungere dati personalizzati alle funzionalità KML in tre modi diversi, a seconda del tipo di dati personalizzati. Il nuovo elemento ExtendedData consente di aggiungere dati non digitati, dati digitati o dati XML arbitrari a una funzionalità KML. Google Earth conserva queste informazioni insieme al file. I dati non digitati e digitati contengono elementi di visualizzazione che possono essere utilizzati per i modelli di stile e la sostituzione delle entità nel fumetto.
- Modelli
- Gli oggetti tridimensionali possono essere modellati naturalmente nel loro spazio di coordinamento ed esportati come file COLLADATM, quindi importati in Google Earth e posizionati sulla superficie terrestre.
- Aree geografiche
- Le aree geografiche forniscono un comportamento di selezione e livello di dettaglio che ti consente di perfezionare il modo in cui i tuoi dati vengono presentati in Google Earth. Se utilizzate con NetworkLinks, le aree geografiche consentono lo streaming di set di dati molto grandi, con un caricamento "intelligente" dei dati a diversi livelli di risoluzione (vedi la sezione sui sovrapposizioni super). Puoi anche simulare i livelli di Google Earth utilizzando le aree geografiche.
- Aggiornamenti
- Puoi aggiornare in modo incrementale i dati caricati da NetworkLinks, modificando, aggiungendo ed eliminando i dati KML caricati in precedenza su Google Earth.
- Scadenza
- In questa pagina viene spiegato come evitare che i dati KML diventino inattivi, utilizzando le intestazioni HTTP e i tempi di scadenza di KML.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2022-12-20 UTC.
[null,null,["Ultimo aggiornamento 2022-12-20 UTC."],[[["\u003cp\u003eThis section provides further detail on key KML elements and their usage.\u003c/p\u003e\n"],["\u003cp\u003eKML files can incorporate touring, altitude modes, time, animation, and camera viewpoints for features.\u003c/p\u003e\n"],["\u003cp\u003eFeatures can include photo overlays, sky data, custom data, 3D models, and regions for enhanced visualization.\u003c/p\u003e\n"],["\u003cp\u003eNetworkLinks support data updates and can leverage regions for efficient streaming and level-of-detail management.\u003c/p\u003e\n"],["\u003cp\u003eKML data freshness can be controlled using HTTP headers and expiration times to prevent staleness.\u003c/p\u003e\n"]]],[],null,["# Developer's Guide\n\nThis section includes pages with additional information on key KML elements and how to use them.\n\n[KMZ Files](/kml/documentation/kmzarchives)^Updated^\n: Learn how to package up (and compress) your KML file and all its related images, overlays, icons, and sound files into one tidy unit that can be posted or emailed as a single entity.\n\n[Touring](/kml/documentation/touring)\n: Google Earth 5.0 introduces touring: KML-controlled movement through space and time. Touring-related elements are contained in the Google extension namespace.\n\n[Altitude Modes](/kml/documentation/altitudemode)\n: With the introduction of elements in the Google extension namespace, Google Earth 5.0 can take viewers underwater with new clampToSeaFloor and relativeToSeaFloor altitude modes. This chapter also discusses the traditional, above-ground modes.\n\n[Time and Animation](/kml/documentation/time)\n: Any Feature in KML can have time data associated with it. When a KML file contains a Feature with TimeSpan or TimeStamp elements, Google Earth displays a time slider. Using the slider and play button, the user can \"play\" the entire sequence or can select individual time periods for display.\n\n[Cameras](/kml/documentation/cameras)\n: The Camera element provides an additional way to specify the viewpoint for a Feature. Cameras are used with PhotoOverlays, another feature added in KML 2.2. \\\u003cCamera\\\u003e provides full six-degrees-of-freedom control over the view, so you can position the Camera in space and then rotate it around the *x* , *y* , and *z* axes.\n\n[PhotoOverlays](/kml/documentation/photos)\n: The PhotoOverlay element allows you to geographically locate a photograph on the Earth and to specify the placement and orientation of the Camera that views this PhotoOverlay. The PhotoOverlay can be a simple 2D rectangle, a partial or full cylinder, or a sphere (for spherical panoramas). The ImagePyramid child element of PhotoOverlay provides for efficient handling of arbitrarily large photographs in Google Earth.\n\n[Sky Data in KML](/kml/documentation/kmlsky)\n: Now you can display celestial data in Google Earth. This page describes how to set up your KML file to view the sky, with tips on converting standard celestial coordinates to display in Google Earth, Sky mode.\n\n[Adding Custom Data](/kml/documentation/extendeddata)\n: You can add custom data to KML Features in three different ways, depending on the kind of custom data. The new ExtendedData element allows you to add your own untyped data, typed data, or arbitrary XML data to a KML Feature. Google Earth preserves this information along with the file. Untyped data and typed data contain display elements that can be used for style templates and entity replacement in the balloon.\n\n[Models](/kml/documentation/models)\n: Three-dimensional objects can be modeled naturally in their own coordinate space and exported as COLLADA™ files, then imported into Google Earth and placed on the Earth's surface.\n\n[Regions](/kml/documentation/regions)\n: Regions provide culling and level-of-detail behavior that allow you to fine-tune how your data is presented in Google Earth. When used with NetworkLinks, Regions enable streaming of very large datasets, with \"smart\" loading of data at multiple levels of resolution (see the section on [Super-Overlays](/kml/documentation/regions#superoverlays)). You can also simulate Google Earth's layers using Regions.\n\n[Updates](/kml/documentation/updates)\n: You can incrementally update data loaded by NetworkLinks---changing, adding, and deleting KML data that was previously loaded into Google Earth.\n\n[Expiration](/kml/documentation/expiration)\n: This page discusses how to prevent KML data from becoming stale, through the use of HTTP headers and KML expiration times."]]
