sdi-proxy est un un proxy-cache facile à installer pour rediffuser des flux géographiques de "fonds de carte" (plans , photographies...). Il est basé sur le logiciel MapProxy. Il est préconfiguré avec les données de la Géoplateforme et des infrastructures locales de données de la communauté geOrchestra.
Les visualiseurs cartographiques sont dépendants des flux de "tuilage" qui servent plans et orthophotographies. En cas de panne de ceux-ci, l'utilisateur ne peut plus se repérer sur la carte et le visualiseur est pratiquement inutilisable. Il faut alors reconfigurer tous les contextes de carte, ce qui prend beaucoup de temps et n'est pas à la portée de tous les utilisateurs.
L'objectif de sdi-proxy est de proposer un proxy-cache pour les flux tuilés, qui :
- Est opérationnel en 5 minutes, avec un minimum de prérequis
- fournit dès le premier démarrage un large panel de fonds de carte
- présente des URLs stables alors que celles de la source peuvent changer
- redémarre vite, consomme peu de ressources
- peut subir une perte complète de stockage - logiciel et cache - et être à nouveau opérationnel rapidement
- réduit la charge sur les plateformes distantes, ou diminue l'impact de leur indisponibilité
- permet de débuter facilement avec MapProxy pour aller ensuite vers des configurations plus compliquées
Basé sur MapProxy en mode MultiMapProxy, sdi-proxy est déjà configuré pour servir les cartes orthophotopgraphies de la GéoPlateforme, et les cartes OpenStreetMap de GéoBretagne et DataGrandEst.
sdi-proxy est testé sur ubuntu/debian/wsl. Il nécessite :
- python3.8-venv
- gdal-bin
- un espace de stockage de 20 Go minimum. L'usage de systèmes de fichiers réseau est déconseillé.
apt install python3-pil python3-yaml python3-pyproj libgeos-dev
mkdir sdi-proxy
git clone https://git.geobretagne.fr/geobretagne/sdi-proxy/sdi-proxy.git
cd sdi-proxy
python3 -m venv venv
source ./venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
# facultatif
rmdir cache_data
ln -s /mon/gros/espace/de/stockage/ cache_data
./debug
Pointez votre navigateur vers http://127.0.0.1:5001 pour voir la page d'accueil avec la configuration par défaut.
(screenshot homepage)
sdi-proxy propose de répartir les données en "profils". Chaque profil dispose de ses propres services.
Quelques profils sont proposés par défaut, libre à vous d'en rajouter ou de les compléter :
osmoffre une sélection de fonds de plan fabriqués avec les données OpenStreetMap. Ils proviennent de plusieurs plateformes pour améliorer la résilience du service.geopfoffre les fonds de plan IGN, et plus généralement les plans disponibles par la GéoPlateforme.photooffre une sélection d'imageries aériennes et (à venir) satellite
| rendu | profil | identifiant | description | fournisseur |
|---|---|---|---|---|
 |
osm |
osm:grey |
niveau de gris pour une meilleure lecture des données | DataGrandEst |
 |
osm |
osm:default |
peu coloré | GéoBretagne |
 |
osm |
osm:google |
ressemble à google maps, sans maisons | GéoBretagne |
 |
osm |
osm:bing |
ressemble à bing maps, avec maisons | GéoBretagne |
 |
osm |
osm:faded |
couleurs pastel | DataGrandEst |
 |
osm |
osm:naturaliste |
avec éléments intéressant ce métier | DataGrandEst |
 |
photo |
HR.ORTHOIMAGERY.ORTHOPHOTO |
orthophotographie 20cm | Géoplateforme |
 |
photo |
ORTHOIMAGERY.ORTHOPHOTOS.IRC |
orthophotographie proche infrarouge 20cm | Géoplateforme |
 |
photo |
ORTHOIMAGERY.ORTHOPHOTOS.1950-1965 |
première campagne photo aérienne intégrale de la France | Géoplateforme |
 |
geopf |
GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2` | plan fabriqué automatiquement à partir des données IGN | Géoplateforme |
Le répertoire profiles-enabled contient les profils en production. Un profil toto.yaml crée automatiquement une page /toto/demo qui décrit les services de ce profil.
Pour activer/désactiver les profils, il est proposé d'utiliser dans profiles-enabled des liens symboliques vers les profils stockés dans profiles-available. La prise en compte est immédiate.
On suppose ici que sdi-proxy publie sur https://www.maplateforme.net/, et que le le profil est osm. Les points d'entrée des services sont :
Le Web Map Service fournit des cartes pour n'importe quelle emprise. Il est supporté par presque tous les logiciels cartographiques. Cependant est beaucoup plus lent que les services tuilés et ne devrait pas être utilisé pour servir plans et photographies.
-
capacités WMS : https://www.maplateforme.net/osm/service?SERVICE=WMS&REQUEST=GetCapabilities
-
point d'entrée du service : https://www.maplateforme.net/osm/service?
Le Web Map Tiled Service fournit des cartes selon des emprises décrites dans une grille, ce qui permet de les générer à l'avance. Il est beaucoup plus rapide que WMS mais demande au client de connaitre la grille de tuilage.
-
capacités WMS : https://www.maplateforme.net/osm/service?SERVICE=WMTS&REQUEST=GetCapabilities
-
point d'entrée du service : https://www.maplateforme.net/osm/service?
Le Tiled Map Service est similaire au WMTS avec un formalisme plus simple.
- point d'entrée du service : https://www.maplateforme.net/osm/tms/1.0.0
- GéoBretagne : https://tile.geobretagne.fr/
- ...
Mviewer est un visualiseur cartographique léger et entièrement personnalisable.
Pour ajouter un baselayer :
<baselayer
id="photo_actuelle"
type="WMTS"
url="https://tile.geobretagne.fr/photo/service"
layers="HR.ORTHOIMAGERY.ORTHOPHOTO"
matrixset="PM"
format="image/png"
style="default"
fromcapacity="false"
title="Ortho 20 cm"
visible="false"
thumbgallery="https://tile.geobretagne.fr/photo/tms/HR.ORTHOIMAGERY.ORTHOPHOTO/EPSG3857/16/64287/85957.png"
label="Ortho actuelle IGN"
attribution="IGN"
/>Mapfishapp est le visualiseur historique de geOrchestra. Il utilise des contextes OGC:WMC qui ne permettent d'enregistrer que des flux WMS. Pour bénéficier du cache, utiliser les options vendeur suivantes :
<Extension>
<ol:maxExtent xmlns:ol="http://openlayers.org/context" minx="-20037508.342789244" miny="-20037508.342789244" maxx="20037508.342789244" maxy="20037508.342789244" />
<ol:transparent xmlns:ol="http://openlayers.org/context">false</ol:transparent>
<ol:numZoomLevels xmlns:ol="http://openlayers.org/context">22</ol:numZoomLevels>
<ol:units xmlns:ol="http://openlayers.org/context">m</ol:units>
<ol:isBaseLayer xmlns:ol="http://openlayers.org/context">false</ol:isBaseLayer>
<ol:tileSize xmlns:ol="http://openlayers.org/context" width="256" height="256" />
<ol:singleTile xmlns:ol="http://openlayers.org/context">false</ol:singleTile>
<ol:gutter xmlns:ol="http://openlayers.org/context">0</ol:gutter>
</Extension>Couche/ajouter une couche/ajouter une couche WMS/WMTSNouveau: préciser l'adresse complète des capacités WMTS, par exemple https://tile.geobretagne.fr/photo/service?SERVICE=WMTS&REQUEST=GetCapabilities
La connexion au service présente alors toutes les données disponibles.
[!CAUTION] Si vous saisissez l'adresse partielle https://tile.geobretagne.fr/photo/service, QGIS suppose que WMS est demandé : la performance sera médiocre.
L'adresse du service dépend de la donnée.
Couche/ajouter une couche/ajouter une couche XYZConnexion: préciser l'adresse XYZ, par exemple https://tile.geobretagne.fr/photo/wmts/HR.ORTHOIMAGERY.ORTHOPHOTO/PM/{z}/{x}/{y}.png
Inclure le fragment suivant dans la configuration de l'hôte :
location / {
proxy_pass http://hostnamehere:5000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Avec un chemin, par exemple : /tuileur :
location /tuileur {
proxy_pass http://hostnamehere:5000;
proxy_set_header Host $host;
proxy_set_header X-Script-Name /tuileur;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Se référer à la documentation https://mapproxy.github.io/mapproxy/deployment.html
[Unit]
Description=sdi-proxy via gunicorn
After=network.target
[Service]
PIDFile=/tmp/sdi-proxy.pid
User=www-data
Group=www-data
WorkingDirectory=/path/to/sdi-proxy/
ExecStart=/path/to/sdi-proxy/venv/bin/gunicorn -w 8 -b 0.0.0.0:5000 --pid=/tmp/sdi-proxy.pid config:application
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
Restart=always
[Install]
WantedBy=multi-user.target
MapProxy embarque l'utilitaire mapproxy-seed pour gérer la prégénération et l'expiration des tuiles stockées en cache.
[!TIP] Il n'est généralement pas utile de prégénérer les tuiles issues de WMTS (Géoplateforme par exemple) : les performances sont satisfaisantes dès le début.
Pour les tuiles issues de WMS lents, il est conseillé de prégénérer jusqu'au niveau 13 (données peu utilisées) voire 15 (données souvent utilisées).
sdi-proxy propose un remplissage optionnel par région française afin de ne pas surcharger le cache avec des tuiles peu utilisées. Les contours de toutes les régions sont décrits dans profiles-available/france.geojson. Le fichier de seed profiles-available/osm.seed comporte un filtre sur le code région. Modifier ce code pour cibler une région.
coverages:
region1:
datasource: france.geojson
where: code = '53'
srs: EPSG:4326
Pour lancer la prégénération, depuis la racine du projet :
source ./venv/bin/activate
cd profiles-available
mapproxy-seed -f osm.yaml -s osm.seed
[!CAUTION]
Par respect pour les fournisseurs, ne prégénérez pas les données que vous n'avez pas l'intention d'utiliser. Supprimez-les des fichiers .seed avant de lancer la prégénération.
- MapProxy et ses nombreux contributeurs
- Géoplateforme : orthophotographies, plan
- DataGrandEst : carte OpenStreetMap
- GéoBretagne : carte OpenStreetMap, tests
- Georchestra et sa communauté : tests et soutien
- Mviewer pour les tests
Les contributions sont les bienvenues. Les propositions doivent respecter les considérations suivantes :
- la reconfiguration des clients est coûteuse et doit être réduite au maximum
- les données doivent couvrir au moins la France métropolitaine
- les caches peuvent être purgés à tout moment, sans préjudice autre qu'une réduction de performances