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:

or

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_ir4	infrared satellite
sat_ir4_bottom	infrared satellite with logo positioned at the bottom
sat_vis	visible satellite
sat_vis_bottom	visible 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.

Using lat/lon bounds to determine a box

Using center lat/lon to determine a box

Using location query to determine a box

Animated satellite using location query

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