<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "Snapshots",
  "identifier" : "/documentation/Snapshots/Get-a-map-snapshot",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Maps Web Snapshots"
    ],
    "preciseIdentifier" : "rest:snapshots:get:api-v1-snapshot"
  },
  "title" : "Create a Maps Web Snapshot"
}
-->

# Create a Maps Web Snapshot

Generates a map image with characteristics that you provide in the query parameters.

## Discussion

Use the Snapshot URL query parameters to define characteristics of the map image such as dimensions, language, color scheme, and more.

You must sign every Snapshot URL request and include the signature as the final parameter. For details and example code, see [Generating a URL and Signature to Create a Maps Web Snapshot](/documentation/Snapshots/generating-a-url-and-signature-to-create-a-maps-web-snapshot).

## See Also

[Generating a URL and Signature to Create a Maps Web Snapshot](/documentation/Snapshots/generating-a-url-and-signature-to-create-a-maps-web-snapshot)

Create a Snapshot URL and generate a signature to validate the request.

[`Annotation`](/documentation/Snapshots/Annotation)

An object for a Snapshot URL that describes annotation characteristics.

[`Overlay`](/documentation/Snapshots/Overlay)

A JSON object for a Snapshot URL that describes overlay shape characteristics, including points for the overlay and styles such as width, color, and dash pattern.

[`OverlayStyle`](/documentation/Snapshots/OverlayStyle)

A  JSON object that describes reusable styles for an overlay.

[`Image`](/documentation/Snapshots/Image)

A JSON object for a Snapshot URL that describes the characteristics of custom images to use for map annotations.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)