Layer: satellite

Page Contents

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

Response formats include GIF and PNG.

Request URL Format

satellite 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 image via the params options. In the second format, you may specify the location of the 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 image.

feature

feature
satellite (single frame) or animatedsatellite (6-frame animation by default; must be gif format)

query

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

format

format
gif or pngOutput format

params

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

  • with a bounding box through minlat, maxlat, minlon, and maxlon
  • with a center location and a radius through lat, lon, 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
lat
Float
-90.0 to 90.0Center latitude
lon
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.
key
String, Required
sat_ir4, sat_ir4_bottom (default), sat_vis, or sat_vis_bottom
sat_ir4infrared satellite
sat_ir4_bottominfrared satellite with logo positioned at the bottom
sat_visvisible satellite
sat_vis_bottomvisible satellite with logo positioned at the bottom
gtt
Integer, Optional
0 (default) to 255 Ground temperature threshhold. Level to cutoff and leave transparent. 107 is a reasonable value to show clouds but hide land.
basemap
Integer, Optional
0 (default), or 1Transparent image (default) or show basemap.
borders
Integer, Optional
0 (default), or 1Show country and state borders on top of weather data
smooth
Integer, Optional
0 (default), or 1Smooth the colors.
proj
String, Optional
ll (default) or meLat/lon projection or Mercator projection
frame
Integer, Optional
0 (default) to 7Which frame to display: 0 is most current, 1 is the previous, moving back through time.
num
Integer, Optional
1 (default) to 8Number of frames in the animation
  • format must be gif for animations
  • feature must be animatedsattelite for animations
delay
Integer, Optional
25 (default) to 100The duration of a satellite frame in an animation, in hundredths of a second.
timelabel
Integer, Optional
0 (default) or 1Display the time of the satellite 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/satellite/image.gif?maxlat=42.35&maxlon=-109.311&minlat=39.27&minlon=-114.644&width=600&height=480&key=sat_vis&basemap=1

Using center lat/lon to determine a box

http://api.wunderground.com/api/Your_Key/satellite/image.gif?lat=38&lon=-96.4&radius=100&width=280&height=280&key=sat_ir4_bottom&basemap=1

Using location query to determine a box

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

Animated satellite using location query

http://api.wunderground.com/api/Your_Key/animatedsatellite/q/MI/Ann_Arbor.gif?basemap=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/satellite/image.gif?maxlat=47.709&maxlon=-69.263&minlat=31.596&minlon=-97.388&width=640&height=480&key=sat_ir4_bottom>t=107&timelabel=1&timelabel.x=470&timelabel.y=41&proj=me