Français - Anglais

logoresif

Webservice ws-statistics

Ce service donne accès aux statistiques de RESIF-DC.

Utilisation de la requête

/query? (request-options) [channel-options] [date-options] [storage-options] [send-options] [output-options]

où :

request-options    ::  (request=<country|send|storage|timeseries>)
channel-options    ::  [net=<network> & sta=<station> & loc=<location> & cha=<channel>]
date-options       ::  [starttime=<date>] & [endtime=<date>]
storage-options    ::  [year=<year>] & [type=<all|bud|validated>]
send-options       ::  [country=<country_code>] & [media=<all|dataselect|seedlink>]
output-options     ::  [format=<csv|request|sync|text>]

(..) requis
[..] optionnel

Exemples de requêtes

http://ws.resif.fr/resifws/statistics/1/query?request=storage&net=FR&year=2018&type=validated

http://ws.resif.fr/resifws/statistics/1/query?request=send&media=dataselect&net=WI&country=IT

http://ws.resif.fr/resifws/statistics/1/query?request=country&media=dataselect&net=RA&country=IT,US,FR

http://ws.resif.fr/resifws/statistics/1/query?request=country&media=seedlink&net=RA&starttime=2020-01-01

Descriptions détaillées de chaque paramètre de la requête

Paramètre Exemple Discussion
net[work] FR Nom du réseau sismique.
sta[tion] CIEL Nom de la station.
loc[ation] 00 Code de localisation. Utilisez loc=-- pour des codes de localisations vides. Ce paramètre accepte les jokers.
cha[nnel] HHZ Code de canal. Ce paramètre accepte les jokers.
start[time] 2010-01-10T00:00:00 Donne les réponses qui couvrent la période après la date donnée incluse.
end[time] 2011-02-11T01:00:00 Donne les réponses qui couvrent la période avant la date donnée incluse.
format txt Format de sortie. Valeurs autorisées : text et csv.
request send Type de la statistique demandée. Valeurs autorisées :
- country : nombre de requêtes passées par pays
- send : volume de données distribuées par protocoles
- storage : quantité de données stockées brutes et validées
- timeseries : produit une série temporelle avec en colonne le pays, le nombre et la taille cumulés des requêtes

Options supplémentaires spécifiques aux requêtes country, send et timeseries

Paramètre Exemple Discussion
country FR,GB Filtre les réponses avec une liste des pays d’origine. Utilisez l’abréviation en deux lettres du pays (ISO 3166-1 alpha-2).
media seedlink Protocoles utilisés pour la requête. Valeurs autorisées : all (par défaut), dataselect et seedlink

Options supplémentaires spécifiques à la requête storage

Paramètre Exemple Discussion
type validated Choix entre les données stockées brutes et validées. Valeurs autorisées : all (par défaut), bud et validated
years 2019,2020 Liste des années pour lesquelles on demande la quantité de données.

Détails sur la nomenclature des codes

Formats des dates et des heures

YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123
YYYY-MM-DD ex. 1997-01-31 (une heure de 00:00:00 est supposée)

avec :

YYYY    :: quatre chiffres de l'année
MM      :: deux chiffres du mois (01=Janvier, etc.)
DD      :: deux chiffres du jour du mois (01 à 31)
T       :: séparateur date-heure
hh      :: deux chiffres de l'heure (00 à 23)
mm      :: deux chiffres des minutes (00 à 59)
ss      :: deux chiffres des secondes (00 à 59)
ssssss  :: un à six chiffres des microsecondes en base décimale (0 à 999999)