---
title: Image
framework: Maps Web Snapshots
role: symbol
role_heading: Object
platforms: [maps web snapshots 1.0+]
path: snapshots/image
---

# Image

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

## Declaration

```data
object Image
```

## Properties

url: A required property that takes the full URL that specifies the location of the image. As an alternative, you may provide a data URL. height: The height of the image in scale-independent pixels. This property only required when referencing an annotation with “markerStyle”: ”img”. width: The width of the image in scale-independent pixels. This property only required when referencing an annotation with “markerStyle”: ”img”.

## Discussion

Discussion Maps Web Snapshots API supports JPEG, PNG, and GIF image formats for providing custom annotations. You may use up to 10 unique images in a snapshot request, and you may use an image for more than one annotation. It’s a good idea to use a URL shortener for image URLs so you don’t exceed the maximum character limit for a Snapshots URL. If an image fails to load in a reasonable amount of time, the snapshot rendering uses the default “balloon” style marker. important: By providing an image URL, you’re responsible for ensuring the availability of the image at all times.

## See Also

### Essentials

- [Generating a URL and Signature to Create a Maps Web Snapshot](snapshots/generating-a-url-and-signature-to-create-a-maps-web-snapshot.md)
- [Annotation](snapshots/annotation.md)
- [Overlay](snapshots/overlay.md)
- [OverlayStyle](snapshots/overlaystyle.md)