Convertire KMZ in CSV

Chi apre un KMZ raramente lo ha creato. Arriva come allegato da un topografo, un'utility, un ufficio tecnico comunale o un ente del turismo, prodotto con lo strumento che quell'organizzazione usa abitualmente, e presuppone Google Earth dall'altra parte. Se serve solo aprire un ordine di lavoro o verificare un conteggio, installare un visualizzatore di globi per leggere trenta coordinate è uno scambio scomodo.

La conversione apre l'archivio, legge il documento al suo interno e restituisce posizioni e nomi come righe — abbastanza per incollare una coordinata in un modulo, incrociarla con un registro di asset o confermare che il file contenga davvero i diciotto siti dichiarati nella mail. Non restituisce la mappa: se serve la mappa, Google Earth resta lo strumento giusto.

Non esiste un modello dati proprio del KMZ. Il formato è un archivio ZIP il cui membro principale è un documento KML, e tutto ciò che un KMZ può esprimere è espresso da quel KML. L'archivio esiste perché una mappa possa viaggiare come un unico file insieme alle immagini a cui fa riferimento — icone personalizzate, una foto sovrapposta, una planimetria scansionata georiferita sul terreno.

Il lettore cerca prima `doc.kml`, il nome che scrive Google Earth, e ripiega sul primo membro che finisce in `.kml` se quel nome manca. Non è una cautela superflua: la specifica richiede solo che il documento principale sia un KML, e file esportati da altri strumenti portano nomi come `Siti_Fase2.kml`. Se nessun membro finisce in `.kml`, la conversione si ferma con un messaggio esplicito invece di produrre una tabella vuota.

Un KMZ da 4 MB quasi mai è fatto di 4 MB di coordinate. Il grosso è di solito una cartella `files/` o `images/` con icone PNG, una sovrapposizione JPEG, occasionalmente una planimetria scansionata larga qualche migliaio di pixel. Niente di tutto ciò finisce nel CSV, e non è un'omissione accidentale: una tabella non ha dove mettere un'immagine raster, e una colonna di nomi di file che puntano a file che non si possiedono più sarebbe peggio che niente.

La conseguenza pratica è che un KMZ il cui vero contenuto è un'immagine converte in un CSV quasi vuoto. Una planimetria georiferita con due marcatori d'angolo dà due righe e niente della planimetria. In quel caso l'archivio è un documento più che un insieme di dati, e va aperto a mano guardando l'immagine, non convertito di nuovo.

Ogni riga porta un tipo, un nome, una latitudine, una longitudine, una quota e un orario. Il tipo distingue un punto isolato da un vertice di una linea disegnata, ed è il primo filtro utile: un KMZ di posizioni di asset dovrebbe essere fatto interamente di righe `waypoint`, mentre un grande blocco di righe `track` segnala che il file contiene anche percorsi o confini.

Il nome è l'etichetta del placemark, ripetuta su ogni vertice di una linea in modo che filtrare una singola caratteristica da un file grande non richieda unioni tra tabelle. Latitudine e longitudine sono in gradi decimali, il formato che una casella di ricerca cartografica, un sistema di flotta e un'API di geocodifica accettano direttamente. Quota e orario sono spesso vuoti, perché una mappa disegnata a mano non registra nessuno dei due, e vuoto è l'output corretto per un valore che la sorgente non aveva mai avuto.

Cambiare l'estensione in `.zip` e fare doppio clic è un modo legittimo per vedere il contenuto, e vale la pena conoscerlo perché non costa nulla e conferma cosa sia davvero il file. Ogni sistema operativo desktop lo apre, e si vede il KML insieme alle immagini che viaggiavano con esso.

A quel punto si ha XML: coordinate scritte come terne `longitudine,latitudine,altitudine` unite in un unico elemento, avvolte in strutture di placemark e cartelle, con la longitudine per prima. È leggibile per chi cerca un singolo numero e inutilizzabile come insieme di dati. La conversione fa la seconda metà del lavoro — l'attraversamento dell'albero delle cartelle, la separazione delle coordinate, l'inversione in ordine latitudine-prima — che è la parte noiosa da fare a mano e facile da sbagliare.

La compressione rende la dimensione del file su disco un cattivo indicatore di quanto ci sia dentro. Il KML è testo ripetitivo, e si comprime insolitamente bene: un KML di circa 258 KB misurato qui si è compresso a circa 47 KB dentro l'archivio, un fattore di cinque e mezzo. Un KMZ da 3 MB può quindi contenere qualcosa come 15 MB di KML e diverse centinaia di migliaia di coordinate.

Il tetto gratuito di 100 MB si applica al KMZ così com'è, quindi in pratica il limite che si incontra per primo è la memoria della scheda del browser piuttosto che quel numero. Se un archivio grande si blocca, la diagnosi utile è rinominarlo in `.zip` e guardare la dimensione non compressa del membro KML — quella cifra, non la dimensione dell'archivio, è ciò che va analizzato e tenuto in memoria.

Due errori distinti producono qualcosa che sembra il nulla. Se l'archivio non contiene alcun membro KML, la conversione lo dice esplicitamente, e la causa è quasi sempre un file rinominato invece che esportato correttamente. Se il KML c'è ma non produce geometria, il messaggio è che non sono stati trovati percorsi o waypoint, un problema diverso con una causa diversa.

La causa più comune del secondo caso è che il file sia fatto di poligoni. Le aree — un confine di particella, una zona alluvionale, un'area di copertura — memorizzano il proprio contorno dentro un elemento `<Polygon>` che questo lettore non analizza, quindi un KMZ fatto solo di regioni ombreggiate non produce righe. I network link, che recuperano il contenuto da un URL invece di conservarlo nel file, tornano vuoti per un motivo più radicale: l'archivio non contiene davvero alcun dato.

Il nome di ogni placemark passa nel CSV. Quasi nient'altro di ciò che un'esportazione professionale contiene arriva con esso, ed è l'omissione più probabile da notare su questo tipo di file: il numero dell'asset, il diametro della tubazione, la data d'ispezione, il riferimento catastale e la nota del rilevatore vivono di solito nel fumetto `<description>` o in un blocco `<ExtendedData>`, e nessuno dei due viene letto. Un KMZ che sembrava ricco d'informazioni in Google Earth può convertire in una tabella di nomi e numeri con tutta la sostanza mancante.

Due strade la recuperano. Rinominare l'archivio in `.zip`, estrarre il KML e leggerlo — i campi estesi sono verbosi ma perfettamente leggibili, e un elemento `<SimpleData name="asset_id">` dice cosa sia. Oppure chiedere a chi ha inviato il file la tabella da cui il KMZ è stato generato, che quasi sempre esiste, perché un file con uno schema personalizzato del genere viene da un database e non da qualcuno che disegna su un globo.

Latitudine e longitudine sono scritte in gradi decimali con sei cifre, circa 11 centimetri di precisione — molto più fine di quanto i dati sorgente giustifichino, e abbastanza grossolano da tenere il file leggibile. Quel formato va direttamente nella casella di ricerca di qualsiasi sito cartografico, in un sistema di flotta o dispacciamento, e in un'API di geocodifica senza conversioni, che è di solito il motivo immediato per cui qualcuno voleva la tabella.

L'unica cosa da controllare è l'ordine che la destinazione si aspetta. Scritto come `45.464664, 9.188540` una ricerca cartografica legge prima la latitudine e arriva dove si intendeva. Un sistema costruito su GeoJSON o su una libreria GIS spesso vuole prima la longitudine, e scambiare la coppia sposta un punto a Milano in mezzo al Mediterraneo — abbastanza lontano che l'errore sia ovvio la prima volta e facile da perdere quando capita su una riga su quattrocento.

L'archivio viene scompattato, analizzato e riscritto dentro questa scheda del browser. Nulla viene trasmesso, cosa che il pannello Rete conferma durante una conversione, e la pagina continua a funzionare con la connessione spenta. Non c'è un account da creare e nessun file che resta in coda dopo.

Per questa coppia l'argomento è contrattuale oltre che personale. Un KMZ da un cliente, un'utility o un ente pubblico arriva spesso con condizioni su dove possa essere conservato, e incollarlo in un convertitore web gratuito è esattamente il tipo di trasferimento che quelle condizioni vogliono evitare. Farlo in locale significa che non c'è terza parte da nominare, né accordo di trattamento dati da andare a cercare.