https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/using-many-pointsReturns a static map that displays an ArcGIS Basemap style for multiple WGS84 points, as defined by the Points type.
The geographical extent of the map is defined by the location of the
points and a padding width. The static map image width and height can be
defined, along with the image format, which can be png, jpeg, or
webp.
To use a custom SVG symbol, store the base64‑encoded data URL string
representing the SVG image in the customSymbols property. This
property is a dictionary, where the key is a unique string, such as
campground, and the value is a base64‑encoded data URL string
representing the SVG image. To symbolize a specific geometry with a
custom symbol, pass the key to the customSymbolId.
You must supply an access token in the header for POST endpoints.
Choose this option if you want to:
- display up to 10 points using specific
pin,circle, or custom symbols. - provide custom labels for each
pinorcirclesymbol.
Choose the GET option if you want to:
- display up to 10 points on your static map using the same
pinorcirclesimple symbol. - label simple symbols with sequential numbers or letters.
Please note that the ArcGIS Basemap style attribution statement must be
displayed every time the static map is visible. It must be positioned
very close to the static map, or it can be provided via a popup or menu
if the static map is embedded in an application or website. The relevant
attribution statement for an ArcGIS Basemap style is available from the
/static-maps/arcgis/{arcgis-style}/attribution endpoint. For more
information see the ArcGIS Location Platform Agreement on the
Terms of use.
Body parameters
Supported content types: application/json, application/x-www-form-urlencoded
| Name | Type | Required | Default value | Description |
|---|---|---|---|---|
manyPoints | ManyPoints | | An array x,y coordinate pairs in the WGS84 spatial reference along with their associated symbol definitions. | |
customSymbols | CustomSymbols | |
| |
mapImageWidth | MapImageWidth | 200 | The width of the requested map image in pixels at 96 DPI between 64 and 1024 pixels. | |
mapImageHeight | MapImageHeight | 200 | The height of the requested map image in pixels at 96 DPI between 64 and 1024 pixels. | |
mapImageFormat | MapImageFormat | webp | The format of the map image, such as | |
padding | Padding | 0 | The padding applied to the static map adds extra map content between the static map's extent and the edge of the image. |
manyPoints
An array x,y coordinate pairs in the WGS84 spatial reference along with their associated symbol definitions.
The symbol can be a simple marker symbol or a custom marker symbol.
To use a custom SVG symbol, store the base64‑encoded data URL string
representing the SVG image in the customSymbols property. This
property is a dictionary, where the key is a unique string, such as
campground, and the value is a base64‑encoded data URL string
representing the SVG image. To symbolize a specific geometry with a
custom symbol, pass the key to the customSymbolId.
customSymbols
customSymbols is a dictionary of key-value pairs, where each pair defines a custom symbol to be added to the map.
The key is a unique string, such as campground or parkEntrance, and
the value is a base64‑encoded data URL string representing the SVG
image. To symbolize a specific geometry with a custom symbol, pass the
key to the customSymbolId.
The general format of a base64‑encoded data URL string is
data:[<mediatype>][;base64],<data>, as specified
here.
To construct the data URL for an SVG image follow these steps:
- Obtain the XML string from the SVG file.
- Encode the XML string into base64 format.
- Append the base64-formatted string to
data:image/svg+xml;base64,.
There is a range of SVG symbols from ESRI available from the Calcite point symbols repository or the Esri developer Place icons site.
The maximum length of the base64‑encoded data URL string is 4000 characters.
Unsupported SVG Features
- SVG images must not reference external resources using URLs.
- Embedded raster images, such as PNG, JPG, and WebP formats, are not supported.
- SVG images that contain font-based text elements are not supported.
- It is recommend that text is converted into vector paths so that it can be rendered in custom symbols.
mapImageWidth
The width of the requested map image in pixels at 96 DPI between 64 and 1024 pixels.
- Minimum
- 64
- Maximum
- 1024
- Default
- 200
mapImageHeight
The height of the requested map image in pixels at 96 DPI between 64 and 1024 pixels.
- Minimum
- 64
- Maximum
- 1024
- Default
- 200
mapImageFormat
The format of the map image, such as png, jpg, webp.
- Default
- webp
Enumerated values
padding
The padding applied to the static map adds extra map content between the static map's extent and the edge of the image.
Padding value is a % of the static map image's width and/or height. It is applied to the static map image, according to the table below:
| Number of values in the array | Description | Example |
|---|---|---|
| One | The same padding % is applied to all four sides. | [10] |
| Two | The first value applies padding to the top and bottom, the second to the left and right sides. | [10, 5 ] |
| Three | The first value applies padding to the top, the second to the left and right sides, and the third to the bottom. | [10, 20, 10] |
| Four | The four values apply padding to the top, right, bottom, and left in a clockwise order. | [10, 5, 5, 20] |
- Default
- [0]
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
arcgis-style | string | The name of a style from the ArcGIS Basemap style family. |
arcgis-style
The name of a style from the ArcGIS Basemap style family.
| Group | Style | Example | Description | Data attribution |
|---|---|---|---|---|
| Streets | navigation |  | A custom navigation style designed for use during daylight hours | Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community |
| Streets | navigation-night |  | A custom navigation style designed for use in hours of darkness | Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community |
| Streets | streets |  | A classic Esri street map style designed for use during daylight hours | Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community |
| Streets | streets-night |  | A classic Esri street map style designed for use in hours of darkness | Esri, TomTom, Garmin, FAO, NOAA, USGS, © OpenStreetMap contributors, and the GIS User Community |
| Satellite | imagery |  | Low-resolution satellite imagery for the world and high-resolution satellite and aerial imagery, typically within 3-5 years of currency, for most of the world. | Esri, Vantor, GeoEye, Earthstar Geographics, CNES/Airbus DS, USDA, USGS, AeroGRID, IGN, © OpenStreetMap contributors, TomTom, Garmin, FAO, NOAA, and the GIS User Community |
Enumerated values
Response status
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Static map in a desired image format. | string(binary) |
| 400 | Bad Request | Invalid query parameters / Incorrect portal item type / Data URL parse failure. | Error |
| 401 | Unauthorized | Authentication Error. The API key or token is missing, invalid or expired. | Error |
| 403 | Forbidden | The requested resource cannot be accessed because of incorrect sharing permissions. | Error |
| 404 | Not Found | The requested resource cannot be found - this could be due to missing map data at the requested location and zoom level. | Error |
| 5XX | Server Error | An error occurred on the server. | Error |
Examples
Request
# You can also use wget
curl -X POST 'https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/streets/using-many-points' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
--data '{"manyPoints":{"manyPoints":[{"geometry":{"x":-117.1957,"y":34.0561,"spatialReference":{"wkid":4326}},"symbol":{"customSymbolId":"campground","scale":1}}]},"customSymbols":{"parkEntrance":"data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyMSAyMSI+PHBhdGggZD0iTTE4IDkuOTk4di0xbC03LjUtNi03LjUgNnYxaDF2NkgzdjFoMTV2LTFoLTF2LTZoMXptLTEyIDBoM3YzSDZ2LTN6bTYgNnYtNmgzdjZoLTN6Ii8+PC9zdmc+","campground":"data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyMSAyMSI+PHBhdGggZD0iTTEyLjQwMiAxNi45NzZIMTlMMTAuNTAzIDIuOTk4IDIgMTYuOTc2aDYuNjI2bDEuODg4LTguOTR6Ii8+PC9zdmc+"},"mapImageWidth":200,"mapImageHeight":200,"mapImageFormat":"webp","padding":[10,0,10,20]}'