Salta ai contenuti
IT

GeoPackage per livelli di mappa web

Un GeoPackage per livelli di mappa web porta livelli di mappa web (link a servizi di tessere pubblici, con i loro crediti e le eventuali forme di ritaglio) da una stanza a un’altra, oppure da ArcGIS Pro in una stanza. Non contiene immagini e resta quindi piccolo: l’esempio convertito qui sotto pesa circa 100 KB.

È un GeoPackage comune la cui unica tabella aggiuntiva è comap_service_layers. Le esportazioni di stanze contengono la stessa tabella accanto agli altri dati della stanza. Un file che contiene solo questa tabella è un’importazione completa: Importa nella stanza aggiunge i suoi livelli di mappa web, con le forme di ritaglio, e nient’altro (vedi Aggiungere un livello).

CREATE TABLE comap_service_layers (
layer_id TEXT PRIMARY KEY,
name TEXT,
kind TEXT, -- 'wmts' or 'xyz'
template TEXT,
attribution TEXT,
definition TEXT NOT NULL -- the layer as JSON; the only column an import reads
);

Le altre colonne servono solo a consultare il file in uno strumento GeoPackage; un’importazione legge solo definition.

definition contiene il livello come lo salva la stanza:

{
"id": "svc-6f1b2a3c-…",
"name": "SWISSIMAGE_LEAF_ON",
"kind": "wmts",
"template": "https://wayback.maptiles.arcgis.com/arcgis/rest/services/World_Imagery/WMTS/1.0.0/GoogleMapsCompatible/MapServer/tile/13968/{z}/{y}/{x}",
"tileSize": 256,
"minZoom": 0,
"maxZoom": 18,
"bounds": [5.950367, 45.88915, 8.403069, 47.165493],
"attribution": "Esri, Maxar, Earthstar Geographics, and the GIS User Community",
"opacity": 1,
"visible": true,
"eventDate": 1711584000000,
"createdAt": 1791871458688,
"description": "Converted from DeadwoodPackage.ppkx (SHA-256 99651860…), project p30/WMS_Test.aprx, map Map, …",
"provenance": {
"capabilitiesUrl": "https://wayback.maptiles.arcgis.com/arcgis/rest/services/World_Imagery/MapServer/WMTS/1.0.0/WMTSCapabilities.xml",
"layer": "WB_2024_R03", "style": "default", "matrixSet": "GoogleMapsCompatible", "format": "image/jpeg",
"title": "World Imagery (Wayback 2024-03-28)"
},
"clip": { "rings": [[[7.0, 46.0], [7.0, 47.0], [8.0, 47.0], [8.0, 46.0], [7.0, 46.0]]] }
}
Campo Significato
id L’identificativo del livello, svc- seguito da un UUID. Resta invariato all’importazione, a meno che la stanza abbia già un livello con lo stesso identificativo; allora il livello ne riceve uno nuovo.
name, description Testo semplice mostrato nella scheda Livelli.
kind wmts (ricavato da un documento di capabilities) oppure xyz.
template L’URL delle tessere: https su un nome host pubblico, con esattamente un {z}, un {x} e un {y} (oppure {-y} per righe contate da sud). Al massimo 2048 caratteri.
tileSize, minZoom, maxZoom Dimensione delle tessere in pixel (256 o 512) e livelli di zoom offerti dal servizio.
bounds Facoltativo, [ovest, sud, est, nord] in gradi; al di fuori non si richiedono tessere.
attribution I crediti, testo semplice, obbligatori. Compaiono sulla mappa finché il livello è visibile.
opacity, visible Impostazioni di visualizzazione, da 0 a 1 e true o false.
eventDate Data facoltativa delle immagini, in millisecondi dal 1970.
createdAt Momento in cui la definizione è stata scritta, in millisecondi dal 1970.
provenance Provenienza di un modello WMTS: URL delle capabilities, livello, stile, griglia di tessere, formato e titolo. Solo a titolo informativo.
clip Forma di ritaglio facoltativa (sotto).

clip ritaglia le immagini su una forma man mano che ogni tessera viene caricata:

  • rings sono anelli chiusi (il primo punto ripetuto alla fine) di [longitudine, latitudine] in gradi, entro le latitudini di Web Mercator (circa ±85°).
  • Sono riempiti con la regola pari-dispari: un punto è interno quando lo circonda un numero dispari di anelli. Un buco è semplicemente un anello in più, in qualsiasi ordine e verso.
  • Al massimo 1000 anelli e 10 000 punti in tutto.
  • Una forma che viola queste regole fa saltare l’intero livello all’importazione, invece di mostrarlo non ritagliato.

Senza bounds vale il rettangolo che racchiude la forma.

Un GeoPackage è un input non affidabile, quindi ogni definizione viene verificata con le stesse regole della finestra Aggiungi livello. Una definizione non valida viene saltata; i campi sconosciuti vengono scartati. Si leggono al massimo 500 definizioni, ciascuna fino a 512 KiB e 8 MiB in tutto. Un’importazione non richiede mai una tessera né il documento di capabilities.

Il convertitore python-geo-service/tools/web_map_package.py (nel codice sorgente dell’applicazione) legge un pacchetto di progetto ArcGIS Pro (.ppkx, oppure un semplice .aprx) e scrive un GeoPackage per livelli di mappa web. Prende il livello WMTS della mappa e, quando la mappa è ritagliata su una forma personalizzata (in ArcGIS Pro, Ritaglia layer su una forma personalizzata), quella forma come forma di ritaglio.

  1. Servono Python 3.10 o successivo e bsdtar (libarchive; legge il contenitore 7-Zip del pacchetto). Nient’altro.

  2. Avvia il convertitore con il pacchetto e un nuovo file di uscita:

    Terminal window
    python3 python-geo-service/tools/web_map_package.py DeadwoodPackage.ppkx swissimage-leaf-on.gpkg \
    --name SWISSIMAGE_LEAF_ON \
    --attribution "Esri, Maxar, Earthstar Geographics, and the GIS User Community"
  3. Importa il nuovo file nella stanza dalla scheda Esporta / importa.

Che cosa fa:

  • Legge una volta il documento di capabilities per ricavare l’URL delle tessere, con le regole della scheda Mappa web: una griglia di tessere Web Mercator (GoogleMapsCompatible quando il servizio la offre), il suo intervallo di zoom e la data delle immagini presa dal titolo del livello.
  • La forma deve essere un poligono in una mappa Web Mercator o WGS 84. Le curve vanno prima densificate in ArcGIS Pro. Le coordinate sono arrotondate a 6 decimali (circa 10 cm).
  • La descrizione registra lo SHA-256 del pacchetto, il progetto, la mappa e il livello.
  • Non sovrascrive mai un file e carica solo URL di capabilities https pubblici.
Opzione Uso
--name Il nome del livello nella stanza (predefinito: quello del livello ArcGIS).
--attribution I crediti (predefiniti: il fornitore e il titolo del livello). Verifica le condizioni del fornitore.
--matrix-set La griglia di tessere, se ne serve una diversa da GoogleMapsCompatible.
--map, --layer Quale mappa e quale livello WMTS, quando il progetto ne ha più d’uno.
--capabilities FILE Leggere un documento di capabilities salvato invece dell’URL.