Convertire KML in KMZ

KMZ è stato progettato per risolvere un problema di confezionamento. Un KML che usa grafiche personalizzate per i pin, una sovrapposizione fotografica o una scansione georeferenziata si riferisce a quei file per percorso relativo, e nel momento in cui il documento viene inviato via email da solo i riferimenti si rompono e la mappa arriva vuota. Impacchettare il documento e le sue risorse in un unico archivio risolve questo, ed è il motivo per cui il formato esiste.

La seconda ragione è più semplice : un KML è testo verboso e il testo si comprime. Se il vostro documento non ha risorse esterne — un insieme di pin, un percorso disegnato, un export da un database — allora il confezionamento non è ciò che state comprando e la dimensione sì. Questo è il caso che questa conversione serve, e lo serve bene, ma vale la pena nominare quale dei due state effettivamente cercando prima di convertire.

Misurato su un KML che contiene una singola linea di 7.200 vertici con elevazione su ogni punto, il documento era circa 258 KB e l’archivio circa 47 KB — un fattore di cinque e mezzo. Gli elenchi di coordinate sono vicini al caso ideale per un deflate : ogni voce condivide un prefisso con quella precedente, i separatori si ripetono all’infinito, e le cifre che variano stanno nelle posizioni basse.

Un documento fatto di molti placemark brevi si comprime meno bene, perché il rapporto è dominato dal markup degli elementi ripetuti piuttosto che dai numeri, e un documento che è per lo più prosa nei fumetti descrittivi si comprime come prosa. Nessuna di queste distinzioni cambia molto la decisione, ma la garanzia è più stretta di quanto sembri. Lo scrittore mantiene la forma non compressa quando il deflate non aiuterebbe, quindi il payload non cresce mai — è la struttura ZIP attorno che lo fa. Un header locale, una voce di directory centrale e il record finale costano 112 byte per un file chiamato doc.kml, e il KML dentro è riscritto piuttosto che copiato byte per byte, quindi un documento molto piccolo può uscire un po’ più grande di quanto era entrato. Sopra qualche kilobyte è rumore.

Questa è la parte da capire prima di convertire. La conversione non prende il vostro KML e lo zippia. Paresa il documento nella stessa forma interna attraverso cui passa ogni formato GPS di questo sito — punti con una posizione, un’elevazione facoltativa, un tempo facoltativo, raggruppati in linee e pin nominati — e scrive un KML fresco da quella forma, che poi comprime.

La conseguenza è che il KML dentro l’archivio non è byte-identico al vostro, e nella maggior parte dei casi non è nemmeno vicino. Sarà più corto, i suoi elementi saranno in un ordine diverso, e tutto ciò che la forma interna non ha spazio per sarà assente. Se si dezippa il risultato aspettandosi di trovare il proprio file, non lo si troverà : si troverà un documento minimale pulito che descrive la stessa geometria.

Specificamente : le definizioni `<Style>` e `<StyleMap>` e i riferimenti `styleUrl` ad esse, quindi i colori delle linee, le larghezze e le icone personalizzate sono spariti. I fumetti `<description>`, incluso qualsiasi HTML in essi. `<ExtendedData>` e i campi personalizzati tipizzati da schema, che è dove di solito vive qualcosa di derivato da database. Il raggruppamento `<Folder>`, poiché la forma interna ha un elenco piatto. `<LookAt>` e `<Camera>`, quindi la vista scelta dall’autore non viene ripristinata. `<NetworkLink>`, `<GroundOverlay>` e `<ScreenOverlay>` interamente.

Ciò che sopravvive è la geometria e le etichette : ogni Point diventa un Placemark con un Point, ogni LineString e gx :Track diventa un Placemark con un LineString, e ciascuno mantiene il `<name>` che aveva. Il nome del documento è portato. Per un file il cui contenuto è dove stanno le cose e come si chiamano, è tutto. Per una mappa di presentazione stilizzata, è una piccola frazione, e la sezione successiva è la rotta migliore.

Se il KML porta stile o descrizioni di cui avete bisogno, il pacchetto fedele è uno che fate a mano. Si rinomini il documento in `doc.kml`, lo si aggiunga a un archivio ZIP in modo che stia alla radice piuttosto che dentro una cartella, e si rinomini l’archivio da `.zip` a `.kmz`. Ogni sistema operativo può fare entrambi i passi senza software extra, e il risultato è un KMZ il cui documento è il vostro documento, invariato.

La posizione alla radice è il dettaglio che le persone sbagliano. Un KMZ il cui KML sta una cartella più in basso si apre in alcuni lettori e fallisce silenziosamente in altri, e il fallimento sembra una mappa vuota piuttosto che un errore. Se avete costruito l’archivio cliccando col tasto destro su una cartella, è quello che è successo — selezionate il file stesso, non la cartella attorno.

Un `<NetworkLink>` è un KML che non contiene dati : contiene un URL e istruzioni per rinfrescarlo, e tutto ciò che vedete quando lo aprite è stato recuperato da un server dopo che il file è stato caricato. Gli strati di traffico live, i dataset in abbonamento e le mappe condivise del team sono tutti costruiti in questo modo, e il file su disco è spesso solo qualche kilobyte.

Dato a questa conversione, un file del genere non produce placemark né linee, e il risultato è il messaggio che non sono stati trovati track o waypoint. Questo è l’esito corretto piuttosto che un fallimento di parsing, e vi dice qualcosa di utile : la mappa che stavate guardando non era mai nel file, quindi non c’è nulla di locale da comprimere e nessuna copia offline da fare. Scaricare la risorsa collegata è l’unico modo per ottenere i dati stessi.

Google Earth, salvando un KMZ, attraversa il documento per ogni risorsa referenziata e copia ognuna nell’archivio, riscrivendo i percorsi mentre procede. Quel passo di raccolta è la sostanza di ciò che fa uno strumento di authoring KMZ, e questa conversione non ci prova.

L’output contiene un documento e nessuna risorsa, quindi un KML che fa riferimento a file di icone locali produce un archivio più piccolo del previsto e incompleto come pacchetto. Dato che lo stile che le referenziava è stato scartato durante la riscrittura comunque, le due limitazioni si cancellano in un risultato coerente piuttosto che in un file mezzo rotto : ciò che si ottiene è geometria piatta, disegnata con l’aspetto predefinito del lettore, e nulla di pendente.

La compressione non è l’unico modo per rendere gestibile un KML grande, e a volte è quello sbagliato. Un documento da 40 MB che è lento in Google Earth è lento per il numero di feature che disegna, e comprimerlo a 7 MB cambia il tempo di trasferimento e nulla sul rendering — si decomprime agli stessi 40 MB prima che qualcosa appaia.

Se il problema è la performance piuttosto che il trasferimento, le correzioni sono strutturali : si divida il file per regione o per strato così ognuno si carica da solo, si assottiglino le linee dense che portano un vertice ogni metro, o si spostino i dati in un formato costruito per il volume. Se il problema è genuinamente che un’email non porterà l’allegato o un modulo di caricamento ha un tetto, l’archivio è esattamente adatto e questa conversione è il modo più veloce per arrivarci.

Convertire l’archivio di nuovo in KML dopo restituisce il documento minimale, non il file da cui siete partiti. La riscrittura è avvenuta all’ingresso, e nulla a valle può ripristinare un blocco di stile, un fumetto descrittivo o un campo personalizzato che è stato scartato prima che lo zip fosse scritto. Le due conversioni si compongono in un passo lossy piuttosto che cancellarsi a vicenda.

Questo è il motivo pratico per conservare l’originale piuttosto che trattare l’archivio come suo sostituto. Lo spazio di archiviazione non è il vincolo — il documento sorgente è il più grande dei due di un fattore di cinque e comunque misurato in centinaia di kilobyte — ed è l’unica copia che contiene lo stile, la struttura delle cartelle e i campi del database. Si tratti il KMZ come si tratterebbe un PDF esportato da un documento : la cosa che si consegna, non la cosa che si mantiene.

Il documento viene parsato, riscritto e zippato in questa scheda del browser. Nessuna richiesta lo porta da qualche parte, il che può essere confermato nel pannello di rete durante una conversione, e la pagina continua a funzionare con la connessione disattivata.

Questo vale più del solito per questa coppia specifica, perché l’alternativa ovvia è un sito web di compressione file. Un KML di siti, clienti, asset o proprietà è dato aziendale con localizzazioni allegate, e la solita strada per renderlo più piccolo comporta consegnarlo al server di uno sconosciuto, aspettare, e scaricarlo indietro. Fare lo zip in locale rimuove quel salto piuttosto che chiedervi di essere a vostro agio con esso.