{% extends '_template.html' %} {% block header %} {% endblock %} {% block content %}

Example Requests

BOU observatory data for current UTC day in IAGA2002 format
{{ request.url }}?id=BOU
BOU observatory data for current UTC day in JSON format
{{ request.url }}?id=BOU&format=json
BOU electric field data for current UTC day in IAGA2002 format
{{ request.url }}?id=BOU&elements=E-N,E-E

See more examples

Request Limits

To ensure availablility for users, the web service restricts the amount of data that can be retrieved in one request to 345600 samples . The amount of data requested is computed as follows, where interval is the number of seconds between starttime and endtime:

  samples = count(elements) * interval / sampling_period

This is equivalent to one day of second data in iaga2002 format ( 345600 samples = 4 elements * 24 hours * 3600 samples/hour ).

Parameters

id
Observatory code. Required.
Valid values: {% for observatory in valid_observatories %} {{ observatory }} {% if not loop.last %} , {% endif %} {% endfor %}
starttime
Time of first requested data.
Default: start of current UTC day
Format: ISO8601 ( YYYY-MM-DDTHH:MM:SSZ )
Example: 2020-03-06T16:59:53Z
endtime
Time of last requested data.
Default: starttime + 24 hours
Format: ISO8601 ( YYYY-MM-DDTHH:MM:SSZ )
Example: 2020-03-06T16:59:53Z
elements
Comma separated list of requested elements.
Default: X,Y,Z,F
Valid values: {% for element in valid_elements %} {{ element }} {% if not loop.last %} , {% endif %} {% endfor %}
NOTE: the USGS web service also supports specific EDGE channel codes. For example: UK1 is "electronics temperature"
sampling_period
Interval in seconds between values.
Default: 60
Valid values: {% for sampling_period in valid_sampling_periods %} {{ sampling_period }} {% if not loop.last %} , {% endif %} {% endfor %}
type
Type of data.
Default: variation Valid values: {% for data_type in valid_data_types %} {{ data_type }} {% if not loop.last %} , {% endif %} {% endfor %}
NOTE: the USGS web service also supports specific EDGE location codes. For example: R0 is "internet variation", R1 is "satellite variation".
format
Output format.
Default: iaga2002
Valid values: iaga2002 , json .
{% endblock %}