The ArcGIS Static Maps service (beta) enables developers to create and easily embed map images from ArcGIS Basemaps on websites or in applications where interactive maps aren’t the best option.
Release Notes (0.5.0) : Released 26th May 2026
New features
Highlight an area or region on a map using polygon geometry via thewith-polygon endpoint:
Define the map extent by specifying the center coordinates (map, map) along with either a map (distance-based extent) or a map level.
Deprecated endpoints
The following endpoints have been deprecated:
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/centered-at
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/using-many-points
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/along-a-route
and have been replaced with the following endpoints:
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/with-point
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/with-many-points
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/with-polyline
Deprecated GET Params
| Deprecated GET parameter | New GET parameter |
|---|---|
| x | pointX |
| y | pointY |
| radius | mapRadius |
| padding | imagePadding |
| mapImageWidth | imageWidth |
| mapImageHeight | imageHeight |
| mapImageFormat | imageFormat |
Deprecated POST Params
| Deprecated POST parameter | New POST parameter |
|---|---|
| point | graphics{point} |
| radius | map{radius} |
| customSymbols | graphics{customSymbols} |
| mapImageWidth | image{width} |
| mapImageHeight | image{height} |
| mapImageFormat | image{format} |
| padding | image{padding} |
| manyPoints | graphics{manyPoints} |
| route | graphics{route} |
| routeStyle | graphics{routeStyle} |
Release Notes (0.3.2) : Released 16th March 2026
New features
ArcGIS Static Maps service (beta) now offers new functionality that allow developers to build the following types of static maps:
- Highlight a location in the center of a map using the
centered-at - Display many locations on a map with the
using-many-points - Show a route or path on a map using the
along-a-route
The POST requests offer more advanced functionality including the ability to display custom symbols.
Data attribution details are provided by the attribution request. Just supply the ArcGIS Basemap style in the request's {arcgis style} path parameter.
Changes since release 0.2.0
-
The following requests (using the
navigationArcGIS Basemap style, as an example)- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/generate-map/arcgis/navigation/centered-at
- https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/attribution/arcgis/navigation
have been replaced with
-
Creating a map image, using the
centered-atendpoint, now requires a radius around the point in metres. Previously, the request required azoom(or level of detail) value.Level -
The ArcGIS Basemap style is now specified using the
{arcgis style}path parameter in the request. -
Pin and circle are the only supported simple symbols.
-
Custom symbols are now displayed using the POST request.
Release Notes (0.2.0) : Released 3rd March 2025
- The ArcGIS Static Maps service (beta) enables developers to create and easily embed map images from ArcGIS Basemaps on websites or in applications where interactive maps aren’t the best option.