ITACA FDSNWS Station Web-Service

Sample requests

Publicly Available Data

Data can be obtained using any program supporting the HTTP-GET method, e.g. your favourite web browser:

Restricted Data (authenticated users only)

ITACA Administrators and users with special authorizations can access data intended for internal use and/or embargoed.
Data can be obtained using any program supporting the HTTP-POST method, e.g. CURL:

curl -X POST -F "message=@path/to/token.txt" "https://itaca.mi.ingv.it/fdsnws/station/1/query?network=IT&level=channel&format=text"
curl -X POST -F "message=@path/to/token.txt" "https://itaca.mi.ingv.it/fdsnws/station/1/query?network=IT&level=channel"
curl -X POST -F "message=@path/to/token.txt" "https://itaca.mi.ingv.it/fdsnws/station/1/query?starttime=2015-01-01T00:00:00&endtime=2015-12-31T23:59:59&level=station"
curl -X POST -F "message=@path/to/token.txt" "https://itaca.mi.ingv.it/fdsnws/station/1/query?latitude=42.3&longitude=13.4&maxradius=1"

HTTP-POST variables (required)

Option	Description
message	The clearsign token obtained from the generate-signed-message authentication webservice.

Query options

URL format

Option	Description	Default
level	{network,station,channel} Specify the level of detail for the results.	station
starttime	Limit to metadata epochs starting on or after the specified start time. NOTE: since these times are often unknown for stations, they refer to seismic events recorded by them.	1900-01-01T00:00:00
endtime	Limit to metadata epochs ending on or before the specified end time. NOTE: since these times are often unknown for stations, they refer to seismic events recorded by them.	2100-01-01T00:00:00
network	Select one or more network codes. Can be SEED network codes or data center defined codes. Multiple codes are comma-separated. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
station	Select one or more SEED station codes. Multiple codes are comma-separated. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
location	Select one or more SEED location identifiers. Multiple identifiers are commaseparated. As a special case '--' (two dashes) will be translated to a string of two space characters to match blank location IDs. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
channel	Select one or more SEED channel codes. Multiple codes are comma-separated. It must be a valid ASCII. Allowed wildcard: '*' (matches zero or more characters) or '?' (matches a single character).	*
minlatitude	Square selection: limit to stations with a latitude larger than or equal to the specified minimum.	-90
maxlatitude	Square selection: limit to stations with a latitude smaller than or equal to the specified maximum.	90
minlongitude	Square selection: limit to stations with a longitude larger than or equal to the specified minimum.	-180
maxlongitude	Square selection: limit to stations with a longitude smaller than or equal to the specified maximum.	180
latitude	Circular selection: specify the latitude to be used for a radius search.	0
longitude	Circular selection: specify the longitude to the used for a radius search.	0
minradius	Circular selection: limit to stations within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters.	0
maxradius	Circular selection: limit to stations within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.	180
format	{xml,text} Specify format of result, either 'xml', 'text' or 'shapefile'. NOTE: format=shapefile always implies level=station.	xml

Backend Python software used by this web service was originally developed by Puglia R. and Russo E., and it is currently maintained by Russo E. and Felicetta C.