Guide du développeur
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette section inclut des pages contenant des informations supplémentaires sur les principaux éléments KML et leur utilisation.
- Fichiers KMZMises à jour
Découvrez comment empaqueter (et compresser) votre fichier KML et ses images, superpositions, icônes et fichiers audio associés dans une seule unité, qui peut être publiée ou envoyée par e-mail en tant qu'entité unique.
- Visite
- Google Earth 5.0 propose des visites guidées: les mouvements KML dans l'espace et le temps. Les éléments liés à la visite sont contenus dans l'espace de noms de l'extension Google.
- Modes d'altitude
- Avec l'introduction des éléments dans l'espace de noms de l'extension Google, Google Earth 5.0 peut emmener les utilisateurs sous l'eau avec les nouveaux modes clampToSeaFloor et relativeToSeaFloor. Ce chapitre aborde également les modes traditionnels traditionnels.
- Temps et animation
- Des données temporelles peuvent être associées à n'importe quel élément géographique du fichier KML. Lorsqu'un fichier KML contient un élément géographique comportant des éléments TimeSpan ou TimeStamp, Google Earth affiche un curseur chronologique. À l'aide du curseur et du bouton de lecture, l'utilisateur peut "lire" toute la séquence ou sélectionner des périodes individuelles.
- Appareils photo
- L'élément "Appareil photo" offre un moyen supplémentaire de spécifier le point de vue d'un élément géographique. Les appareils photo sont aussi utilisés avec les superpositions de photos, une autre fonctionnalité ajoutée dans KML 2.2. <Camera> offre un contrôle total de la liberté sur 6 degrés de la vue. Vous pouvez ainsi positionner la caméra dans l'espace, puis la faire pivoter autour des axes x, y et z.
- Superpositions de photos
- L'élément PhotoOverlay vous permet de géolocaliser une photo sur la Terre et de préciser l'emplacement et l'orientation de l'appareil photo avec lequel elle s'affiche. PhotoOverlay peut être un simple rectangle 2D, un cylindre partiel ou complet, ou une sphère (pour les panoramas sphériques). L'élément enfant ImagePyramid de PhotoOverlay permet de gérer efficacement des photos arbitrairement volumineuses dans Google Earth.
- Données Sky en KML
- Vous pouvez désormais afficher des données célestes dans Google Earth. Cette page explique comment configurer votre fichier KML pour afficher le ciel et obtenir des conseils sur la conversion des coordonnées célestes standards pour les afficher en mode Google Earth ou Sky.
- Ajouter des données personnalisées
- Vous pouvez ajouter des données personnalisées aux éléments géographiques de trois manières différentes, selon le type de données personnalisées. Le nouvel élément ExtendedData vous permet d'ajouter vos propres données non typées, données typées ou données XML arbitraires à un élément géographique KML. Google Earth conserve ces informations avec le fichier. Les données non typées et les données typées contiennent des éléments d'affichage qui peuvent être utilisés pour les modèles de style et le remplacement d'entités dans l'info-bulle.
- Modèles
- Les objets tridimensionnels peuvent être modélisés naturellement dans leur propre espace de coordonnées et exportés sous forme de fichiers COLLADATM. Ils peuvent ensuite être importés dans Google Earth et placés sur la surface de la Terre.
- Régions
- Les régions permettent d'effectuer des prises de vue et un niveau de détail élevé afin que vous puissiez affiner la présentation de vos données dans Google Earth. Lorsqu'elles sont utilisées avec des liens réseau, les régions permettent de diffuser de très grands ensembles de données avec un "chargement intelligent" de données à plusieurs niveaux de résolution (voir la section Superpositions multiples). Vous pouvez également simuler des calques dans Google Earth à l'aide de régions.
- Mises à jour
- Vous pouvez mettre à jour de manière incrémentielle les données chargées par NetworkLinks en modifiant, en ajoutant et en supprimant des données KML déjà chargées dans Google Earth.
- Expiration
- Cette page explique comment éviter que les données KML ne deviennent obsolètes à l'aide des en-têtes HTTP et des délais d'expiration KML.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2022/12/20 (UTC).
[null,null,["Dernière mise à jour le 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."]]
