Generate static map images from Mapbox via pay-per-call MPP on Tempo L2.
What it does
This endpoint generates static map images using the Mapbox Static Images API, proxied through the Locus MPP (Micropayment Protocol) gateway. Each call costs 4,000 base units of pathUSD (6 decimals), which equals $0.004 per request, settled on Tempo L2.
You POST a JSON body specifying map style (streets, outdoors, light, dark, satellite, satellite-streets), center position and zoom (or "auto" to fit overlays), image dimensions up to 1280×1280 pixels, optional overlays (markers, paths, GeoJSON), retina support, and attribution/logo toggles. The endpoint returns the rendered map image on successful payment.
This static-image endpoint is part of a broader Mapbox suite available on the same Locus MPP gateway, which also exposes forward/reverse geocoding, directions, matrix routing, isochrone, map matching, and tilequery endpoints — each with its own per-call pricing. The endpoint accepts POST requests; the probe returned 404 on HEAD/GET, which is expected for a POST-only route. The OpenAPI spec lists a full request schema and a 402 payment challenge flow.
Capabilities
Use cases
- —Embedding map thumbnails in emails, reports, or chat messages without a JavaScript map SDK
- —Generating location preview images for property listings or event pages
- —Creating map images with custom markers for delivery or logistics dashboards
- —Producing satellite or street-view snapshots for automated geospatial reports
- —Adding map context to AI agent responses without requiring a browser
Fit
Best for
- —Agents that need map images without browser rendering
- —Serverless or headless environments that cannot run a map SDK
- —Pay-per-use map image generation without a Mapbox API key subscription
- —Quick prototyping of location-aware features with minimal setup
Not for
- —Interactive, pannable/zoomable web maps (use Mapbox GL JS instead)
- —High-volume batch tile rendering where a direct Mapbox enterprise plan is cheaper
- —Applications requiring vector tiles or client-side styling
Quick start
curl -X POST https://mapbox.mpp.paywithlocus.com/mapbox/static-image \
-H "Content-Type: application/json" \
-d '{
"style": "mapbox/streets-v12",
"position": "-73.99,40.73,12",
"size": "600x400",
"overlay": "pin-s+ff0000(-73.99,40.73)"
}'Example
Request
{
"logo": true,
"size": "600x400",
"style": "mapbox/streets-v12",
"retina": false,
"overlay": "pin-s+ff0000(-73.99,40.73)",
"position": "-73.99,40.73,12",
"attribution": true
}Endpoint
Quality
Full OpenAPI schema with request parameters and pricing is available. However, the probe returned 404 on HEAD/GET (expected for POST-only), no example response was captured, and crawled pages returned only generic 404 JSON. No response schema or sample output is documented.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint is POST-only, so liveness could not be confirmed via the probe methods used
- —No response schema or example response is documented in the OpenAPI spec
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on Tempo L2 conventions; if decimals differ, the stated price of $0.004 would be incorrect
- —All crawled documentation pages returned 404; external docs at https://beta.paywithlocus.com/mpp/mapbox.md were not fetched
Citations
- —Static Image endpoint charges 4000 base units via Tempo method with the listed currencyhttps://mapbox.mpp.paywithlocus.com
- —Request schema supports style, position, size, overlay, retina, attribution, logo, and padding parametershttps://mapbox.mpp.paywithlocus.com
- —Available map styles include streets-v12, outdoors-v12, light-v11, dark-v11, satellite-v9, satellite-streets-v12https://mapbox.mpp.paywithlocus.com
- —External API reference and LLM docs are listed at docs.mapbox.com/api/ and beta.paywithlocus.com/mpp/mapbox.mdhttps://mapbox.mpp.paywithlocus.com