# Mapbox Tile Image via gateway.apiosk.com

> Mapbox Tile Image via gateway.apiosk.com is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.11/call, status down (last checked 2026-09-15).

Fetches a 256x256 PNG map tile from Mapbox (e.g. satellite imagery) for a given tile coordinate, returning raw binary image bytes.

## Facts

- Endpoint: GET https://gateway.apiosk.com/mapbox/tile
- Price: $0.11/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapbox-tile-image-via-gateway-apiosk-com-d5c0f995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hjzLMOQ9OdAfcbUXJcSfW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mapbox-tile-image-via-gateway-apiosk-com-d5c0f995
```

Example prompt: Can you fetch me the Mapbox satellite tile for zoom level 12, tile X=1205, Y=1540 as a PNG image?

## When to prefer this

Use this endpoint when you need to retrieve individual Mapbox raster map tiles (e.g. satellite imagery) as PNG images via a pay-per-call x402 micropayment gateway, without needing a full Mapbox SDK or API key. It is ideal for AI agents that need to programmatically fetch map tile imagery on demand for a specific z/x/y coordinate.

## Known failure modes

- Invalid or out-of-range tile coordinates (z/x/y) returning a 400 or empty tile
- Payment not processed correctly resulting in 402 Payment Required
- Mapbox upstream service unavailable causing 502/503 errors
- Unsupported map style identifier causing a 404 or error tile
- Missing required tile coordinate parameters causing a 400 Bad Request

## How this service works

API call to mapbox

## Output

Raw binary PNG image data (approximately 76 KB) representing a 256x256 map tile. The response Content-Type is image/png and should be saved directly to a .png file to view the tile. No JSON body is returned — just the raw tile bytes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "note": "Binary tile image bytes are returned (no JSON body); a 256x256 PNG tile (~76 KB for mapbox.satellite at z=12, verified live). Save the raw response to a .png file to view it.",
 "content_type": "image/png"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapbox-tile-image-via-gateway-apiosk-com-d5c0f995/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)
