Use
this form
to build a URL to the
targets
web service. Notice that as you edit the form,
the link is automatically updated.
What is the nodata=404 URL parameter?
This form primarily serves to illustrate how to create
mustang-targets URLs and includes a fixed sequence of
temporal and value constraints.
Metric |
This parameter identifies a particular
metric to show metadata for. |
Targets |
You can define a specific target string, or apply a SNCLQ filter.
- Target: This parameter allows individual
targets to be named directly in N.S.L.C.Q order. See list below.
- SNCLQ filter: These parameters select the
targets that match the given SNCLQ components.
The five components, in N.S.L.C.Q order are:
- Network – a SEED network code – ex. IU
- Station – a SEED station code – ex. ANMO
- Location – a SEED location code – ex. 00
- Channel – a SEED channel code – ex. BH1
- Quality – a DMC quality flag – ex. M
|
Output |
This parameter selects the output format and, in the case
of xsd, the type of metadata returned. The formats available are:
html – The default. Provides a
human-readable description of each metric.
xml – Provides the same information
as html, but in a simple XML format that is easier
to parse in software.
xsd – Provides an XML schema that
describes the format in which measurements are encoded.
This format is used by the measurements service.
|
Temporal Constraints |
The following parameters impose various time
constraints on the query. The list of metrics returned
by the service will be restricted to include only those
that have measurements in the appropriate time range.
- timewindow – two comma–separated
dates specify a time range that must contain measurements
- startbefore – get measurements starting before the defined time.
- startafter – get measurements starting after the defined time.
- endbefore – get measurements ending before the defined time.
- endafter – get measurements ending after the defined time.
|
Value Constraints |
Every metric has one or more fields for the
measurements it contains, which we generically refer
to here by name . The most common of these fields is
value , but some metrics are more specific.
We can filter our query based on comparators to these value
fields by adding the parameter name in combination with one
of these operator suffixes to the URL:
_eq – Equal (the default if no extension is used)
_ne – Not equal
_gt – Greater than
_ge – Greater than or equal
_lt – Less than
_le – Less than or equal
|
Time |
Specify time as: YYYY-MM-DDTHH:mm:ss (e.g. "2010-06-14T00:00:00"). |
Nodata |
If no data is returned by the service, return
a 404 response rather than the
default 204.
Learn more about HTTP response codes. |
Problems with this service?
Please send an email report of which service you were using, your URL query, and any error feedback to:
data-help@earthscope.org
We will address your issue as soon as possible.