{"uid":"cap_BQrb_KVL2cqRF3gWUjHOE","slug":"mapbox-static-image-via-locus-x402-0c39da97","name":"Mapbox Static Image via Locus x402","description":"Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.","url":"https://mapbox.x402.paywithlocus.com/mapbox/static-image","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"logo":{"type":"boolean"},"size":{"type":"string"},"style":{"type":"string"},"retina":{"type":"boolean"},"overlay":{"type":"string"},"padding":{"type":"string"},"position":{"type":"string"},"attribution":{"type":"boolean"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gF1sDnhB8URJ2O3jnt23W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a static map image PNG from coordinates, overlays, and style options, billed per-call via x402 micropayment.","exampleAgentPrompt":"Can you generate a 800x600 satellite-streets style static map image centered on Times Square (lon -73.9855, lat 40.7580, zoom 14) with a red pin marker and a high-DPI retina version?","exampleUseCases":[{"title":"Embed map in email newsletter","prompt":"Generate a 600x400 streets-style static map image centered on our San Francisco office at longitude -122.4194, latitude 37.7749, zoom level 13, with a small red marker on the office location — I want to paste it into our event invite email."},{"title":"Satellite thumbnail for real estate listing","prompt":"Create a high-DPI 1280x800 satellite map image of the property at longitude -87.6298, latitude 41.8781 with zoom 16 and no Mapbox logo, for our real estate listing page."},{"title":"Dark-mode map for analytics dashboard","prompt":"Render a 400x400 dark-style map image centered on London (lon -0.1278, lat 51.5074, zoom 11) for embedding in our analytics dashboard — use the dark-v11 style and include attribution."}],"resultDescription":"Returns a JSON response containing a success flag, a data object (which includes the rendered static map image or a URL to it), payment settlement details (USDC amount authorized and settled), and a request ID with a status URL for tracking the call.","failureModes":["Invalid coordinates or zoom level outside Mapbox limits returns an error","Image dimensions exceeding 1280x1280 are rejected","Invalid style identifier causes a bad request error","Payment failure or insufficient USDC balance prevents the call from completing","Malformed overlay syntax (e.g. invalid GeoJSON or marker format) returns a parsing error","'auto' position without a valid overlay provided may result in a default or error response"],"whenToPreferThis":"Choose this endpoint when you need a rendered, embeddable static map image — not interactive maps or raw geodata — and want pay-per-call micropayment billing via x402 without managing a Mapbox API key subscription. It is ideal for one-off or low-volume map image generation in agent workflows, reports, emails, or thumbnails where interactive tiles are unnecessary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:10:57.984Z","isFirstParty":false}