Skip to main content

Static Maps

The Radar Static Maps API generates standalone images of Radar Maps that can be easily embedded anywhere an image can be used. These images can be created without the use of Javascript or any additional mapping libraries.

For example, here's a Radar Static Map displaying a marker for Radar HQ:

<img src=",-73.99110&zoom=15&style=radar-default-v1&scale=2&markers=color:0x000257|40.73430,-73.99110" alt="Radar static map over New York City" />
Radar static map over New York City

How it works#

To generate an image with Radar's Static Maps API, simply make an HTTP request with your desired map size, location, and any markers (map pins) for highlighting important features.

Static Map images can be used inline with HTML <img> tags by setting the src attribute to the Static Maps endpoint.





NameDefaultPossible valuesDescription
widthnone (required)numberThe width of the image in pixels as a number between 100 and 2048.
heightnone (required)numberThe height of the image in pixels as a number between 100 and 2048.
centernone (required, unless markers are provided)stringThe coordinates specified in latitude,longitude format for the center of the map. If center is not provided then the map will be centered to visibly fit all markers in view.
zoomnone (required, unless markers are provided)numberThe zoom position of the map which is a number between 1 and 23. If zoom is not provided then the map will fit the view to the markers.
scale1numberThe scale or resolution of the map as a number between 1 and 3. This is useful for high-density displays and will affect the width and height parameters by returning an image that is the product of the width/height and scale.
styleradar-default-v1radar-default-v1, radar-light-v1, radar-dark-v1The style of the map. See map styles for more details.
markersnonestringFor rendering markers on the map. See markers for more details.
pathnonestringFor rendering paths on the map. See paths for more details.


Adding markers (or map pins) to your static images can be useful for highlighting important features on your map. The Static Maps endpoint accepts a markers parameter that can be configured for rendering one, or many markers on the map.

Each markers parameter is made up of optional markerStyle sections, and one or more markerLocations.


markerLocation are specified in the following format latitude,longitude and are pipe separated.

markerStyle are specified in the following format optionName:optionValue and are pipe separated. markerStyle have the following options:

  • color (string, optional): The color of the image specified as a hex in the following format 0xFFFFFF or a standard color. The default value if color is not specified is 0x000257.
  • size (string, optional): By specifying size:small as an option, you can render a scaled down version of the marker.
  • icon (string, optional): The marker image to use. Can be a URL to valid SVG or PNG file. The default marker image will be used if not provided.

For instance, to apply a single marker styling to multiple pins:|40.73430,-73.99110|40.706436,-73.997271
Radar Static Map over New York City

Additionally, if you want more than one marker style in an image, you can provide multiple markers parameters in the request. markers=markerStyle1|markerLocation1|...&markers=markerStyle2|markerLocation2|...

An example request with two different styles is defined below.,-122.42376&zoom=13&style=radar-dark-v1&scale=2&markers=color:0xD1F3E0|size:small|37.808387,-122.409673&markers=color:0xBFD1FF|37.822503,-122.478923
Radar Static Map over San Francisco


Paths lines can be added to higlight routes or connect items on your map. The path parameter can be configured for rendering a connected list of coordinates or an encoded polyline.

Each paths parameter is made up of optional pathStyle sections, an encoded polyline, or one or more pathLocations.


pathLocation are specified in the following format latitude,longitude and are pipe separated. Locations must come after the style options.

The locations can also be provided via encoded polyline by specifying enc: as the option (or enc6: for a polyline with 6 decimals precision).


pathStyle are specified in the following format optionName:optionValue and are pipe separated. pathStyle have the following options:

  • stroke (string, optional): The color of the path specified as a hex in the following format 0xFFFFFF or a standard color. The default value if color is not specified is 0x000257.
  • width (number, optional): The width of the path in pixels. The default is 3.
  • border (string, optional): The color of the path border as a hex in the following format 0xFFFFFF or a standard color. The default value if color is not specified is white.
  • borderWidth (number, optional): The width of the border in pixels. The default is 2.|width:3|border:0xFFFFFF|borderwidth:2|40.72508219091827,-73.99710317462564|40.72786608720213,-73.99480170726147|40.731220024434066,-73.99183635508086|40.73289692965673,-73.99117247026444|40.73497623343911,-73.99072988038682|40.73588171638792,-73.98949062872913|40.73708900781568,-73.99024303152117|40.74030834450895,-73.98931359277834|40.74175028854742,-73.98935785176594|40.7455729656383,-73.98860544897387|40.74879189172239,-73.98803008213306|40.75207771805478,-73.98749897427983|40.75368704313985,-73.98718916136541&path=|stroke:0x000257|width:3|border:0xFFFFFF|borderwidth:2|40.755749689929615,-74.00614255328324|40.75061628432047,-74.00834272086787|40.74848280436839,-74.00763866724067|40.7463492559649,-74.0079906940545|40.73881461553785,-74.0098388348253|40.73334646594802,-74.01019086163912|40.72554357194073,-74.01115893537623|40.71854019575176,-74.01274305603714|40.712470007009586,-74.01441518340147|40.70800039341367,-74.01538325713858|40.70499824571482,-74.01679136439253
Radar Static Map with multiple paths


Embedding a Radar Static Map using HTML#

Radar Static Maps can easily be embedded into <img> using the element's src attribute. For instance, if we wanted an image of a map with the following attributes:

  • width: 900
  • height: 600
  • center: 43.64259,-79.387087
  • zoom: 13
  • style: radar-default-v1
  • scale: 2
  • marker:
    • color: 0x000257
    • location: 43.64259,-79.387087

We can specify these options as query parameters in the image src.,-79.387087&zoom=13&style=radar-default-v1&scale=2&markers=color:0x000257|43.64259,-79.387087
Radar Static Map centered around the CN Tower

Autofitting map bounds to markers or paths#

When markers or paths are included as part of the Static Image request, you have the option for the center and zoom to automatically be determined based on the items' locations.

By omitting the center and zoom parameters, the map's position will be calculated to ensure all markers and paths are visible.|40.781196,-73.974075|40.782938,-73.959041&markers=color:0xE2052C|size:small|40.779344,-73.962486|40.76144,-73.977597|40.753664,-73.981905&path=stroke:0x000257|width:3|border:white|borderwidth:2|enc:qwwwF|cqbMIG@CBIMKIEeBiAKIKGeBkAIGMIs@e@q@c@IGKGeBgAKGMIcBiAECECKIGEw@g@c@YKGKIcBiAMIKGIGa@Wy@i@AAIGIEgBkAGESMAAi@]u@g@QKSOiAs@[UOKKGeBeASKHW[EEGOSEKIOEQAMOa@W]WQYQMIKKKKIMUg@COGc@GUIYU]W]]g@MSGGGCGAIAGEGKEKIKIIGGEKEOEOEKEIGIGEQKKEMIQKMIKGCYAOIMCIAG?G@G@K@I?GAI?GMQ?GM_@EUCOCQ?MAK?S?U?K@K@I@I@IBI@IBGBKBGBGDKDIDK@EBIHQDOBSBQ?O?Q?MAOAMAMEOIUEMKSIQGMS]EGMKSMc@UKEWGIESKUMOMSSQWMSKUMYM_@KYKUIWKSEKIMKMGIMMMKWOSMQGQI@G@IF_@QO[SSSMMGEEMCOAS@QD[RaAb@yAJWQKSMkBoAGEKGiBmAIEIGgBkAKGIGiBmAIGMGa@YgAs@IGGEgBkAKGKImAw@]UOKUOk@_@[SIEWQCCCCMGFSj@gB
Radar Static Map over New York City museums

Using a custom marker image#

To use a custom marker image, set the icon: option as a URL that resolves to a valid .png or .svg file.

Note: images will be capped at 64 x 64 pixels.|40.73430,-73.99110
Radar Static Map with custom marker images

Rendering a route#

Radar Routing API responses include the shape of the route in either the polyine or LineString format. Both of these formats are supported for rendering a path, which can be used to plot the route in a static image.|icon:|40.70425,-73.9865&markers=size:small|icon:|40.73412,-73.99128&path=borderwidth:2|border:0xFFFFFF|width:3|stroke:0x000257|enc:g{rwFnlrbMkArDENGRiCfIEJCJHFpA|@VPHFDOBGdC_IFQDO|BiHHUJBb@FxARLBH@l@HbANB?LDJF@@vAfAJHHF|AnAHFHHhA|@RNJJ|@r@LJJFHHh@`@p@h@JJJF~ApAJHFFzAlADDHFJHbAx@^XJHHHrB~ADDBBJFl@f@@@ZVb@%08Av@LJVRBURsAN}@BQ@K?AN_AFWDUPq@BMBKj@wBBMDMh@sBBMBMTy@Pu@BIDQPDd@NnATtBh@`@Ll@NJBD@`Cl@HBFBjBj@D@JBHBTFx@TJDVFTF`@LZAnA`@JBJDlDfALDLD~@`@fAd@hAf@JFHDjBbAJD@@LFj@ZJFVLZQtA}@ZUHGJKHKV]HKFIHIFGJIHGLILGjAg@t|Aks@H?JCJCRIFEHCHCH?FAF@F@HBFDFHDHBJ@L@JALAJCHEFEHE@C@C@I@I?I@G@I@KAc@AeACy@AG?I@KBODIBGBOF}@b@OFBgA?IM?Q?_@Ai@Cs@AI?I@K?yCKK?MAsAC_@AG?IAmBEI?[A
Radar Static Map with route

Images for high resolution device#

When embedding images on high resolution devices, images may look blurry (low resolution) or be too small if the image is not scaled to match the device's pixel ratio.

The scale parameter can be used to increase the resolution of an image, while keeping the same map area visible. For example an image with scale=2 will return an image that is two times the size, but at the same zoom/area.,-74.00183&zoom=12&style=radar-default-v1&scale=2&publishableKey=prj_live_pk_...
200x200 @ 1x scale200x200 @ 2x scale
Radar Static Map over New York City
Radar Static Map over New York City


See Maps coverage for more details.


Have questions? We're here to help! Contact us at