Render a static map image
static_mapRead-onlyIdempotent
Render a map as an image (returned inline) with optional pins (markers) and a line (path, e.g. a route). Give center and zoom, or just markers and/or path and the view is fitted automatically. Also returns a reusable image URL for web pages (add your key). Counts 1 static image against the account's monthly cap. Do not use this to show a private address such as someone's home; use privacy_area_map instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | A line through these points, in order | |
| zoom | No | 0 = world, 10 = city, 15 = streets, 18 = buildings | |
| scale | No | Pixel density: 2 renders a sharper image for high-density screens at double the pixel size | |
| style | No | Map style: light (default), dark, white or grayscale | light |
| width | No | Image width in CSS pixels | |
| center | No | Map centre; use with zoom | |
| format | No | Image format. jpg and webp are smaller than png | png |
| height | No | Image height in CSS pixels | |
| markers | No | Pins to draw | |
| padding | No | Space in pixels kept around markers and paths when the view is fitted automatically | |
| parcels | No | Draw property parcel lines (visible from zoom 13; Growth plans and up). Not available on privacy_area_map | |
| parcel_id | No | Highlight one parcel (a parcel_id from parcel_lookup, e.g. us-37183-0794123456); the view fits it if no center is given |