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).
La tabella
Sezione intitolata “La tabella”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.
La definizione
Sezione intitolata “La definizione”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). |
La forma di ritaglio
Sezione intitolata “La forma di ritaglio”clip ritaglia le immagini su una forma man mano che ogni tessera viene caricata:
ringssono 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.
Controlli all’importazione
Sezione intitolata “Controlli all’importazione”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.
Crearne uno da un pacchetto ArcGIS Pro
Sezione intitolata “Crearne uno da un pacchetto ArcGIS Pro”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.
-
Servono Python 3.10 o successivo e
bsdtar(libarchive; legge il contenitore 7-Zip del pacchetto). Nient’altro. -
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" -
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 (
GoogleMapsCompatiblequando 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. |