Rendering till PNG

En <img>-tagg, ingen JavaScript-karta. Bra för nyhetsbrev, PDF:er, Open Graph-kort, Slack-botar och annat som inte kan köra WebGL.

<img src="https://api.kart-api.se/v1/render/karta?lat=58.7052&lng=15.7803&zoom=13&w=600&h=340&marker=15.7803,58.7052"
     width="600" height="340" alt="Karta över Finspång">

Parameter	Betyder
`lat`, `lng`, `zoom`	Centrum och zoom.
`bbox`	`väst,syd,öst,nord` i stället för centrum.
`w`, `h`	Bildstorlek i punkter, max 2000.
`scale`	1 eller 2 (retina). Default 2.
`style`	`ljus` eller `morker`.
`marker`	`lng,lat`. Upprepa parametern för flera markörer.
`pitch`, `bearing`	Lutning och rotation.

Vad du ska räkna med

Första anropet kan ta upp till ~20 sekunder. Bilden renderas i en riktig webbläsare på vår sida. Därefter ligger den i cache och kommer på millisekunder.
Högst två samtidiga externa renderingar. Renderkön delas med vår egen redaktion, och den tar en i taget. Blir kön full får du 429 med Retry-After i stället för en bild som aldrig kommer. Behöver du bulk: hör av dig, så pratar vi om det i stället för att du bränner kvoten.
Krediten är inbränd i bilden. Den kan inte beskäras bort utan att du bryter licensen.

Vinjetter

/v1/render/vinjett är en orienteringsbild över en kommun eller en punkt — den lilla kartan som visar *var i landet* något ligger.

curl -sD - -o vinjett.png 'https://api.kart-api.se/v1/render/vinjett?kommun=0562&w=600&h=400'

Den levereras bara om den kan fyllas. Saknas kartunderlag för ytan får du 503 och fältet lagsta_fyllande_zoom, i stället för en bild med hål i. Huvudet X-Fyllnad (0–1) säger hur stor andel av bilden som faktiskt blev karta, och X-Ready om renderingen hann klart.

Vi skickade en gång halvfärdiga bilder med 200 och ingen signal alls. Det är hela skälet till att de här två huvudena finns.