Convertir KMZ en CSV

Les fichiers KMZ viennent rarement de la personne qui essaie d’en ouvrir un. Ils arrivent en pièce jointe d’un géomètre, d’un service public, d’un service d’urbanisme, d’un office de tourisme ou d’un sous-traitant, produits par l’outil que cette organisation a standardisé, et ils supposent Google Earth à l’autre bout. Si vous avez un ordre de mission à émettre ou un compte à vérifier, installer un visualiseur de globe pour lire quarante coordonnées est une mauvaise affaire.

C’est à cette situation que cette conversion sert. Elle ouvre l’archive, lit le document à l’intérieur, et vous donne les positions et les noms en lignes — assez pour coller une coordonnée dans un formulaire, recouper avec un registre d’actifs, ou confirmer que le fichier contient bien les dix-huit sites que le courriel annonçait. Ce qu’elle ne vous donnera pas, c’est la carte, et si la carte est le livrable, alors Google Earth est vraiment le bon outil.

Il n’y a pas de modèle de données propre au KMZ. Le format est une archive ZIP dont le membre principal est un document KML, et tout ce qu’un KMZ peut exprimer est exprimé par ce KML. L’archive existe pour qu’une carte puisse voyager comme un seul fichier avec les images qu’elle référence — icônes d’épingles personnalisées, superposition photo, plan scanné géoréférencé sur le terrain — plutôt que comme un dossier qui se casse dès qu’un fichier reste en route.

Le lecteur cherche doc.kml, qui est le nom qu’écrit Google Earth, et se rabat sur le premier membre dont le nom se termine en .kml si ce nom est absent. Le repli n’est pas une garniture défensive : la spécification exige seulement que le document principal de l’archive soit un KML, et les fichiers exportés par d’autres outils portent des noms comme Sites_Phase2.kml. Si aucun membre ne se termine en .kml, la conversion s’arrête avec un message qui le dit plutôt que de produire un tableau vide.

Un KMZ qui fait 4 Mo n’est presque jamais 4 Mo de coordonnées. Le gros est généralement un dossier files/ ou images/ qui contient les PNG d’icônes, une superposition JPEG, parfois un plan de site scanné de plusieurs milliers de pixels de côté. Rien de tout cela n’est représenté dans le CSV, et ce n’est pas en train d’être abandonné en silence par un oubli — un tableau n’a pas où mettre une image raster, et une colonne de noms de fichiers pointant vers des fichiers que vous n’avez plus serait activement trompeuse.

La conséquence pratique est qu’un KMZ dont le vrai contenu est une image se convertit en un CSV presque vide. Un plan géoréférencé avec deux marqueurs d’angle vous donne deux lignes et pas du plan. Si c’est ce que vous trouvez, l’archive est un document plutôt qu’un jeu de données, et la décompresser à la main pour regarder l’image est la réponse plutôt qu’un autre convertisseur.

Chaque ligne porte un type, un nom, une latitude, une longitude, une altitude et une heure. Le type distingue un point isolé d’un sommet de ligne tracée, et c’est la première chose sur laquelle filtrer : un KMZ d’emplacements d’actifs devrait être entièrement en lignes waypoint, et un gros bloc de lignes track signifie que le fichier contient aussi des parcours ou des contours.

Le nom est l’étiquette que portait le repère, répété sur chaque sommet d’une ligne pour qu’isoler une seule entité dans un gros fichier n’ait pas besoin de jointure. La latitude et la longitude sont en degrés décimaux, ce que le champ de recherche d’une cartographie, un système de flotte et une API de géocodage acceptent tous directement. L’altitude et l’heure sont souvent vides, parce qu’une carte dessinée n’enregistre ni l’une ni l’autre, et vide est la bonne sortie pour une valeur que la source n’a jamais eue.

Changer l’extension en .zip et double-cliquer est une façon légitime d’accéder au contenu, et cela vaut la peine d’être su parce que cela ne coûte rien et confirme ce qu’est réellement le fichier. Tout système d’exploitation de bureau l’ouvrira, et vous verrez le KML à côté des images qui ont voyagé avec lui.

Ce que vous avez alors est du XML : des coordonnées écrites comme des triplets longitude,latitude,altitude enfilés dans un seul élément, enveloppés dans une structure de repères et de dossiers, avec la longitude en premier. C’est lisible par une personne qui cherche un chiffre, et inutilisable comme jeu de données. La conversion fait la seconde moitié — la marche dans l’arborescence, la découpe des coordonnées, le passage en latitude d’abord — qui est la partie fastidieuse à la main et facile à rater.

La compression rend la taille du fichier sur disque un mauvais indicateur de ce qu’il y a dedans. Le KML est du texte répétitif, qui se déflate inhabituellement bien : un KML d’environ 258 Ko mesuré ici a été compressé à environ 47 Ko dans l’archive, un facteur de cinq et demi. Un KMZ de 3 Mo peut donc contenir quelque chose comme 15 Mo de KML et plusieurs centaines de milliers de coordonnées.

Le plafond gratuit de 100 Mo s’applique au KMZ tel qu’il est, donc en pratique la limite que vous rencontrez d’abord est la mémoire de votre onglet de navigateur plutôt que le chiffre. Si une grosse archive se bloque, le diagnostic utile est de la renommer en .zip et de regarder la taille décompressée du membre KML — c’est ce chiffre, pas la taille de l’archive, qui doit être analysé et gardé en mémoire.

Deux échecs distincts produisent quelque chose qui ressemble à rien. Si l’archive ne contient pas de membre KML, la conversion le dit explicitement, et la cause est presque toujours un fichier qui a été renommé plutôt qu’exporté. Si le KML est présent mais ne donne aucune géométrie, le message est qu’aucun tracé ni aucun waypoint n’a été trouvé, ce qui est un problème différent avec une correction différente.

La cause habituelle du second est que le fichier est constitué de polygones. Les zones — limite de parcelle, zone inondable, empreinte de couverture — stockent leur contour dans un élément <Polygon> dans lequel ce lecteur ne descend pas, si bien qu’un KMZ de rien d’autre que de régions ombrées ne produit aucune ligne. Les liens réseau (NetworkLink), qui vont chercher leur contenu à une URL plutôt que de les stocker, reviennent vides pour la raison plus fondamentale que l’archive ne contient vraiment aucune donnée.

Le nom de chaque repère passe. Presque rien d’autre de ce que porte un export professionnel ne passe, et sur ce genre de fichier c’est l’omission qui a le plus de chances d’importer : le numéro d’actif, le diamètre de la conduite, la date d’inspection, la référence de parcelle et la note du géomètre vivent généralement dans l’infobulle <description> ou dans un bloc <ExtendedData>, et ni l’un ni l’autre n’est lu. Un KMX qui avait l’air dense en information dans Google Earth peut se convertir en un tableau de noms et de chiffres où toute la substance a disparu.

Deux voies la récupèrent. Renommez l’archive en .zip, extrayez le KML et lisez-le — les champs étendus sont verbeux mais parfaitement lisibles, et un élément <SimpleData name="asset_id"> dit ce qu’il est. Ou demandez à l’expéditeur le tableau à partir duquel le KMZ a été généré, qui existe presque toujours, parce qu’un fichier avec un schéma personnalisé vient d’une base de données plutôt que de quelqu’un qui dessine sur un globe.

La latitude et la longitude sont écrites en degrés décimaux simples à six décimales, environ 11 centimètres — bien plus fin que ce que la source justifie, et assez grossier pour que le fichier reste lisible. Ce format va directement dans le champ de recherche de n’importe quel site cartographique, dans un système de flotte ou de dispatch, et dans une API de géocodage sans conversion, ce qui est en général la raison immédiate pour laquelle on voulait le tableau.

La seule chose à surveiller est l’ordre qu’attend la destination. Écrit comme 48.137154, 11.576124, une recherche cartographique lit la latitude en premier et arrive là où vous le vouliez. Un système bâti sur GeoJSON ou sur une bibliothèque SIG veut souvent la longitude en premier, et inverser la paire déplace un point à Munich en mer au large de la Somalie — assez loin pour que l’erreur soit évidente la première fois et facile à manquer quand cela arrive à une ligne sur quatre cents.

L’archive est décompressée, analysée et réécrite dans cet onglet de navigateur. Rien n’est transmis, ce que l’onglet réseau confirmera pendant qu’une conversion tourne, et la page continue de fonctionner sans connexion. Il n’y a pas de compte à créer et pas de fichier qui reste dans une file d’attente ensuite.

Pour cette paire, l’argument est autant contractuel que personnel. Un KMZ d’un client, d’un service public ou d’un organisme public arrive souvent sous des conditions sur l’endroit où il peut être stocké, et le coller dans un convertisseur web gratuit est exactement le type de transfert que ces conditions sont faites pour empêcher. Faire la conversion en local signifie qu’il n’y a pas de tiers à nommer, et pas d’accord de traitement à aller chercher.