# Mapbox Tilequery via Locus x402

> Mapbox Tilequery via Locus x402 is a paid API for AI agents from mapbox.x402.paywithlocus.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Queries vector tileset features at a geographic point, returning spatial features (polygons, lines, points) within a given radius from Mapbox tilesets.

## Facts

- Endpoint: POST https://mapbox.x402.paywithlocus.com/mapbox/tilequery
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapbox-tilequery-via-locus-x402-2f0785c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pYUVK2XjV2ILIP6F_rXlA

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-tilequery-via-locus-x402-2f0785c9 -d '<json body>'
```

Example prompt: Query the mapbox.mapbox-streets-v8 tileset at latitude 40.7580, longitude -73.9855 with a 100-meter radius, returning up to 10 features and filtering to polygon geometry only.

## When to prefer this

Choose this endpoint when you need to perform a spatial point query against a Mapbox vector tileset — especially for point-in-polygon, proximity queries, or feature lookups tied to a specific coordinate. Prefer it over geocoding when you already have coordinates and need tileset feature data rather than address resolution. Ideal for GIS enrichment, land use analysis, or querying custom tilesets.

## Known failure modes

- Invalid tileset_id returns an error or empty feature set
- Latitude/longitude out of range (-85 to 85 lat, -180 to 180 lon) causes validation error
- Radius too large for the tileset resolution may return incomplete results
- Layer names that don't exist in the tileset return empty results
- Limit outside 1-50 range may be rejected or clamped
- Payment failure returns a 402 response before the query is executed

## How this service works

Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.

## Output

Returns a GeoJSON FeatureCollection containing features from the specified Mapbox tileset that intersect with or fall within the given radius of the queried coordinate. Each feature includes geometry, layer name, and tileset properties. Also returns payment settlement confirmation and a request ID for status tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number"
  },
  "dedupe": {
   "type": "boolean"
  },
  "layers": {
   "type": "string"
  },
  "radius": {
   "type": "number"
  },
  "geometry": {
   "type": "string"
  },
  "latitude": {
   "type": "number"
  },
  "longitude": {
   "type": "number"
  },
  "tileset_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapbox-tilequery-via-locus-x402-2f0785c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mapbox.x402.paywithlocus.com](https://www.zero.xyz/host/mapbox.x402.paywithlocus.com/llms.txt)