GeoPackage für Webkarten-Ebenen
Ein GeoPackage für Webkarten-Ebenen bringt Webkarten-Ebenen (Links auf öffentliche Kacheldienste, mit ihren Quellenangaben und optionalen Schnittformen) von einem Raum in einen anderen oder aus ArcGIS Pro in einen Raum. Es enthält keine Bilder und bleibt daher klein: Das umgewandelte Beispiel unten hat etwa 100 KB.
Es ist ein gewöhnliches GeoPackage, dessen einzige zusätzliche Tabelle comap_service_layers ist.
Raum-Exporte enthalten dieselbe Tabelle neben den übrigen Daten des Raums. Eine Datei mit nur dieser
Tabelle ist ein vollständiger Import: In den Raum importieren fügt ihre Webkarten-Ebenen samt
Schnittformen hinzu und sonst nichts (siehe
Ebene hinzufügen).
Die Tabelle
Abschnitt betitelt „Die Tabelle“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);Die übrigen Spalten dienen nur dazu, die Datei in einem GeoPackage-Werkzeug zu betrachten; ein Import liest
allein definition.
Die Definition
Abschnitt betitelt „Die Definition“definition enthält die Ebene so, wie der Raum sie speichert:
{ "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]]] }}| Feld | Bedeutung |
|---|---|
id |
Die Kennung der Ebene, svc- gefolgt von einer UUID. Beim Import bleibt sie erhalten, außer der Raum hat schon eine Ebene mit dieser Kennung; dann bekommt die Ebene eine neue. |
name, description |
Klartext, angezeigt im Tab Ebenen. |
kind |
wmts (aus einem Capabilities-Dokument aufgelöst) oder xyz. |
template |
Die Kachel-URL: https auf einem öffentlichen Hostnamen, mit genau einem {z}, einem {x} und einem {y} (oder {-y} für von Süden gezählte Zeilen). Höchstens 2048 Zeichen. |
tileSize, minZoom, maxZoom |
Kachelgröße in Pixeln (256 oder 512) und die Zoomstufen, die der Dienst anbietet. |
bounds |
Optional [West, Süd, Ost, Nord] in Grad; außerhalb werden keine Kacheln angefordert. |
attribution |
Die Quellenangabe, Klartext, Pflicht. Sie erscheint auf der Karte, solange die Ebene sichtbar ist. |
opacity, visible |
Anzeigeeinstellungen, 0–1 und true oder false. |
eventDate |
Optionales Aufnahmedatum, in Millisekunden seit 1970. |
createdAt |
Zeitpunkt, zu dem die Definition geschrieben wurde, in Millisekunden seit 1970. |
provenance |
Herkunft einer WMTS-Vorlage: Capabilities-URL, Ebene, Stil, Kachelraster, Format und Titel. Nur zur Information. |
clip |
Optionale Schnittform (siehe unten). |
Die Schnittform
Abschnitt betitelt „Die Schnittform“clip schneidet die Bilder beim Laden jeder Kachel auf eine Form zu:
ringssind geschlossene Ringe (der erste Punkt wird am Ende wiederholt) aus[Länge, Breite]in Grad, innerhalb der Web-Mercator-Breiten (etwa ±85°).- Sie werden nach der Gerade-Ungerade-Regel gefüllt: Ein Punkt liegt innen, wenn ihn eine ungerade Zahl von Ringen umschließt. Ein Loch ist einfach ein weiterer Ring, in beliebiger Reihenfolge und Orientierung.
- Höchstens 1000 Ringe und insgesamt 10 000 Punkte.
- Eine Form, die gegen diese Regeln verstößt, lässt den Import die ganze Ebene überspringen, statt sie ungeschnitten zu zeigen.
Fehlt bounds, gilt das umschließende Rechteck der Form.
Prüfungen beim Import
Abschnitt betitelt „Prüfungen beim Import“Ein GeoPackage ist eine nicht vertrauenswürdige Eingabe, daher wird jede Definition mit denselben Regeln geprüft wie im Dialog Ebene hinzufügen. Eine Definition, die durchfällt, wird übersprungen; unbekannte Felder werden verworfen. Gelesen werden höchstens 500 Definitionen, jede bis 512 KiB und zusammen bis 8 MiB. Ein Import ruft nie eine Kachel oder das Capabilities-Dokument ab.
Aus einem ArcGIS-Pro-Paket erzeugen
Abschnitt betitelt „Aus einem ArcGIS-Pro-Paket erzeugen“Der Konverter python-geo-service/tools/web_map_package.py (im Quellcode der App) liest ein
ArcGIS-Pro-Projektpaket (.ppkx oder ein einzelnes .aprx) und schreibt ein GeoPackage für
Webkarten-Ebenen. Er übernimmt die WMTS-Ebene der Karte und, wenn die Karte auf eine eigene Form
zugeschnitten ist (in ArcGIS Pro Layer zuschneiden auf eine benutzerdefinierte Form), diese Form als
Schnittform.
-
Sie benötigen Python 3.10 oder neuer und
bsdtar(libarchive; es liest den 7-Zip-Container des Pakets). Sonst nichts. -
Starten Sie den Konverter mit dem Paket und einer neuen Ausgabedatei:
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" -
Importieren Sie die neue Datei im Tab Export / Import in den Raum.
Was er tut:
- Er liest das Capabilities-Dokument einmal, um die Kachel-URL aufzulösen, nach den Regeln des Tabs
Webkarte: ein Web-Mercator-Kachelraster (
GoogleMapsCompatible, wenn der Dienst es anbietet), dessen Zoombereich und das Aufnahmedatum aus dem Titel der Ebene. - Die Form muss ein Polygon in einer Web-Mercator- oder WGS-84-Karte sein. Kurven müssen zuvor in ArcGIS Pro verdichtet werden. Koordinaten werden auf 6 Dezimalstellen (etwa 10 cm) gerundet.
- Die Beschreibung hält den SHA-256 des Pakets, das Projekt, die Karte und die Ebene fest.
- Er überschreibt nie eine Datei und ruft nur öffentliche https-Capabilities-URLs ab.
| Option | Zweck |
|---|---|
--name |
Der Name der Ebene im Raum (Standard: der Name der ArcGIS-Ebene). |
--attribution |
Die Quellenangabe (Standard: Anbieter und Titel der Ebene). Prüfen Sie die Bedingungen des Anbieters. |
--matrix-set |
Das Kachelraster, wenn Sie ein anderes als GoogleMapsCompatible brauchen. |
--map, --layer |
Welche Karte und welche WMTS-Ebene, wenn das Projekt mehrere hat. |
--capabilities FILE |
Ein gespeichertes Capabilities-Dokument statt der URL lesen. |