ITMOField Guide
Map & Images

Get a map image for a whole day

GET
/map-image-daily/{date}/{width}x{height}.png

A PNG map image showing all of a day's hexagons, colored by what was reported. Only these sizes are accepted: 1200x600, 1000x500, 800x400, 600x300, 400x200, 400x250 and 300x150. A day with no data returns a plain default-view image.

Images are cached on the server for about 15 minutes, and repeat requests for a cached image do not count against the 20 per minute image limit (they still count toward the general 60 per minute limit). Rendering a new image is limited to 20 requests per minute per client. Responses are publicly cacheable.

Path Parameters

date*string

The day to render, as YYYY-MM-DD.

Formatdate
width*integer

Image width in pixels. Must form an allowed size with height (1200x600, 1000x500, 800x400, 600x300, 400x200, 400x250, 300x150).

Value in12001000800600400300
height*integer

Image height in pixels. Must form an allowed size with width.

Value in600500400300200250150

Query Parameters

states?array<>

Only draw hexagons that have reports in these states.

snapshot?integer

Snapshot sequence number, to render an earlier moment of the day. Defaults to the latest snapshot.

viewport?string

auto fits the view to the data. consistent uses a fixed default view, which keeps frames aligned when stepping through snapshots.

Default"auto"
Value in"auto""consistent"

Response Body

A PNG image.

response?stringimage/png
Example Request
curl -X GET 'https://api.isthemountainout.com/v1/map-image-daily/2026-08-15/800x400.png'
Example Response
"string"