---
title: "Render a static map image."
method: GET
path: "/styles/v1/{style}/static/{position}/{size}"
tags: ["Static Maps"]
---

# Render a static map image.

`GET /styles/v1/{style}/static/{position}/{size}`

## Request

- Base URL: `https://api.rijwind.com`
- URL: `https://api.rijwind.com/styles/v1/{style}/static/{position}/{size}`
- Auth: HTTP bearer

Render a static map image — a map drawn server-side and returned as a PNG, WebP, or JPEG you can drop straight into an `<img>` tag. Pass your API key as `?key=…`.

The viewport is `{lon},{lat},{zoom}` (optionally `,{bearing},{pitch}`), a bounding box `[{minLon},{minLat},{maxLon},{maxLat}]`, or the literal `auto` to frame the overlays. Add markers, paths, and a circle via the query string.

**Quota cost:** 1 unit per image; 2 units for `@2x` (High-DPI).

## Path parameters

- `style` string, required
- `position` string, required
- `size` string, required

## Query parameters

- `marker` string
- `path` string
- `circle` string
- `padding` string
- `attribution` string
- `lang` string
- `labels` boolean

## Response `200`

Rendered map image.

## Other responses

- `400`: Invalid style, size, or viewport.
- `401`: Missing, malformed, or revoked API key.
- `429`: Monthly quota exhausted.

---

[API](https://skmtc.dev/rijwind/apis/rijwind-api.md) · [All operations](https://skmtc.dev/rijwind/apis/rijwind-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rijwind/apis/rijwind-api/revisions/01d72fb6aa4d?raw)