Subset Service for Radar Level2 Data (version 1.0)

Please note that the interface described here is still a prototype, and subject to change.

Please send comments to the THREDDS email group

RadarLevel2 Subset Service

A. Example urls

Some interesting URLs for the radarServer service:

Subsetting Parameters

Some interesting URLs for the radarServer query service:

B. Specify spatial extent

Latitude, longitude values are specified in decimal degrees north and east, respectively.

Use one of the following methods:

1. Specify lat/lon bounding box

Specify all of these parameters (order does not matter):

    • north: latitude north (decimal degrees)
    • south: latitude south (decimal degrees)
    • east: longitude east (decimal degrees)
    • west: longitude west (decimal degrees)

The bounding box has west as its west edge, includes all points going east until the east edge. Units must be degrees east, may be positive or negative, and will be taken modulo 360. Therefore, when crossing the dateline, the west edge may be greater than the east edge. Examples:

  • north=17.3&south=12.088&west=140.2&east=160.0

2. Specify lat/lon point

  • latitude: latitude of point, decimal degrees north
  • longitude: longitude of point, decimal degrees east

The requested point must lie within the dataset spatial range. The station closest to the requested point will be used.

Examples:

  • latitude=17.3&longitude=140.2

3. Specify station(s)

You may specify a list of stations instead of the lat/lon point or bounding box

  • stn=name of stations, separated by ',' (comma)

The list of valid stations is available from the Dataset Description. Station names with spaces or other illegal characters must be escaped.

Examples:

  • stn=KFTG
  • stn=KFTG,KGLD,KPUX
  • stn=KFTG&stn=KGLD&stn=KPUX

C. Specify time

Use one of the following methods:

1. Time range

Specify 2 of these 3 parameters (order does not matter):

  • time_start: starting time as an W3C date string or "present"
  • time_end: ending time as an W3C date string or "present"
  • time_duration: length of time as an W3C time duration

The intersection of the requested time range with the dataset time range will be returned.

Examples:

  • time_start=2007-03-29T12:00:00Z&time_end=2007-03-29T13:00:00Z (between 12 and 1 pm Greenwich time)
  • time_start=present&time_duration=P3D (get 3 day forecast starting from the present)
  • time_end=present&time_duration=PT3H (get last 3 hours)

2. Time point

  • time: time as an W3C date string or "present"

The 'latest' data retrieval is obtained by 'time=present'. The requested time point must lie within the dataset time range. The time slice/point closest to the requested time will be returned.

Examples:

  • time=2007-03-29T12:00:00Z
  • time=present

3. All Times

  • temporal=all

This returns data from all available times.

D. Specify the return format

The accept parameter default is xml and it is the only legal one at this time.

 

This document was last updated on May 21, 2015