Static Map v4 API

GET
Static Place Map

In addition to using latitude/longitude points, it is also possible to use single-line address to create a static map image. The method "getplacemap" is used when generating a static map image this way. Minimally, all that is needed is a key, a size for the image, and the location. Single-line locations and lat/lngs are available for the United States and international.

Resource URL

http://www.mapquestapi.com/staticmap/v4/getplacemap

Resource Information

Response Formats jpeg, jpg, gif, png
Authentication Yes (Requires Key)
Rate Limited Yes

URL Parameters

Request Parameter Description Required?
key
String
The API Key, which is needed to make requests to MapQuest services. Yes
location
Single Line Address
A single-line address or a lat/lng for the map image to be centered over. See Specifying Locations for details on correct ways of formatting single-line addresses.

Example Single Line Address:

Los+Angeles,CA

Example Lat/Lng:

34.0522,-118.2437

Yes
zoom
Integer
Specifies zoom level for the map image.

See Zoom to Scale Mapping for information on scales versus zoom levels.
Yes, if the center parameter is present, the scale parameter is not present, and no POIs are present

Note: zoom overrides scale
scale
Integer
Specifies display scale for map image.

See Zoom to Scale Mapping for information on scales versus zoom levels.
Yes, if the center parameter is present, the zoom parameter is not present, and no POIs are present
size
Integer Pair
Specifies the dimension of the map image requested. The width and height values cannot be larger than 3840.

Example: 400,200
Yes
imagetype
String
Specifies the output image format. Available formats:
  • jpeg
  • jpg
  • gif
  • png
Default: jpg
No
type
String
Specifies map mode. Available formats:
  • map
  • sat (Satellite)
  • hyb (Hybrid)
Default: map
No
showicon
String
The type of POI icon to be placed in at the geocoded addess. If more advanced POIs are desired, the getmap method must be used.

See the Static Map Standard Icons page for information on icons provided
No

Specifying Locations

When using single-line addresses, the following formats are acceptable.

Format Example
city (AA5), state (AA3) Denver, CO
city, state, postalCode Denver, CO, 80202
postalCode 80202
street, city, state 1555 Blake St, Denver, CO
street, city, state, postalCode 1555 Blake St, Denver, CO 80202
street, postalCode 1555 Blake St, 80202
latLng 39.750307,-104.999472
JSON Object {"street": "1555 Blake St"}

Try It Now

Example Request

GET

https://www.mapquestapi.com/staticmap/v4/getplacemap?key=KEY&location=Los+Angeles,CA&size=500,300&zoom=9&showicon=red_1-1

Example Response