# Reverse Geocode GPS Coordinates to Postal Address (OpenStreetMap Nominatim)

> Reverse Geocode GPS Coordinates to Postal Address (OpenStreetMap Nominatim) is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Converts latitude/longitude coordinates into a human-readable postal address including display name, country, state, city, road, and postcode via OpenStreetMap Nominatim.

## Facts

- Endpoint: GET https://api.x402node.dev/maps/reverse
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-5dfcc102
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KpjvOjVgho2ANldUPD5P1

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 api-x402node-dev-5dfcc102
```

Example prompt: What's the street address at latitude 38.8977, longitude -77.0365? I need the full postal address including road, city, state, and postcode.

## When to prefer this

Use this endpoint when an AI agent needs to convert raw GPS coordinates (lat/lng) into a human-readable postal address, especially in workflows involving location tagging, delivery address resolution, or presenting map pins as readable locations. Prefer this over forward geocoding endpoints when you already have coordinates and need address text.

## Known failure modes

- Coordinates outside populated areas may return incomplete or missing address fields
- Invalid latitude/longitude values return an error or empty result
- Coordinates in the ocean or remote wilderness may only return country-level data
- Rate limiting or upstream Nominatim outages may cause timeouts

## How this service works

Reverse geocode lat/lng to a postal address via OpenStreetMap Nominatim. Returns display name, country, state, city, road, postcode. Use ?lat=38.8977 and lng=-77.0365. Built for AI agents converting GPS coords to human-readable addresses. Accepts payment on Base or Solana — either network works.

## Output

Returns a structured postal address for the given coordinates, including a formatted display name, plus individual fields for country, state, city, road, and postcode.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "string",
       "description": "Lat (optional)"
      },
      "lng": {
       "type": "string",
       "description": "Lng (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-5dfcc102/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)