get_static_map_url
Generate a static map image URL for use in email templates, PDF reports, or social sharing previews without requiring JavaScript.
Instructions
Build a URL for a static PNG map image centered on a location.
Returns: { url, auth_note, html_example }.
USE FOR: Email templates, PDF reports, social sharing previews, server-side image generation. No JavaScript needed.
ZOOM GUIDE:
1–4: Country/continent
6–8: Region/state
10–11: City
12–13: Neighbourhood
14–16: Street level (most common)
17–19: Building/parcel
AUTH: For server-side use, send X-API-Key header. For direct browser/img use, append &api_key=YOUR_KEY to the URL.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"lat": "<lat>",
"lon": "<lon>",
"zoom": "<zoom>",
"api_key": "<api_key>"
},
"name": "get_static_map_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Map center latitude. Range: -90 to 90. | |
| lon | Yes | Map center longitude. Range: -180 to 180. | |
| zoom | Yes | Zoom level 1–20. 14–16 for street level, 12 for neighbourhood, 10 for city overview. | |
| width | No | Image width in pixels. Default 600. | |
| height | No | Image height in pixels. Default 400. | |
| api_key | Yes | Mapsi API key. |