CIOOS Atlantic ERDDAP
Accès plus facile aux données scientifiques
Présenté par NOAA NMFS SWFSC ERD    

ERDDAP > Services Web RESTful

Accéder aux services Web RESTful d'ERDDAP

ERDDAP c'est à la fois : Pour chaque page Web ERDDAP avec un formulaire que vous, en tant qu'humain avec un navigateur, pouvez utiliser, il y a un le service Web ERDDAP correspondant conçu pour être facile à utiliser pour les programmes informatiques et les scripts. Par exemple, les humains peuvent utiliser cette URL pour effectuer une recherche en texte intégral pour des ensembles de données intéressants :
https://cioosatlantic.ca/erddap/fr/search/index.html?page=1&itemsPerPage=1000&searchFor=temperature
En changeant l'extension de fichier dans l'URL de .html en .json (ou .csv, ou .htmlTable, ou .jsonlCSV1, ou .xhtml, ...) :
https://cioosatlantic.ca/erddap/fr/search/index.json?page=1&itemsPerPage=1000&searchFor=temperature
nous obtenons une URL qu'un programme informatique ou un script JavaScript peut utiliser pour obtenir les mêmes informations dans un format plus convivial pour les programmes informatiques, comme JSON (lien externe) .

Construire des choses au-dessus de ERDDAP

Il existe de nombreuses fonctionnalités dans ERDDAP qui peuvent être utilisées par les programmes informatiques ou les scripts que vous écrivez. Vous pouvez les utiliser pour créer d'autres applications Web ou services Web en plus d' ERDDAP, ce qui permet à ERDDAP de faire l'essentiel du travail ! Donc, si vous avez une idée pour une meilleure interface avec les données servies par ERDDAP ou une page Web qui a besoin d'un moyen facile d'accéder aux données, nous vous encourageons à créer votre propre application Web, service Web ou page Web et à utiliser ERDDAP comme fondation. Votre système peut obtenir des données, des graphiques et d'autres informations de l' ERDDAP d' ERD ou d'autres installations ERDDAP, ou vous pouvez configurez votre propre serveur ERDDAP, qui peut être accessible publiquement ou simplement accessible de manière privée.

Demandes d'URL RESTful

Les demandes d'informations d'interface utilisateur provenant d' ERDDAP (par exemple, les résultats de recherche) utilisent la norme universelle du Web pour les demandes : URL (lien externe) envoyé via HTTP GET (lien externe) . C'est le même mécanisme que votre navigateur utilise lorsque vous remplissez un formulaire sur une page Web et cliquez sur Submit Pour utiliser HTTP GET, vous générez une URL spécialement formée (qui peut inclure une requête) et l'envoyez avec HTTP GET . Vous pouvez former ces URL à la main et les saisir dans le champ de texte d'adresse de votre navigateur (par exemple,
https://cioosatlantic.ca/erddap/fr/search/index.json?page=1&itemsPerPage=1000&searchFor=temperature)
Vous pouvez également écrire un programme informatique ou un script de page Web pour créer une URL, l'envoyer et obtenir la réponse. Les URL via HTTP GET ont été choisies car

Pourcentage d'encodage

Dans les URL, certains caractères ne sont pas autorisés (par exemple, les espaces) et d'autres caractères ont une signification spéciale (par exemple, '&' sépare les paires clé=valeur dans une requête). Lorsque vous remplissez un formulaire sur une page Web et que vous cliquez sur Soumettre, votre navigateur encode automatiquement en pourcentage (lien externe) les caractères spéciaux dans l'URL (par exemple, l'espace devient %20), par exemple,
https://cioosatlantic.ca/erddap/fr/search/index.html?page=1&itemsPerPage=1000&searchFor=temperature%20wind%20speed
Mais si votre programme ou script informatique génère les URL, il doit probablement effectuer lui-même le codage en pourcentage. Si c'est le cas, alors probablement tous les caractères autres que A-Za-z0-9_-!.~'()* dans les valeurs de la requête (les parties après les signes '=' ) doivent être codés en tant que %HH, où HH est le 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). Les langages de programmation ont des outils pour le faire (par exemple, voir java.net.URLEncoder (lien externe) de Java et encodeURIComponent() de JavaScript (lien externe)) et il existe des sites Web qui encodent/décodent en pourcentage pour vous (lien externe)

Types de fichiers de réponses

Bien que les humains utilisant des navigateurs souhaitent recevoir les résultats de l'interface utilisateur (par exemple, les résultats de recherche) sous forme de documents HTML, les programmes informatiques préfèrent souvent obtenir des résultats dans des documents simples, faciles à analyser et moins détaillés. ERDDAP peut renvoyer les résultats de l'interface utilisateur sous forme de tableau de données dans ces types de fichiers courants et conviviaux pour les programmes informatiques : Dans chaque format de tableau de résultats (sauf .jsonlKVP, où les noms de colonnes figurent sur chaque ligne) :

Le contenu de ces types de fichiers simples est également légèrement différent de la réponse .html - il est intentionnellement simplifié afin qu'il soit plus facile pour un programme informatique de travailler avec.

Une structure de données cohérente pour les réponses
Tous les services d'interface utilisateur décrits sur cette page peuvent renvoyer un tableau de données dans l'un des formats de fichiers courants répertoriés ci-dessus. Heureusement, vous pouvez écrire une seule procédure pour analyser une table de données dans l'un des formats. Vous pouvez ensuite réutiliser cette procédure pour analyser la réponse de l'un de ces services. Cela devrait faciliter le traitement de ERDDAP .

Détails .csv et .tsv

jsonp
Les demandes de fichiers .json peuvent désormais inclure un jsonp (lien externe) demande en ajoutant "& .json p= functionName" à la fin de la requête. Fondamentalement, cela indique à ERDDAP d'ajouter "functionName (" au début de la réponse et ")" à la fin de la réponse. Le premier caractère de functionName doit être une lettre ISO 8859 ou "_". Chaque caractère facultatif suivant doit être une lettre ISO 8859, "_", un chiffre ou ".". S'il n'y avait pas de requête à l'origine, laissez le "&" dans votre requête.

griddap et tabledap offrent différents types de fichiers
Les types de fichiers répertoriés ci-dessus sont des types de fichiers ERDDAP peut utiliser pour répondre aux types de demandes d'interface utilisateur (par exemple, les demandes de recherche). ERDDAP prend en charge un ensemble différent de types de fichiers pour les demandes de données scientifiques (par exemple, des données de satellites et de bouées) (voir la documentation griddap et tabledap).

Demande de fichiers compressés

ERDDAP n'offre pas de résultats stockés dans des fichiers compressés (par exemple, .zip ou .gzip ). Au lieu de cela, ERDDAP recherche le codage d'acceptation (lien externe) dans l'en-tête de requête HTTP GET envoyé par le client. Si un type de compression pris en charge (gzip, x-gzip ou deflate ) est trouvé dans la liste d'encodages acceptés, ERDDAP inclut « content‑encoding » dans l'en-tête de réponse HTTP et compresse les données au fur et à mesure qu'il les transmet. Il appartient au programme client de rechercher content-encoding et de décompresser les données en conséquence. La demande de compression est facultative, mais les réponses compressées sont souvent 3 à 10 fois plus rapides, ce qui représente un gain de temps considérable si vous téléchargez de nombreux fichiers volumineux. (Notez qu'il n'y a aucun avantage à demander des fichiers .png compressés puisque le contenu des fichiers est déjà compressé.)

URL d'accès aux services de l' ERDDAP

ERDDAP dispose de ces points d'accès URL pour les programmes informatiques : Si vous avez des suggestions de liens supplémentaires, contactez bob dot simons at noaa dot gov .

Utiliser ERDDAP comme source de données dans votre programme Java

Comme décrit ci-dessus, étant donné que les programmes Java peuvent accéder aux données disponibles sur le Web, vous pouvez écrire un programme Java qui accède aux données à partir de n'importe quelle installation ERDDAP accessible au public.

Ou, puisque ERDDAP est un programme entièrement open source, vous pouvez également configurer votre propre copie d' ERDDAP sur votre propre serveur (accessible au public ou non) pour servir vos propres données. Vos programmes Java peuvent obtenir des données à partir de cette copie d' ERDDAP . Voir Configurer votre propre ERDDAP .

Connectez-vous pour accéder aux ensembles de données privés.

De nombreuses installations ERDDAP n'ont pas d'authentification activée et ne fournissent donc aucun moyen pour les utilisateurs de se connecter, ni d'ensembles de données privés.

Certaines installations ERDDAP ont l'authentification activée. Actuellement, ERDDAP ne prend en charge que l'authentification via les comptes de messagerie gérés par Google, qui incluent les comptes de messagerie de la NOAA et de nombreuses universités. Si l'authentification d'un ERDDAP est activée, toute personne disposant d'un compte de messagerie géré par Google peut se connecter, mais elle n'aura accès qu'aux ensembles de données privés auxquels l'administrateur ERDDAP a explicitement autorisé l'accès. Pour obtenir des instructions sur la connexion à ERDDAP à partir d'un navigateur ou via un script, consultez Accès aux ensembles de données privés dans ERDDAP .

Version ERDDAP

Si vous souhaitez utiliser une nouvelle fonctionnalité sur un ERDDAP distant, vous pouvez savoir si la nouvelle fonctionnalité est disponible en envoyant une requête pour connaître le numéro de version de l' ERDDAP, par exemple,
https://cioosatlantic.ca/erddap/fr/version
ERDDAP enverra une réponse textuelle avec le numéro de version ERDDAP de cet ERDDAP . Par exemple:
ERDDAP_version=2.18
Si vous obtenez un message d'erreur HTTP 404 Not-Found, traitez l' ERDDAP comme la version 1.22 ou inférieure.

Ou, vous pouvez demander la version_string, qui peut contenir des informations supplémentaires. Par exemple,
https://cioosatlantic.ca/erddap/fr/version_string
ERDDAP enverra une réponse textuelle avec la chaîne de version ERDDAP de cet ERDDAP . Ce sera un nombre à virgule flottante (le numéro de version) avec un suffixe facultatif de '_' plus du texte ASCII supplémentaire (pas d'espaces ni de caractères de contrôle). Par exemple:
ERDDAP_version_string=2.18_JohnsFork
Si vous obtenez un message d'erreur HTTP 404 Not-Found, traitez l' ERDDAP comme la version 1.80 ou inférieure.


 
Translated by Google ?
ERDDAP, Version 2.18
Disclaimers | Privacy Policy | Contact