Zum Inhalt springen
DE

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).

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.

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).

clip schneidet die Bilder beim Laden jeder Kachel auf eine Form zu:

  • rings sind 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.

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.

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.

  1. Sie benötigen Python 3.10 oder neuer und bsdtar (libarchive; es liest den 7-Zip-Container des Pakets). Sonst nichts.

  2. 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"
  3. 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.