Create a Maps Web Snapshot

Only use this parameter if you don’t provide a token parameter. Your Apple Developer Team ID. For more information, see Creating a Maps identifier and a private key.

Only use this parameter if you don’t provide a token parameter. Your MapKit JS Key ID. For more information, see Creating a Maps identifier and a private key.

Only use this parameter if you don’t provide a token parameter. A Base64, URL-encoded signature that signs the request path and query parameters. The signature must be the last parameter in the request URL; otherwise, the request returns status code 401 Unauthorized. See Generating a URL and Signature to Create a Maps Web Snapshot.

The center of the map. You can specify center as coordinates, as an address, or with the string auto when you add annotations and overlays.

Provide coordinates as a string with the latitude and longitude separated by a comma, such as:

center=37.78%2C-122.42

If you specify center as coordinates, the latitude must be in the range (-90, 90) and longitude must be in the range (-180, 180).

A geocoded address is a valid value for the center parameter, such as:

center=San%20Francisco%20City%20Hall%20in%20San%20Francisco%2C%20California

The string auto is also a valid value for the center parameter, for example:

center=auto

If you specify center=”auto”, the Web Map Snapshot API returns a map that includes all overlays or annotations. The API requires annotations or overlays when you use center=”auto”.

The zoom level of the map.

The Web Map Snapshot API ignores the z parameter when you specify auto for the center parameter, or when you specify both spn and z parameters.

A comma-separated coordinate span that indicates how much of the map Web Map Snapshots API displays around the map’s center. The latitude must be in the range of (0, 90), and the longitude must be in the range (0, 180). The latitude and longitude delta parameters must be positive numbers; the API treats negative numbers as 0.

The Web Map Snapshot API ignores the spn parameter if you specify auto for the center parameter. If you provide both z and spn parameters, the value for spn takes precedence over z.

The size of the image in pixels. Specify the size as width and height integers separated by the character x. For example, 640x480 creates an image 640 pixels wide and 480 pixels tall.

The width and height must be within the range of [50, 640].

The pixel density of the image. scale=2 returns an image intended for 2x Retina displays. Setting scale to values greater than 1 increases the number of pixels in the generated image.

The map type.

The color scheme of the map. The dark color scheme only applies to the standard and mutedStandard map types.

A Boolean value that indicates whether to show points of interest on the map. To hide points of interest, set poi=0.

The language that Maps Web Snapshots API uses for labels on the map. Supported values are locale IDs, such as en-GB or es-MX.

An array of annotations to display on the map, which you specify as JSON Annotation objects. Annotations layer on top of the map in the order you specify in the request.

An array of overlays to display on the map, which you specify as an array of JSON Overlay objects.

A JSON array of overlay styles. This object allows you to reuse style values on different overlays.

An array of custom images to annotate the map, specified as an array of JSON Image objects.

Only use this parameter if you don’t provide a token parameter. The referer string value to match against the request’s Referer header value. Requests that don’t match the referer parameter fail with HTTP status code 401 Unauthorized. Set a referrer restriction through the referer parameter.

Only use this parameter if you don’t provide a token parameter. The time in seconds from epoch at which the request expires. Expired requests fail with HTTP status code 401 Unauthorized. Set an expiration through the expires parameter.

A developer’s Maps token. For information on how to create a Maps token, see Creating a Maps token.