Layer: radar

Page Contents

Returns a static or animated radar image for a given location.

Response formats include GIF, PNG and SWF (Flash).

Request URL Format

Radar requests follow may follow either of the following formats:

GET http://api.wunderground.com/api/Your_Key/feature/image.format?params

GET http://api.wunderground.com/api/Your_Key/feature/q/query.format?params

In the first format, you specify the geographical location of the radar image via the params options. In the second format, you may specify the location of the radar image by using the standard API location query format. If you use this second format, then you may override the location query via the position-oriented params options. For example, you may specify a city via query, but append a radius option to expand the scope of the radar image.

feature

feature: radar (single frame) or animatedradar (6-frame animation by default; must be gif or swf format)

query

query: A valid location query as described in the API URL Format

format

format: gif, png, or swf

params

There are two ways to specify a radar location via the params options:

with a bounding box through minlat, maxlat, minlon, and maxlon
with a center location and a radius through centerlat, centerlon, and radius

The location-oriented options above will override any location set via query.

minlat: Float; -90.0 to 90.0Minimum latitude bounds
maxlat: Float; -90.0 to 90.0Maximum latitude bounds
minlon: Float; -180.0 to 180.0Minimum longitude bounds
maxlon: Float; -180.0 to 180.0Maximum longitude bounds
centerlat: Float; -90.0 to 90.0Center latitude
centerlon: Float; -180.0 to 180.0Center longitude
radius: Integer; Radius distance from center to edge. 100 is close, 1000 is country.
radunits: String, Optional; nm (default), or km Radius units: nautical miles or kilometers.
width: Integer; Width of image in pixels.
height: Integer; Height of image in pixels.
newmaps: Integer, Optional; 0 (default), or 1Transparent image (default) or show basemap.
rainsnow: Integer, Optional; 0 (default), or 1Use a different color palette to show rain/mix/snow.
smooth: Integer, Optional; 0 (default), or 1Smooth the colors.
reproj.automerc: Integer, Optional; 1Use Mercator projection. (Omit this parameter for lat/lon projection, default.)
frame: Integer, Optional; 0 (default) to 5Which frame to display: 0 is most current, 1 is the previous, moving back through time.
num: Integer, Optional; 1 (default) to 15Number of frames in the animation

format must be gif or swf for animations

feature must be animatedradar for animations
delay: Integer, Optional; 25 (default) to 100The duration of a radar frame in an animation, in hundredths of a second.
timelabel: Integer, Optional; 0 (default) or 1Display the time of the radar frame.
timelabel.x: Integer; 0 (default) to image widthPixels from left.
timelabel.y: Integer; 0 (default) to image heightPixels from top.

Examples

Try with Apigee

Note: replace {{key}} with Your_Key

Using lat/lon bounds to determine a box

	http://api.wunderground.com/api/Your_Key/radar/image.gif?maxlat=42.35&maxlon=-109.311&minlat=39.27&minlon=-114.644&width=600&height=480&newmaps=1

Using center lat/lon to determine a box

	http://api.wunderground.com/api/Your_Key/radar/image.gif?centerlat=38&centerlon=-96.4&radius=100&width=280&height=280&newmaps=1

Using location query to determine a box

	http://api.wunderground.com/api/Your_Key/radar/q/KS/Topeka.gif?width=280&height=280&newmaps=1

Animated radar using location query

	http://api.wunderground.com/api/Your_Key/animatedradar/q/MI/Ann_Arbor.gif?newmaps=1&timelabel=1&timelabel.y=10&num=5&delay=50

Using lat/lon bounds, showing time label, transparent background

	http://api.wunderground.com/api/Your_Key/image.gif?maxlat=47.709&maxlon=-69.263&minlat=31.596&minlon=-97.388&width=640&height=480&rainsnow=1&timelabel=1&timelabel.x=525&timelabel.y=41&reproj.automerc=1

DOCUMENTATION