ITMOField Guide
Map & Images

Get a map image for one report

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

A PNG map image highlighting the hexagon of a single report, handy for link previews. Only these sizes are accepted: 1200x600, 1000x500, 800x400, 600x300, 400x200, 400x250 and 300x150.

This endpoint is limited to 20 requests per minute, because every request renders a fresh image. Please cache the result on your side. Successful responses are cacheable by browsers and CDNs for about a month.

Returns 404 if the report does not exist or is not publicly available, and 400 for an unsupported size or a report without a map location.

Path Parameters

report*integer

Numeric report id.

Range1 <= value
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

Response Body

A PNG image.

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

List today's reports in a map cell GET

The individual reports behind one hexagon of today's map, using the `h3_index` returned by the map endpoints. Cursor-paginated, 10 per page. A valid cell that is not on today's map returns an empty list rather than a 404. This endpoint is limited to **60 requests per minute**. Responses are not cacheable (`Cache-Control: private, no-store`) and do not carry an `ETag`.

Get a map image for a whole day GET

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.