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
Open Geospatial Consortium (OGC ) et
ISO (19128) norme pour « la création et l'affichage de vues d'informations de type carte enregistrées et superposées qui proviennent 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, tout le monde peut télécharger, installer et utiliser le logiciel client WMS .
Certains clients sont :
ArcGIS et
uDig .
Pour les faire fonctionner, vous devez installer le logiciel sur votre ordinateur.
Ensuite, vous devez entrer l'URL du service WMS dans le client.
Par exemple, dans ArcGIS (qui ne fonctionne pas encore complètement car il ne gère pas le temps !), utilisez "Arc Catalog :
Ajouter un service :
Arc Catalog Servers Folder :
GIS Servers :
Add WMS Server".
Dans ERDDAP, chaque jeu de données a son propre service WMS, qui est situé à
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 du ? à la fin de cette URL.) See the list of datasets available via WMS at this ERDDAP installation.
En pratique, nous n'avons trouvé aucun client WMS qui gère correctement les dimensions autres que la longitude et la latitude (par exemple, l'heure), une caractéristique qui est spécifiée par la spécification WMS et qui est utilisée par la plupart des ensembles de données dans les serveurs WMS d' ERDDAP .
Vous pouvez constater qu'en utilisant le 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, l'heure), vous devrez donc écrire du JavaScript (ou un autre code de script) pour le faire.
(Les programmeurs JavaScript aventureux peuvent consulter le code source à partir d'une page Web comme ça .)
Un autre client WMS JavaScript 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 d'un ensemble de données.
page Web que d'utiliser WMS à cette fin.
See the list of datasets with Make A Graph at this ERDDAP installation.
Une demande 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 * |
La description |
service=WMS |
Obligatoire. |
version = version |
Actuellement, le 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 |
Obligatoire. |
* Les noms de paramètres sont insensibles à 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 sous la forme %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 pour vous .
Les paramètres peuvent être dans n'importe quel ordre dans l'URL, séparés par '&' .
Une personne avec un navigateur ou 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 ?
mettre en doute
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 * |
La description |
service=WMS |
Obligatoire. |
version = version |
Demander une version.
Actuellement, le WMS d' ERDDAP prend en charge "1.1.0", "1.1.1" et "1.3.0".
Obligatoire. |
request=GetMap |
Nom de la demande.
Obligatoire. |
layers = liste_couches |
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 le WMS d' ERDDAP, les noms de couches des jeux de données sont nommés datasetID : nom_variable .
Dans le WMS d' ERDDAP, il existe cinq couches non basées sur des ensembles de données ERDDAP :
- "Land" peut être dessinée AVANT (en tant que sous-couche) ou APRÈS (en tant que masque terrestre) les couches à partir de jeux de données de grille.
- "Coastlines" doivent généralement être dessinées APRÈS les couches des jeux de données de grille.
- "LakesAndRivers" dessine des lacs et des rivières.
Cela devrait généralement être dessiné APRÈS les couches des jeux de données de grille.
- "Nations" dessine les frontières politiques nationales.
Cela devrait généralement être dessiné APRÈS les couches des jeux de données de grille.
- "States" dessine les frontières politiques des États.
Cela devrait généralement être dessiné APRÈS les couches des jeux de données de grille.
Obligatoire. |
styles = liste_styles |
Liste séparée par des virgules d'un style de rendu par couche demandée.
Actuellement dans le 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 couches, vous pouvez utiliser "styles=,,".
Ou, encore plus simple, vous pouvez demander le style par défaut pour tous les calques via "styles=".
Obligatoire. |
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 le WMS 1.1.0 d' ERDDAP, le seul SRS valide est EPSG:4326.
Actuellement dans le WMS 1.1.1 d' ERDDAP, le seul SRS valide est EPSG:4326.
Actuellement dans le WMS 1.3.0 d' ERDDAP, les seuls CRS valides sont CRS:84 et EPSG:4326,
Obligatoire. |
bbox= 4commaSeparatedValues |
Coins de la boîte englobante 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 l' OGC !) ERDDAP prend en charge les requêtes dans la longitude (peut-être 0 à 360, peut-être -180 à 180) et la plage de latitude.
La plupart des clients WMS supposent que les valeurs de longitude sont comprises entre -180 et 180.
Si ERDDAP propose une variante d'un jeu de données avec une longitude de -180 à 180, utilisez-la pour les requêtes WMS .
Obligatoire. |
width = sortie_largeur |
Largeur en pixels de l'image de la carte.
Obligatoire. |
height = sortie_hauteur |
Hauteur en pixels de l'image de la carte.
Obligatoire. |
format = format_sortie |
Format de sortie de la carte.
Actuellement dans le WMS d' ERDDAP, seule l'image/png est valide.
Obligatoire. |
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 dans certaines palettes de couleurs. |
exceptions = exception_format |
Le format des réponses d'exception WMS .
Optionnel.
Actuellement, les WMS 1.1.0 et 1.1.1 d' ERDDAP prennent en charge "application/vnd.ogc.se_xml" (valeur par défaut),
"application/vnd.ogc.se_blank" (une image vierge) et "application/vnd.ogc.se_inimage" (l'erreur dans une image).
Actuellement, le WMS 1.3.0 d' ERDDAP prend en charge "XML" (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 le WMS d' ERDDAP, vous ne pouvez spécifier qu'une seule valeur temporelle par requête.
Dans le WMS d' ERDDAP, la valeur la plus proche de la valeur que vous spécifiez (si entre min et max) sera utilisée.
Dans le WMS d' ERDDAP, la valeur par défaut est la dernière valeur du tableau de temps 1D de l'ensemble de données.
Dans le WMS d' ERDDAP, "current" est interprété comme la dernière heure disponible (récente ou non).
Facultatif (dans le WMS d' ERDDAP, la valeur par défaut est la dernière valeur, qu'elle soit récente ou non). |
elevation = altitude |
Élévation de la couche souhaitée.
Actuellement, dans le WMS d' ERDDAP, vous ne pouvez spécifier qu'une seule valeur d'élévation par requête.
Dans le 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=up)
Dans le WMS d' ERDDAP, la valeur la plus proche de la valeur que vous spécifiez (si entre min et max) sera utilisée.
Facultatif (dans le WMS d' ERDDAP, la valeur par défaut est la dernière valeur du tableau d'altitude ou de profondeur 1D du jeu de données). |
dim_ nom = valeur |
Valeur des autres dimensions, le cas échéant.
Actuellement dans le WMS d' ERDDAP, vous ne pouvez spécifier qu'une seule valeur par dimension et par demande.
Dans le WMS d' ERDDAP, ceci est utilisé pour les dimensions sans temps, sans altitude et sans profondeur.
Le nom d'une dimension sera "dim_" plus le nom de l'ensemble de données pour la dimension, par exemple "dim_model".
Dans le WMS d' ERDDAP, la valeur la plus proche de la valeur que vous spécifiez (si entre min et max) sera utilisée.
Facultatif (dans le WMS d' ERDDAP, la valeur par défaut est la dernière valeur du tableau 1D de la dimension).
|
* Les noms de paramètres sont insensibles à 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 sous la forme %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 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 du jeu 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 maillé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 entre -180 et 180.
- Les
colorBarMinimum et colorBarMaximum DOIVENT être spécifiés.
(Les autres attributs de barre de couleur sont FACULTATIFS.)
- Couches de données de grille : Dans le 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_variable .
Chacune de ces couches est transparente (c'est-à-dire que les valeurs de données sont représentées sous la forme d'une gamme de couleurs et les valeurs manquantes sont représentées par des pixels transparents).
- Couches de données de table : actuellement dans le 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 dimensions que vous spécifiez dans une requête GetMap s'appliquent à toutes les couches.
Il n'y a 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, le 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 y a-t-il des serveurs WMS distincts pour chaque jeu de données ? Étant donné que le document GetCapabilities répertorie toutes les valeurs de toutes les dimensions pour chaque jeu de données, les informations pour chaque jeu de données peuvent être volumineuses (facilement 300 Ko).
Si tous les ensembles de données (actuellement ~ 300 sur le) site principal ERDDAP devaient être inclus dans un WMS, le document GetCapabilities résultant serait énorme (~ 90 Mo) qui prendrait beaucoup de temps à télécharger (causant de nombreuses personnes à penser que quelque chose ne va pas et abandonner) 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.