GeoPackage de couches de carte web
Un GeoPackage de couches de carte web transporte des couches de carte web (des liens vers des services de tuiles publics, avec leurs crédits et d’éventuelles formes de découpe) d’une salle à une autre, ou d’ArcGIS Pro vers une salle. Il ne contient aucune imagerie et reste donc petit : l’exemple converti ci-dessous pèse environ 100 Ko.
C’est un GeoPackage ordinaire dont la seule table supplémentaire est comap_service_layers. Les exports de
salle contiennent la même table à côté des autres données de la salle. Un fichier qui ne contient que
cette table est un import complet : Importer dans la salle ajoute ses couches de carte web, avec leurs
formes de découpe, et rien d’autre (voir
Ajouter une couche).
La table
Section intitulée « La table »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);Les autres colonnes servent seulement à parcourir le fichier dans un outil GeoPackage ; un import ne lit
que definition.
La définition
Section intitulée « La définition »definition contient la couche telle que la salle l’enregistre :
{ "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]]] }}| Champ | Signification |
|---|---|
id |
L’identifiant de la couche, svc- suivi d’un UUID. Il est conservé à l’import, sauf si la salle a déjà une couche avec cet identifiant ; la couche en reçoit alors un nouveau. |
name, description |
Texte brut affiché dans l’onglet Couches. |
kind |
wmts (résolu à partir d’un document de capacités) ou xyz. |
template |
L’URL des tuiles : https sur un nom d’hôte public, avec exactement un {z}, un {x} et un {y} (ou {-y} pour des rangées comptées depuis le sud). 2 048 caractères au plus. |
tileSize, minZoom, maxZoom |
Taille des tuiles en pixels (256 ou 512) et niveaux de zoom proposés par le service. |
bounds |
Facultatif, [ouest, sud, est, nord] en degrés ; aucune tuile n’est demandée en dehors. |
attribution |
Le crédit, en texte brut, obligatoire. Il s’affiche sur la carte tant que la couche est visible. |
opacity, visible |
Réglages d’affichage, de 0 à 1 et true ou false. |
eventDate |
Date facultative de l’imagerie, en millisecondes depuis 1970. |
createdAt |
Moment où la définition a été écrite, en millisecondes depuis 1970. |
provenance |
Origine d’un modèle WMTS : URL des capacités, couche, style, grille de tuiles, format et titre. Pour information seulement. |
clip |
Forme de découpe facultative (ci-dessous). |
La forme de découpe
Section intitulée « La forme de découpe »clip découpe l’imagerie selon une forme à mesure que chaque tuile est chargée :
ringssont des anneaux fermés (le premier point répété à la fin) de[longitude, latitude]en degrés, dans les latitudes de Web Mercator (environ ±85°).- Ils sont remplis selon la règle pair-impair : un point est à l’intérieur quand un nombre impair d’anneaux l’entoure. Un trou est simplement un anneau de plus, dans n’importe quel ordre ou sens.
- Au plus 1 000 anneaux et 10 000 points au total.
- Une forme qui enfreint ces règles fait ignorer toute la couche à l’import, plutôt que de l’afficher sans découpe.
Sans bounds, c’est le rectangle englobant de la forme qui s’applique.
Contrôles à l’import
Section intitulée « Contrôles à l’import »Un GeoPackage est une donnée non fiable : chaque définition est donc vérifiée avec les mêmes règles que la fenêtre Ajouter une couche. Une définition refusée est ignorée ; les champs inconnus sont supprimés. Au plus 500 définitions sont lues, chacune jusqu’à 512 Kio et 8 Mio au total. Un import ne demande jamais de tuile ni le document de capacités.
En créer un à partir d’un paquet ArcGIS Pro
Section intitulée « En créer un à partir d’un paquet ArcGIS Pro »Le convertisseur python-geo-service/tools/web_map_package.py (dans le code source de l’application) lit
un paquet de projet ArcGIS Pro (.ppkx, ou un simple .aprx) et écrit un GeoPackage de couches de carte
web. Il reprend la couche WMTS de la carte et, quand la carte est découpée selon une forme personnalisée
(dans ArcGIS Pro, Découper les couches selon une forme personnalisée), cette forme comme forme de
découpe.
-
Il vous faut Python 3.10 ou plus récent et
bsdtar(libarchive ; il lit le conteneur 7-Zip du paquet). Rien d’autre. -
Lancez le convertisseur avec le paquet et un nouveau fichier de sortie :
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" -
Importez le nouveau fichier dans la salle depuis l’onglet Export / import.
Ce qu’il fait :
- Il lit une fois le document de capacités pour résoudre l’URL des tuiles, avec les règles de l’onglet
Carte web : une grille de tuiles Web Mercator (
GoogleMapsCompatiblequand le service la propose), sa plage de zoom et la date de l’imagerie tirée du titre de la couche. - La forme doit être un polygone dans une carte Web Mercator ou WGS 84. Les courbes doivent d’abord être densifiées dans ArcGIS Pro. Les coordonnées sont arrondies à 6 décimales (environ 10 cm).
- La description note le SHA-256 du paquet, le projet, la carte et la couche.
- Il n’écrase jamais un fichier et ne charge que des URL de capacités https publiques.
| Option | Usage |
|---|---|
--name |
Le nom de la couche dans la salle (par défaut : celui de la couche ArcGIS). |
--attribution |
Le crédit (par défaut : le fournisseur et le titre de la couche). Vérifiez les conditions du fournisseur. |
--matrix-set |
La grille de tuiles, si vous en voulez une autre que GoogleMapsCompatible. |
--map, --layer |
Quelle carte et quelle couche WMTS, quand le projet en a plusieurs. |
--capabilities FILE |
Lire un document de capacités enregistré au lieu de l’URL. |