/static-maps/arcgis/{arcgis-style}/with-many-points | Esri Developer REST APIs documentation

POST
Use dark colors for code blocksCopy
https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/{arcgis-style}/with-many-points

Returns a static map that displays an ArcGIS Basemap style and multiple points.

arcgis/imagery

Returns 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 1024 points using specific pin, circle, or custom symbols.
display only some points with a symbol.
provide custom labels for each pin or circle symbol.

Choose the GET option if you want to:

display up to 10 points on your static map using the same simple pin or circle symbol, or no symbols at all.
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	Description
`graphics`	`GraphicManyPoints`	The manyPoints geometry and its associated symbol. The symbol can be a simple marker symbol or a custom marker symbol.
`image`	`Image`	Define the width, height and format of the requested static map image.
`map`	`Map`	Represents the visible extent of the map.

graphics

The manyPoints geometry and its associated symbol. The symbol can be a simple marker symbol or a custom marker symbol.

image

Define the width, height and format of the requested static map image.

map

Represents the visible extent of the map.

This object specifies:

radius: The distance from the center point that determines the coverage area. zoom: The map zoom level controlling the scale and detail of the map. center: The geographic coordinates (latitude and longitude) of the focal point for the map.

Note: zoom and radius are mutually exclusive.

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	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

streets

Click to copy

streets-night

Click to copy

navigation

Click to copy

navigation-night

Click to copy

imagery

Click to copy

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

Use dark colors for code blocksCopy
# 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/with-many-points' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  --data '{"graphics":{"customSymbols":{"parkEntrance":"data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyMSAyMSI+PHBhdGggZD0iTTE4IDkuOTk4di0xbC03LjUtNi03LjUgNnYxaDF2NkgzdjFoMTV2LTFoLTF2LTZoMXptLTEyIDBoM3YzSDZ2LTN6bTYgNnYtNmgzdjZoLTN6Ii8+PC9zdmc+","campground":"data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyMSAyMSI+PHBhdGggZD0iTTEyLjQwMiAxNi45NzZIMTlMMTAuNTAzIDIuOTk4IDIgMTYuOTc2aDYuNjI2bDEuODg4LTguOTR6Ii8+PC9zdmc+"},"manyPoints":[{"geometry":{"x":-117.1957,"y":34.0561,"spatialReference":{"wkid":4326}},"symbol":{"customSymbolId":"campground","scale":1,"offsetX":0,"offsetY":0}}]},"image":{"width":500,"height":500,"format":"png","padding":[10,0,10,20]},"map":{"radius":1000,"zoom":12,"center":{"x":-117.1957,"y":34.0561,"spatialReference":{"wkid":4326}}}}'

Use dark colors for code blocksCopy
const inputBody = {
  "graphics": {
    "customSymbols": {
      "parkEntrance": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyMSAyMSI+PHBhdGggZD0iTTE4IDkuOTk4di0xbC03LjUtNi03LjUgNnYxaDF2NkgzdjFoMTV2LTFoLTF2LTZoMXptLTEyIDBoM3YzSDZ2LTN6bTYgNnYtNmgzdjZoLTN6Ii8+PC9zdmc+",
      "campground": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyMSAyMSI+PHBhdGggZD0iTTEyLjQwMiAxNi45NzZIMTlMMTAuNTAzIDIuOTk4IDIgMTYuOTc2aDYuNjI2bDEuODg4LTguOTR6Ii8+PC9zdmc+"
    },
    "manyPoints": [
      {
        "geometry": {
          "x": -117.1957,
          "y": 34.0561,
          "spatialReference": {
            "wkid": 4326
          }
        },
        "symbol": {
          "customSymbolId": "campground",
          "scale": 1,
          "offsetX": 0,
          "offsetY": 0
        }
      }
    ]
  },
  "image": {
    "width": 500,
    "height": 500,
    "format": "png",
    "padding": [
      10,
      0,
      10,
      20
    ]
  },
  "map": {
    "radius": 1000,
    "zoom": 12,
    "center": {
      "x": -117.1957,
      "y": 34.0561,
      "spatialReference": {
        "wkid": 4326
      }
    }
  }
};

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer <YOUR_TOKEN>"
};

fetch("https://static-maps-api.arcgis.com/arcgis/rest/services/static-maps-service/beta/static-maps/arcgis/streets/with-many-points", {
  method: "POST",
  body: inputBody,
  headers: headers
}).then(response => {
  if (response.status === 200) {
    return response.blob();
  }
  return response.json();
}).then(body => {
  console.log(body);
});