# Suverse Geo OSRM Nearest Road Snap

> Suverse Geo OSRM Nearest Road Snap is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Snaps a longitude/latitude coordinate to the nearest routable road using public OSRM, returning the matched road location, road name, and snap distance.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-geo-osrm-nearest
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-geo-osrm-nearest-road-snap-cb2132ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w_SFoKM9JVc-M0yUXCKzq

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 suverse-geo-osrm-nearest-road-snap-cb2132ae -d '<json body>'
```

Example prompt: Can you snap the coordinate -73.9857, 40.7484 to the nearest routable road and tell me the road name and how far off the road that point is?

## When to prefer this

Choose this endpoint when you need keyless, pay-per-call road snapping without setting up your own OSRM instance. Ideal for agents that need to correct raw GPS coordinates to the nearest routable road using OpenStreetMap data, especially when routing or map-matching fidelity matters and no API key management is desired. Prefer over raw geocoding APIs when the specific goal is snapping to a driveable road network rather than reverse geocoding to an address.

## Known failure modes

- Coordinate in an area with no road data in OpenStreetMap (remote/unmapped regions) — may return no match or large snap distance
- Invalid or out-of-range longitude/latitude values — likely returns an error or empty result
- OSRM public service unavailability causing upstream timeout
- Coordinate over water or non-routable terrain — snap distance may be very large or no match returned
- Missing or malformed required body fields — returns 400-level error

## How this service works

Snap a lon,lat coordinate to the nearest routable road via public OSRM. Returns matched location, road name and snap distance for the closest N points. Keyless OpenStreetMap map-matching for agents.

## Output

Returns the matched road location coordinates, the road name (from OpenStreetMap), and the distance in meters from the input coordinate to the snapped point on the road, for the closest N road points requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-geo-osrm-nearest-road-snap-cb2132ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)