ERDDAP
> wms
> Documentation
Le service de carte Web (WMS ) d' ERDDAP vous permet de demander une image avec des données tracées sur une carte.
WMS 
est un
Consortium Géospatial Ouvert (OGC ) 
et
ISO (19128) 
norme pour « la création et l'affichage de vues cartographiques enregistrées et superposées d'informations provenant simultanément de plusieurs sources distantes et hétérogènes ».
See the
list of datasets available via WMS at this ERDDAP installation.
Trois façons de créer des cartes avec WMS
- En théorie, n'importe qui peut télécharger, installer et utiliser le logiciel client WMS .
Certains clients sont :
ArcGIS
et
uDig
.
Pour que cela fonctionne, vous devez installer le logiciel sur votre ordinateur.
Ensuite, vous saisirez l'URL du service WMS dans le client.
Par exemple, dans ArcGIS (pas encore entièrement fonctionnel car il ne gère pas le temps !), utilisez « Arc Catalog :
Ajouter un service :
Dossier des serveurs Arc Catalog :
Serveurs SIG :
Ajouter un serveur WMS ».
Dans ERDDAP, chaque ensemble de données possède son propre service WMS, situé à l'adresse
https://cioosatlantic.ca/erddap/fr /wms/ datasetID / request ?
Par exemple :
https://cioosatlantic.ca/erddap/fr/wms/erdBAssta5day/request?
(Certains programmes clients WMS ne veulent pas que le ? soit placé à la fin de cette URL.) See the list of datasets available via WMS at this ERDDAP installation.
Dans la pratique, nous n'avons trouvé aucun client WMS qui gère correctement des dimensions autres que la longitude et la latitude (par exemple, le temps), une fonctionnalité spécifiée par la spécification WMS et utilisée par la plupart des ensembles de données des serveurs WMS d' ERDDAP .
Vous constaterez peut-être qu'en utilisant Faire un graphique et en sélectionnant le type de fichier .kml (une norme OGC ) pour charger les images dans
Google Earth
fournit un bon client cartographique (non WMS ).
See the list of datasets with Make A Graph at this ERDDAP installation.
- Les auteurs de pages Web peuvent intégrer un client WMS dans une page Web.
Par exemple, ERDDAP utilise
Leaflet
, qui est un client WMS très polyvalent, pour la page WMS de chaque ensemble de données ERDDAP (comme ça ).
See the list of datasets available via WMS at this ERDDAP installation.
Leaflet ne traite pas automatiquement les dimensions autres que la longitude et la latitude (par exemple, le temps), vous devrez donc écrire Java Script (ou un autre code de script) pour ce faire.
(Les programmeurs Java Script aventureux peuvent consulter le code source à partir d'une page Web comme ça .)
Un autre client Java Script WMS couramment utilisé est
OpenLayers
.
- Une personne disposant d'un navigateur ou d'un programme informatique peut générer des URL WMS spéciales.
Par exemple:
See the list of datasets available via WMS at this ERDDAP installation.
Voir les détails ci-dessous.
En pratique, il est plus facile, plus polyvalent et plus efficace d'utiliser le Faire un graphique page Web que d'utiliser WMS à cette fin.
See the list of datasets with Make A Graph at this ERDDAP installation.
Une requête GetCapabilities renvoie un document XML qui fournit des informations générales sur le service et des informations de base sur toutes les données disponibles à partir de ce service.
Pour cet ensemble de données, pour WMS version 1.3.0, utilisez
https://cioosatlantic.ca/erddap/fr/wms/erdBAssta5day/request?service=WMS&request=GetCapabilities&version=1.3.0
Les paramètres pris en charge pour une requête GetCapabilities sont :
nom=valeur * |
Description |
service=WMS |
Requis. |
version = version |
Actuellement, WMS d' ERDDAP prend en charge "1.1.0", "1.1.1" et "1.3.0".
Ce paramètre est facultatif.
La valeur par défaut est "1.3.0". |
request=GetCapabilities |
Requis. |
* Les noms de paramètres ne sont pas sensibles à la casse.
Les valeurs des paramètres sont sensibles à la casse et doivent être
codées en pourcentage 
:
tous les caractères des valeurs de requête autres que A-Za-z0-9_-!.~'()* doivent être codés en %HH, où HH est la valeur hexadécimale à 2 chiffres du caractère, par exemple, l'espace devient %20.
Les caractères au-dessus de #127 doivent être convertis en octets UTF-8, puis chaque octet UTF-8 doit être codé en pourcentage (demandez de l'aide à un programmeur).
Il existe des «
sites Web qui encodent/décodent en pourcentage pour vous 
.
Les paramètres peuvent être dans n'importe quel ordre dans l'URL, séparés par '&' .
Une personne disposant d'un navigateur ou d'un programme informatique peut générer une URL spéciale pour demander une carte.
L'URL doit être sous la forme
https://cioosatlantic.ca/erddap/fr /wms/
datasetID / request ?
requête
La requête pour une requête WMS GetMap se compose de plusieurs
paramètreName=value, séparés par '&'.
Par exemple,
https://cioosatlantic.ca/erddap/fr/wms/erdBAssta5day/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,erdBAssta5day:sst,Coastlines,Nations&styles=&format=image/png
Les options
de paramètre pour la requête GetMap sont :
nom=valeur * |
Description |
service=WMS |
Requis. |
version = version |
Demander la version.
Actuellement, WMS d' ERDDAP prend en charge "1.1.0", "1.1.1" et "1.3.0".
Requis. |
request=GetMap |
Nom de la demande.
Requis. |
layers = liste_couche |
Liste séparée par des virgules d'une ou plusieurs couches de carte.
Les calques sont dessinés dans l'ordre dans lequel ils apparaissent dans la liste.
Actuellement dans WMS d' ERDDAP, les noms de couches des ensembles de données sont nommés datasetID : Nom de variable .
Dans WMS d' ERDDAP, il existe cinq couches non basées sur les ensembles de données ERDDAP :
- "Land" peut être dessiné AVANT (en tant que sous-couche) ou APRÈS (en tant que masque de terrain) les couches à partir d'ensembles de données de grille.
- "Coastlines" doivent généralement être dessinés APRÈS les couches des jeux de données de grille.
- "LakesAndRivers" dessine des lacs et des rivières.
Cela doit généralement être dessiné APRÈS les couches des ensembles de données de grille.
- "Nations" tracent les frontières politiques nationales.
Cela doit généralement être dessiné APRÈS les couches des ensembles de données de grille.
- "States" tracent les frontières politiques des États.
Cela doit généralement être dessiné APRÈS les couches des ensembles de données de grille.
Requis. |
styles = liste_style |
Liste séparée par des virgules d'un style de rendu par couche demandée.
Actuellement dans WMS d' ERDDAP, le seul style proposé pour chaque couche est le style par défaut, qui est spécifié via "" (rien).
Par exemple, si vous demandez 3 calques, vous pouvez utiliser "styles=,,".
Ou, encore plus simple, vous pouvez demander le style par défaut pour tous les calques via "styles=".
Requis. |
1.1.0 : srs= espace de noms :identifiant
1.1.1 : srs= espace de noms :identifiant
1.3.0 :
crs= espace de noms :
identifiant |
Système de référence de coordonnées.
Actuellement dans WMS 1.1.0 d' ERDDAP, le seul SRS valide est EPSG:4326.
Actuellement dans WMS 1.1.1 d' ERDDAP, le seul SRS valide est EPSG:4326.
Actuellement dans WMS 1.3.0 d' ERDDAP, les seuls CRS valides sont CRS:84 et EPSG:4326,
Requis. |
bbox = 4commaSeparatedValues |
Coins du cadre de délimitation dans les unités SRS/CRS.
Pour la version=1.3.0 avec CRS=EPSG:4326, les 4 valeurs sont :
minLat,minLon,maxLat,maxLon.
Pour toutes les autres situations, les 4 valeurs sont :
minLon,minLat,maxLon,maxLat.
(L'ordre inverse ! Oui, c'est bizarre.
Bienvenue dans le monde de OGC !) ERDDAP prend en charge les requêtes dans la plage de longitude (peut-être 0 à 360, peut-être -180 à 180) et de latitude de l'ensemble de données.
La plupart des clients WMS supposent que les valeurs de longitude sont comprises entre -180 et 180.
Si ERDDAP propose une variante d'un ensemble de données avec une longitude de -180 à 180, utilisez-la pour les requêtes WMS .
Requis. |
width = largeur_sortie |
Largeur en pixels de l'image de la carte.
Requis. |
height = hauteur_sortie |
Hauteur en pixels de l'image de la carte.
Requis. |
format = format_sortie |
Format de sortie de la carte.
Actuellement dans WMS d' ERDDAP, seul image/png est valide.
Requis. |
transparent=TRUE|FALSE |
Transparence d’arrière-plan de la carte.
Facultatif (par défaut= FALSE ).
Si TRUE, toute partie de l'image utilisant le BGColor sera rendue transparente. |
bgcolor = valeur_couleur |
Valeur de couleur hexadécimale 0xRRGGBB pour la couleur d’arrière-plan.
Facultatif (par défaut = 0xFFFFFF, blanc).
Si transparent=true, nous recommandons bgcolor =0x808080 (gris), puisque le blanc est présent dans certaines palettes de couleurs. |
exceptions = format_exception |
Le format des réponses aux exceptions WMS .
Facultatif.
Actuellement, WMS 1.1.0 et 1.1.1 d' ERDDAP prennent en charge "application/vnd.ogc.se_xml" (la valeur par défaut),
"application/vnd.ogc.se_blank" (une image vierge) et "application/vnd.ogc.se_inimage" (l'erreur dans une image).
Actuellement, WMS 1.3.0 d' ERDDAP prend en charge "XML" (la valeur par défaut), "BLANK" (une image vierge) et
"INIMAGE" (l'erreur dans une image). |
time = temps |
Valeur temporelle de la couche souhaitée, spécifiée au format ISO 8601 :
yyyy-MM-ddTHH:mm:ssZ .
Actuellement dans WMS d' ERDDAP, vous ne pouvez spécifier qu'une seule valeur temporelle par requête.
Dans WMS d' ERDDAP, la valeur la plus proche de la valeur que vous spécifiez (si elle est comprise entre min et max) sera utilisée.
Dans WMS d' ERDDAP, la valeur par défaut est la dernière valeur du tableau temporel 1D de l'ensemble de données.
Dans WMS d' ERDDAP, « actuel » est interprété comme la dernière heure disponible (récente ou non).
Facultatif (dans WMS d' ERDDAP, la valeur par défaut est la dernière valeur, qu'elle soit récente ou non). |
elevation = élévation |
Élévation de couche souhaitée.
Actuellement dans WMS d' ERDDAP, vous ne pouvez spécifier qu'une seule valeur d'élévation par requête.
Dans WMS d' ERDDAP, ceci est utilisé pour la dimension d'altitude ou de profondeur (convertie en altitude) (le cas échéant).
(en mètres, positif=haut)
Dans WMS d' ERDDAP, la valeur la plus proche de la valeur que vous spécifiez (si elle est comprise entre min et max) sera utilisée.
Facultatif (dans WMS d' ERDDAP, la valeur par défaut est la dernière valeur du tableau d'altitude ou de profondeur 1D de l'ensemble de données). |
dim_ nom = valeur |
Valeur des autres dimensions, le cas échéant.
Actuellement dans WMS d' ERDDAP, vous ne pouvez spécifier qu'une seule valeur par dimension et par requête.
Dans WMS d' ERDDAP, ceci est utilisé pour les dimensions non temporelles, non altitudes et non profondes.
Le nom d'une dimension sera "dim_" plus le nom de l'ensemble de données pour la dimension, par exemple "dim_model".
Dans WMS d' ERDDAP, la valeur la plus proche de la valeur que vous spécifiez (si elle est comprise entre min et max) sera utilisée.
Facultatif (dans WMS d' ERDDAP, la valeur par défaut est la dernière valeur du tableau 1D de la dimension).
|
* Les noms de paramètres ne sont pas sensibles à la casse.
Les valeurs des paramètres sont sensibles à la casse et doivent être
codées en pourcentage 
:
tous les caractères des valeurs de requête autres que A-Za-z0-9_-!.~'()* doivent être codés en %HH, où HH est la valeur hexadécimale à 2 chiffres du caractère, par exemple, l'espace devient %20.
Les caractères au-dessus de #127 doivent être convertis en octets UTF-8, puis chaque octet UTF-8 doit être codé en pourcentage (demandez de l'aide à un programmeur).
Il existe
des sites Web qui codent/décodent en pourcentage pour vous 
.
Les paramètres peuvent être dans n'importe quel ordre dans l'URL, séparés par '&' .
(Révisé à partir du tableau 8 de la spécification WMS 1.3.0)
- Exigences relatives à l'ensemble de données : Les principales exigences pour qu'une variable soit accessible via le serveur WMS d' ERDDAP sont :
- L'ensemble de données doit être un ensemble de données EDDGrid ....
- La variable de données DOIT être une variable quadrillée.
- La variable de données DOIT avoir des variables d'axe de longitude et de latitude.
(Les autres variables d'axe sont FACULTATIVES.)
- Il DOIT y avoir des valeurs de longitude comprises entre -180 et 180.
- Les
attributs colorBarMinimum et colorBarMaximum DOIVENT être spécifiés.
(Les autres attributs de la barre de couleur sont FACULTATIFS.)
- Couches de données de grille : dans WMS d' ERDDAP, toutes les variables de données des ensembles de données de grille qui utilisent les dimensions de longitude et de latitude sont disponibles via WMS .
Chacune de ces variables est disponible en tant que couche WMS, avec le nom datasetID : Nom de variable .
Chacune de ces couches est transparente (c'est-à-dire que les valeurs des données sont représentées sous forme d'une plage de couleurs et les valeurs manquantes sont représentées par des pixels transparents).
- Couches de données de table : actuellement dans WMS d' ERDDAP, les variables de données dans les ensembles de données de table ne sont pas disponibles via WMS .
- Dimensions : une conséquence de la conception WMS est que les valeurs TIME, ELEVATION et autres valeurs de dimension que vous spécifiez dans une requête GetMap s'appliquent à toutes les couches.
Il n'existe aucun moyen de spécifier des valeurs différentes pour différentes couches.
- Strict? Le tableau ci-dessus spécifie comment un client doit former une requête GetMap .
En pratique, WMS d' ERDDAP essaie d'être aussi indulgent que possible lors du traitement des requêtes GetMap, car de nombreux clients actuels ne suivent pas la spécification.
Cependant, si vous créez des URL GetMap, nous vous encourageons à essayer de suivre les spécifications.
- Pourquoi existe-t-il des serveurs WMS distincts pour chaque ensemble de données ? Étant donné que le document GetCapabilities répertorie toutes les valeurs de toutes les dimensions pour chaque ensemble de données, les informations pour chaque ensemble de données peuvent être volumineuses (facilement 300 Ko).
Si tous les ensembles de données maillés (actuellement ~ 1 000) du site principal ERDDAP devaient être inclus dans un seul WMS, le document GetCapabilities résultant serait énorme (~ 300 Mo), ce qui prendrait beaucoup de temps à télécharger (ce qui amènerait beaucoup de gens à penser que quelque chose avait tort et abandonnait) et submergerait la plupart des logiciels clients.
ERDDAP is compatible with the current WMS 1.3.0 standard.
ERDDAP is also compatible with the older
WMS 1.1.1 standard, which may be needed when working with older client software.
ERDDAP is also compatible with the older
WMS 1.1.0 standard, which may be needed when working with older client software.