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

or

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.
noclutter
Integer, Optional
0 (default), or 1When you turn on "noclutter" (set noclutter=1) you remove the radar data that we know is not precipitation. Some radar data is not actually rain, but rather particles in the air that reflect back to the radar station. Even birds, bugs and bats can show up on radar, and using "noclutter" removes the false readings.
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/radar/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