Questions fréquentes sur KML

Le format de fichier KML permet d'afficher des données géographiques dans un navigateur Earth, tel que Google Earth. Vous pouvez créer des fichiers KML pour identifier des lieux, ajouter des images en superposition et présenter des données enrichies de nouvelles façons. KML est une norme internationale gérée par l'Open Geospatial Consortium, Inc. (OGC).

La communauté KML est vaste et variée, comme vous le verrez en consultant le forum de la communauté Google Earth. Les utilisateurs occasionnels créent des fichiers KML pour marquer leur maison, documenter des voyages et planifier des randonnées et des sorties à vélo. Les scientifiques utilisent le format KML pour fournir des cartographies détaillées des ressources, des modèles et des tendances, comme les éruptions volcaniques, les conditions météorologiques, l'activité sismique et les gisements minéraux. Les professionnels de l'immobilier, les architectes et les agences d'aménagement urbain utilisent le format KML pour proposer des constructions et visualiser des plans. Les élèves et les enseignants utilisent le format KML pour explorer des personnes, des lieux et des événements, historiques ou actuels. Des organisations telles que National Geographic, l'UNESCO et la Smithsonian Institution ont toutes utilisé le format KML pour afficher leurs ensembles de données mondiales riches.

Il existe trois outils principaux pour créer des fichiers KML.

• Google Earth. Il s'agit de l'outil le plus important pour créer des fichiers KML. Avec Google Earth, vous pouvez créer
  
  • Repères
  • Chemins d'accès
  • Polygones
  • Superpositions d'images
  • Liens réseau
  • Modèles de lieux
  • Dossiers de tous les éléments ci-dessus
  • PhotoOverlays

Une fois que vous avez créé l'un de ces objets, effectuez un clic droit dessus dans le volet "Lieux", puis sélectionnez "Copier". Vous pouvez ensuite le coller dans un éditeur de texte ou un éditeur XML, puis commencer à le modifier.

• Éditeur de texte. Après avoir créé un objet dans Google Earth, collez-le dans un éditeur de texte et commencez à le modifier.
• Éditeur XML. KML est un langage XML permettant de décrire du contenu géographique. Un éditeur XML est un éditeur de texte sophistiqué qui fournit de nombreux outils pour créer des documents XML, tels que la saisie semi-automatique des balises, qui vous permet de vous assurer que vous fermez vos éléments KML avec les balises de fermeture appropriées.

De nombreux outils ont également été créés par les utilisateurs de la communauté Google Earth. Consultez le groupe Google d'assistance aux développeurs KML.

Les fichiers KMZ sont des collections compressées d'un ou plusieurs fichiers à afficher dans Google Earth. Ils sont compressés au format ZIP et peuvent être ouverts à l'aide de n'importe quel outil ZIP courant, tel que WinZip, 7-Zip ou l'outil de dossiers compressés par défaut de Windows XP. Pour Windows, utilisez Stuffit, pour Mac OS, ou zip, pour Mac OS ou Linux. Vous devrez peut-être remplacer l'extension de fichier .kmz par .zip pour que le fichier soit reconnu par un outil de compression. N'oubliez pas de rétablir le format .kmz avant de réutiliser le fichier.

Le format KML peut être utilisé pour représenter des données astronomiques et être chargé dans Google Sky ou WorldWide Telescope de Microsoft. Pour en savoir plus, consultez l'article Sky Data in KML (Données Sky au format KML).

Toutes les balises KML sont compatibles avec Google Earth. Pour obtenir la liste de toutes les balises, consultez la spécification KML.

Le Guide du développeur est disponible à l'adresse https://developers.google.com/kml/documentation/topicsinkml.html.

Lorsqu'une LineString est définie sur clampToGround, elle suit la courbe du globe sans problème. Toutefois, si la valeur est "relativeToGround", vous devrez peut-être ajouter des points, sinon des lignes plus longues seront tracées en ligne droite à travers le globe ou le terrain.

Par exemple, cette LineString traversera la Terre et disparaîtra :

<kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <name>Untitled Path</name>
    <LineString>
      <tessellate>0</tessellate>
      <altitudeMode>absolute</altitudeMode>
      <coordinates>-115.415105,40.669016 -37.752364,34.879979</coordinates>
    </LineString>
  </Placemark>
</kml>

Ajouter des points permet de réduire la partie de la ligne qui se trouve sous terre. <tessellate> doit également être défini sur "1" pour que la ligne suive le terrain.

<Placemark>
  <name>Untitled Path</name>
  <LineString>
    <tessellate>1</tessellate>
    <altitudeMode>relativeToGround</altitudeMode>
    <coordinates>
      -134.148103,37.752967 -128.917074,38.803008
      -125.166954,39.583592 -122.137625,39.656880
      -120.421783,40.036311 -118.298157,40.235316
      -114.348386,40.631532 -112.670431,40.761033
      -111.916045,40.681939 -110.177711,40.653055
      -109.544331,40.619327 -107.155697,40.642007
      -105.410526,40.421505 -103.192299,40.430138
      -102.853712,40.427904 -98.168302,40.363524
      -97.093391,40.308754 -94.831304,40.479175
      -93.760070,40.395392 -84.913828,39.466651
      -84.414888,39.387332 -81.380660,39.188551
      -80.276261,38.977744 -77.811560,38.872542
      -75.062267,38.521146 -72.006956,38.101733
      -66.67819,37.664687
    </coordinates>
  </LineString>
</Placemark>

Il n'existe pas de géométrie de cercle dans KML. Toutefois, vous pouvez créer des formes très proches de cercles à l'aide de LineStrings avec de nombreuses coordonnées proches les unes des autres. Voici un exemple.

<LineStyle> vous permet de modifier la couleur, l'opacité et la taille des lignes. Toutefois, à l'heure actuelle, le format KML ne permet pas de modifier les types de lignes.

Le libellé qui s'affiche à côté d'un repère dans Google Earth est basé sur l'élément <name>. En définissant l'élément "scale" de LabelStyle sur 0, vous pouvez masquer le libellé.

<Style id="hideLabel">
  <LabelStyle>
    <scale>0</scale>
  </LabelStyle>
</Style>

Deux causes principales peuvent expliquer les erreurs d'analyse :

1. Casse : comme tous les langages XML, KML est sensible à la casse. Il exige que tous les noms d'éléments soient dans la casse appropriée. Par exemple : <Placemark> et non <PLACEMARK> <href> et non <Href> <Link> et non <lInk>
2. Balises incomplètes : tous les éléments doivent commencer et se terminer par la même balise. Parfois, les utilisateurs oublient de fermer une balise ou d'ajouter un crochet (< ou >).

   Par exemple :
   <name>Atlanta</name> est correct
   <name>Atlanta n'est pas correct
   <nameAtlanta</name> n'est pas correct
   <nameAtlanta<name> n'est pas correct

KML est un langage de balisage XML. Vous pouvez le valider de différentes manières :

• Vous pouvez obtenir un éditeur XML, tel que Oxygen ou Netbeans, et l'utiliser pour valider le document. Consultez la documentation de l'éditeur XML de votre choix. Vous aurez besoin du schéma KML pour effectuer la validation.
• Vous pouvez le vérifier à l'aide d'un outil de validation en ligne, tel que FeedValidator.org. Il vous indiquera les erreurs que vous avez commises et vous proposera également quelques suggestions de style.
• Certains éditeurs de texte vous permettent de valider le fichier XML. Par exemple, vous pouvez utiliser jEdit pour valider votre fichier KML. Consultez ce tutoriel de l'équipe Google Earth Outreach.

La balise "Région" permet de contrôler les fonctionnalités que vous affichez à l'utilisateur. Les meilleures ressources pour en savoir plus sur les régions sont les suivantes :

• Article du guide du développeur sur les régions
• Document de référence Google sur le format KML pour les régions

L'élément MultiGeometry regroupe les géométries dans le même élément Placemark. Cela permet aux géométries de partager le même style et d'apparaître comme un seul élément dans une liste telle que le panneau "Mes lieux" dans Google Earth.

Les styles sont définis au niveau du repère, à l'aide d'un élément styleUrl ou Style. Par conséquent, les géométries individuelles de ce repère ne peuvent pas avoir de styles différents.

Une solution de contournement fréquemment utilisée consiste à créer un repère distinct pour chaque géométrie, ce qui permet à chacune d'avoir un style différent. Pour éviter la prolifération d'éléments dans une liste, placez-les dans un dossier qui comporte un ListStyle avec un listItemType avec checkHideChildren. Dans Google Earth, par exemple, cela place tous les repères dans le même élément de dossier dans "Mes lieux" et empêche l'utilisateur de l'ouvrir pour afficher un grand nombre d'éléments.

Pour le moment, le format KML ne permet pas d'ouvrir un ballon lorsque le fichier KML s'ouvre. Toutefois, si vous utilisez une ancre de fonctionnalité, vous pouvez créer un lien dans une bulle qui ouvrira un deuxième fichier KML ou une autre bulle.

Pour le moment, KML ne permet pas de conserver l'état des info-bulles lorsque le NetworkLink est actualisé.

Pour le moment, vous ne pouvez pas utiliser de NetworkLink pour capturer le fichier KML créé par un utilisateur dans Google Earth ou Maps. Vous pouvez toutefois utiliser l'API Google Maps JavaScript comme outil de création de fichiers KML et récupérer ces informations sur le serveur. Pour obtenir un exemple, consultez GeoDataStore.

Le curseur temporel dans KML s'ouvre dès qu'un fichier KML contenant un élément TimeStamp ou TimeSpan est ouvert. Le curseur temporel recherche tous les éléments TimeStamp et TimeSpan actuellement sélectionnés, puis s'ajuste pour tenir compte de toutes les dates représentées. Le format KML ne permet pas actuellement de mieux contrôler le curseur temporel, par exemple en définissant l'heure actuelle sélectionnée ou en choisissant la largeur de la période représentée. Pour en savoir plus sur l'utilisation de Time, consultez l'article Heure et animation.

À l'heure actuelle, le format KML dans Google Earth n'est compatible qu'avec un sous-ensemble de code HTML qui décrit la présentation, et non l'interaction.

Vous pouvez toutefois intégrer des formulaires Flash dans les fichiers KML utilisés dans Google Earth. Pour ce faire, intégrez une application Flash dans le code HTML d'une infobulle de description KML.

Pour ce faire, plusieurs options s'offrent à vous.

• Faites-le vous-même de manière programmatique, en utilisant votre propre application pour analyser un fichier CSV et créer un fichier KML à partir de celui-ci. Pour obtenir un exemple, consultez Convertir des fichiers CSV au format KML.
• Utilisez une feuille de calcul en ligne. Par exemple, l'équipe Google Earth Outreach a créé un outil de cartographie de feuilles de calcul basé sur les feuilles de calcul Google.
• Utilisez l'un des outils de création Excel vers KML, comme celui-ci [lien vers le fil de discussion de tek].
• Utilisez Google Earth Plus ou Pro pour charger les fichiers, puis enregistrez-les au format KML ou KMZ.

Une modification récente apportée à Google Earth change la façon dont les liens sont traités pour le contenu à l'intérieur d'une bulle d'informations afin de rendre le comportement précédemment non spécifié plus clair. Par conséquent, si un utilisateur clique sur un lien non valide dans un fichier KMZ, il est redirigé vers une page indiquant "Le lien qui vous a redirigé vers cette page est peut-être mal formaté. Cliquez sur le lien ci-dessous pour essayer d'utiliser l'ancien mode." Si ce message s'affiche, vous devez modifier la structure de votre contenu KML/KMZ pour assurer une compatibilité totale avec les futures versions de Google Earth.

Pour en savoir plus, y compris sur la façon de restructurer correctement votre contenu KMZ, consultez cet article.

Pour le moment, seuls les liens (URL) contenus dans les bulles d'aide sont concernés par ce changement. Cela inclut les balises <description> et <text> dans les balises <BallonStyles>. Toutefois, les futures versions de Google Earth pourront tendre vers une plus grande cohérence. Il faut donc toujours éviter d'utiliser le répertoire parent comme URL de base pour un lien relatif dans le contenu KMZ.

Non. Les fichiers KML créés ou chargés par l'utilisateur dans Google Earth ne sont pas envoyés à Google. Toutes les opérations de traitement et de stockage de ces données sont effectuées sur la machine locale.