Ce service donne la disponibilité des enregistrements sismiques du centre d’archivage du réseau RESIF. Il fournit des informations sous forme de plages temporelles détaillées.
Il y a deux méthodes de requêtes pour ce service :
/extent
Produis une liste des plages temporelles disponibles selon les canaux (network, station, location, channel, quality) et l’intervalle de temps demandés.
/query
Produis une liste des plages temporelles continues disponibles selon les canaux (network, station, location, channel, quality) et l’intervalle de temps demandés.
Les paramètres de la requête sont joints par une esperluette “&”, sans espace (voir les exemples de requêtes). Les valeurs par défaut sont indiquées en majuscules. Au moins une station ou un réseau doit être précisé.
/extent? [channel-options] [date-range-options] [merge-options] [sort-options] [display-options] [format-options] [nodata=404]
où :
channel-options :: [net=<network>] [sta=<station>] [loc=<location>] [cha=<channel>] [quality=<quality>]
date-range-options :: [starttime=<date|durée>] [endtime=<date|durée>]
merge-options :: [merge=<quality|samplerate|overlap>]
sort-options :: [orderby=<NSLC_TIME_QUALITY_SAMPLERATE|timespancount|timespancount_desc|latestupdate|latestupdate_desc>]
display-options :: [includerestricted=<true|FALSE>] [limit=<number>]
format-options :: [format=<TEXT|geocsv|json|request|zip>]
les valeurs par défaut sont en majuscules/query? [channel-options] [date-range-options] [merge-options] [sort-options] [display-options] [format-options] [nodata=404]
où :
channel-options :: [net=<network>] [sta=<station>] [loc=<location>] [cha=<channel>] [quality=<quality>]
date-range-options :: (starttime=<date|durée>) (endtime=<date|durée>)
merge-options :: [merge=<quality|samplerate|overlap>] [mergegaps=<number>]
sort-options :: [orderby=<NSLC_TIME_QUALITY_SAMPLERATE|latestupdate|latestupdate_desc>]
display-options :: [includerestricted=<true|FALSE>] [limit=<number>] [show=<latestupdate>]
format-options :: [format=<TEXT|geocsv|json|request|zip>]
les valeurs par défaut sont en majuscules| Paramètre | Exemple | Discussion |
|---|---|---|
| net[work] | FR | Nom du réseau sismique. Accepte les jokers et les listes. |
| sta[tion] | CIEL | Nom de la station. Accepte les jokers et les listes. |
| loc[ation] | 00 | Code de localisation. Utilisez loc=-- pour les codes de localisations vides. Accepte les jokers et les listes. |
| cha[nnel] | HHZ | Code de canal. Accepte les jokers et les listes. |
| quality | M | Code de qualité SEED : D, M, Q, R. Accepte les jokers et les listes. |
Jokers : le point d’interrogation ? représente n’importe quel caractère unique, alors que l’astérisque * représente zéro caractère ou plus.
Listes : plusieurs éléments peuvent être récupérés à l’aide d’une liste séparée par des virgules. Les jokers peuvent être inclus dans la liste.
Par exemple, pour le code des canaux : channel=EH?,BHZ
| Paramètre | Exemple | Discussion |
|---|---|---|
| start[time] | 2010-01-10T00:00:00 | Sélectionne la disponibilité des enregistrements à partir de l’heure spécifiée incluse. |
| end[time] | 2011-02-11T01:00:00 | Sélectionne la disponibilité des enregistrements avant l’heure spécifiée incluse. |
La définition de l’intervalle de temps avec starttime et endtime peut prendre différentes formes :
| Paramètre | Exemples | Discussion |
|---|---|---|
| merge | Liste de paramètres séparés par des virgules (exemple merge=quality,samplerate). | |
| quality | Les plages de temps de qualités différentes sont fusionnées. | |
| samplerate | Les plages de temps de fréquences d’échantillonnage différentes sont fusionnées. | |
| overlap | Non applicable. |
| Paramètre | Exemples | Discussion |
|---|---|---|
| format | json | Format de sortie. Valeurs autorisées : text (par défaut, avec les entêtes), geocsv, json, request et zip. |
| includerestricted | false | Affiche ou non les données restreintes. |
| limit | integer | Limite le nombre de lignes en sortie. |
| nodata | 404 | Code d’état HTTP qui est renvoyé lorsqu’il n’y a pas de données (204 or 404) |
| Paramètre | Exemples | Discussion |
|---|---|---|
| orderby | Range les lignes par : | |
| nslc_time_quality_samplerate | network, station, location, channel, plage de temps, quality, sample-rate (par défaut) | |
| latestupdate | date de mise à jour (du plus ancien au plus récent), network, station, location, channel, plage de temps, quality, sample-rate | |
| latestupdate_desc | date de mise à jour (du plus récent au plus ancien), network, station, location, channel, plage de temps, quality, sample-rate |
| Paramètre | Exemples | Discussion |
|---|---|---|
| orderby | Range les lignes par : | |
| timespancount | nombre de plages de temps (du plus petit au plus grand), network, station, location, channel, plage de temps, quality, sample-rate | |
| timespancount_desc | nombre de plages de temps (du plus grand au plus petit), network, station, location, channel, plage de temps, quality, sample-rate |
| Paramètre | Exemple | Discussion |
|---|---|---|
| mergegaps | 3600 | Les plages de temps qui sont séparées par des gaps plus petits ou égaux à la valeur donnée en secondes sont fusionnées. |
| show | latestupdate | Affiche la date de mise à jour des données. |
La forme générale d’une requête POST est un ensemble de paires parameter=value, une par ligne, suivie d’un nombre arbitraire de canaux et d’une fenêtre temporelle optionnelle :
parameter=<value>
parameter=<value>
parameter=<value>
Net Sta Loc Chan [StartTime EndTime]
Net Sta Loc Chan [StartTime EndTime]
…
La fenêtre temporelle peut être précisée globalement :
…
start=2020-10-01T00:00:00
end=2020-10-01T00:01:00
Net1 Sta1 Loc1 Chan1
Net2 Sta2 Loc2 Chan2
…
ou par ligne :
…
Net1 Sta1 Loc1 Chan1 2020-10-01T00:00:00 2020-10-01T00:01:00
Net2 Sta2 Loc2 Chan2 2020-10-02T00:00:00 2020-10-02T00:02:00
…
La fenêtre temporelle globale peut être utilisée conjointement avec des fenêtres temporelles individuelles. Si aucune information temporelle n’est précisée, la période maximale de disponibilité est utilisée.
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)