{"uid":"cap_jR9_9gI7-yLCGZHiKVqdP","slug":"mapbox-static-image-10456d81","name":"Mapbox Static Image","description":"Generate a static map image (PNG/JPEG) with optional markers, lines, and polygons. Returns base64-encoded image data.","url":"https://mapbox.mpp.paywithlocus.com/mapbox/static-image?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","allOf":[{"anyOf":[{"required":["position"]},{"required":["overlay"]}],"description":"position or overlay is required"}],"properties":{"logo":{"type":"boolean","description":"Show Mapbox logo (default true)"},"size":{"type":"string","description":"Image dimensions: \"widthxheight\" in pixels, max 1280x1280 (default \"600x400\")"},"style":{"type":"string","description":"Map style (default \"mapbox/streets-v12\"). Options: mapbox/streets-v12, mapbox/outdoors-v12, mapbox/light-v11, mapbox/dark-v11, mapbox/satellite-v9, mapbox/satellite-streets-v12"},"retina":{"type":"boolean","description":"Generate @2x high-DPI image"},"overlay":{"type":"string","description":"Markers, paths, or GeoJSON overlay. E.g. \"pin-s+ff0000(-73.99,40.73)\" for a red marker"},"padding":{"type":"string","description":"Padding around auto-fit overlay (CSS shorthand: \"top,right,bottom,left\")"},"position":{"type":"string","description":"Map center and zoom: \"lon,lat,zoom\" or \"auto\" to fit overlay bounds (default \"auto\")"},"attribution":{"type":"boolean","description":"Show attribution (default true)"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"logo":true,"size":"800x600","style":"mapbox/streets-v12","overlay":"pin-s+ff0000(-73.9857,40.7484)","position":"auto","attribution":true},"response":{"_truncated":true,"_originalSize":89550}},"exampleRequest":{"logo":true,"size":"800x600","style":"mapbox/streets-v12","overlay":"pin-s+ff0000(-73.9857,40.7484)","position":"auto","attribution":true},"tags":["maps","geocoding","directions","routing","geospatial","data"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"1.00","successRate":"0.94","reviews":2,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"0.4000","medianCents":"0.4000","p90Cents":"0.4000","minCents":"0.4000","maxCents":"0.4000","p95Cents":"0.4000","sampleCount":11,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_II8A0GliXCSDsQT6byV5q","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Mapbox","brandSlug":"mapbox","brandBaseUrl":"https://www.mapbox.com","brandDocsUrl":"https://docs.mapbox.com/api/","whatItDoes":"Generates a static PNG map image from Mapbox tiles with optional markers, paths, and GeoJSON overlays","exampleAgentPrompt":"Generate an 800x600 Mapbox streets map image centered on Times Square in New York (lon -73.9857, lat 40.7484, zoom 14) with a red pin marker at that location.","exampleUseCases":null,"resultDescription":"A binary PNG image of the rendered map (up to 1280x1280px), optionally at @2x retina resolution, showing the requested map style, center position, zoom level, and any specified markers or GeoJSON overlays.","failureModes":["Invalid or unsupported map style returns an error","Image dimensions exceed 1280x1280 limit causing rejection","Malformed overlay string (e.g. bad GeoJSON or pin syntax) returns a 422 error","Invalid coordinate values (out of range lon/lat or zoom) cause request failure","Auto-position with no overlay specified may produce unexpected framing"],"whenToPreferThis":"Use this endpoint when you need a ready-to-display raster map image (PNG) for a specific location — ideal for embedding in emails, reports, UI previews, or social cards. Prefer this over interactive tile endpoints when a static snapshot is sufficient and interactivity is not required. Best when you need marker overlays or custom map styles in a single image output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":18,"lastUsedAt":"2026-09-19T09:54:20.511Z","lastSuccessfullyRanAt":"2026-09-19T09:49:18.247Z","lastHealthCheckAt":"2026-10-09T18:45:17.339Z","isFirstParty":false,"canonicalSlug":"mapbox-static-image-10456d81"}