Dans EarthRanger, l'intégration de fonds de carte WMS (Web Map Service) nécessite la création d'une URL de service basée sur les fonctionnalités du service WMS. Ce guide vous guidera pas à pas pour créer une URL de service WMS fonctionnelle à utiliser dans EarthRanger, en veillant à ce qu'elle inclue les paramètres nécessaires à un rendu cartographique correct.
 

Introduction à la création d'une URL WMS

Lorsque vous utilisez un service WMS, la première étape consiste à obtenir la réponse GetCapabilities, qui fournit les informations nécessaires à la création de votre URL WMS. Cela se fait généralement en ajoutant ?service=wms&request=getcapabilities à l'URL de votre service WMS. Par exemple :

https://ortos.dgterritorio.gov.pt/wms/ortosat2023?service=wms&request=getcapabilities

La réponse GetCapabilities sera au format XML et répertoriera les paramètres disponibles que vous utiliserez pour construire l'URL WMS complète pour intégrer le fond de carte dans EarthRanger.
 

Construction de l'URL WMS

Après avoir reçu le XML GetCapabilities, vous construirez l'URL WMS finale en incluant divers paramètres qui sont soit explicitement répertoriés dans les capacités, soit fixés par la norme WMS.

Exemple d'URL finale :
https://ortos.dgterritorio.gov.pt/wms/ortosat2023?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&FORMAT=image/png&TRANSPARENT=true&LAYERS=OrtoSat2023&STYLES=&WIDTH=256&HEIGHT=256&CRS=EPSG:3857&BBOX={bbox-epsg-3857}

Décomposition des paramètres d'URL

Voici une explication détaillée de chaque paramètre inclus dans l'URL WMS :

1. URL de base : https://ortos.dgterritorio.gov.pt/wms/ortosat2023?

• Source : Extrait de la balise XML GetCapabilities <OnlineResource>.
• Explication : Il s'agit du point de terminaison de base pour les requêtes GetMap WMS.

2. SERVICE=WMS: SERVICE=WMS

• Source : Corrigé par la norme WMS.
• Explication : Toujours définir sur WMS, comme l'exige la spécification WMS.

3. VERSION=1.3.0: VERSION=1.3.0

• Source : Extrait du nœud racine <WMS_Capabilities>.
• Explication : Ceci indique la version de la spécification WMS prise en charge par le service.
   

4. REQUEST=GetMap: REQUEST=GetMap

• Source : Corrigé par la norme WMS.
• Explication : Il s'agit du type de requête permettant de récupérer des images de carte.

5. FORMAT=image/png: FORMAT=image/png

• Source : sélectionnée parmi les formats répertoriés sous <GetMap> dans le document des fonctionnalités XML.
• Explication : Spécifie le format d'image de la carte. Le format image/png est sélectionné ici et peut également être un JPG ou un JPEG.

6. TRANSPARENT=true: TRANSPARENT=true

• Source : Paramètre facultatif défini par l'utilisateur.
• Explication : Cela garantit la transparence de l'arrière-plan de la carte, utile pour la superposition de cartes.

7. LAYERS=OrtoSat2023: LAYERS=OrtoSat2023

• Source : Extrait de la définition <Layer> en XML.
• Explication : Spécifie la couche à afficher, dans ce cas, OrtoSat2023.

8. STYLES=: STYLES=

• Source : Requis par la norme WMS, mais laissé vide si aucun style spécifique n'est défini.
• Explication : Étant donné qu'aucun style spécifique n'est défini dans le XML, laissez ce champ vide.

9. WIDTH=256 & HEIGHT=256: WIDTH=256&HEIGHT=256

• Source : Définie par le client dans les limites spécifiées dans le XML.
• Explication : Ces valeurs déterminent la taille de l'image cartographique demandée. En général, 256 x 256 pixels est une taille standard.

10. CRS=EPSG:3857: CRS=EPSG:3857 

• Source : Extrait des balises <CRS> des métadonnées de la couche dans le XML.
• Explication : Spécifie le système de coordonnées de référence (CRS) utilisé pour la projection cartographique. EPSG:3857 est couramment utilisé pour les cartes web.

11. BBOX={bbox-epsg-3857}: BBOX={bbox-epsg-3857} 

• Source : Généré dynamiquement par le client lors de l'exécution.
• Explication : Ce paramètre représente le cadre de délimitation de l'image cartographique, généralement fourni sous la forme {bbox-epsg-3857} dans la plupart des frameworks de cartographie.
   

Up Next: Exporting and Preparing EarthRanger Data