# orbit Geo & Time – Reverse Geocoding

> orbit Geo & Time – Reverse Geocoding is a paid API for AI agents from orbit-geo.orbit-builder.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Converts latitude/longitude coordinates into a structured nearest address using OpenStreetMap Nominatim data

## Facts

- Endpoint: GET https://orbit-geo.orbit-builder.workers.dev/v1/reverse?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orbit-geo-time-reverse-geocoding-868a9f04
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vMCtrCZRAG-MYN3fzrDhI

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 orbit-geo-time-reverse-geocoding-868a9f04
```

Example prompt: What's the street address at coordinates 40.7484, -73.9857? I need the full address including road, city, postcode, and country.

## When to prefer this

Choose this endpoint when you have GPS or lat/lon coordinates and need a human-readable structured address, especially when you need OSM-sourced data with full field breakdown (road, suburb, postcode, country code). It is best for one-off lookups at $0.001 USDC per call, works globally, and returns 404 without charging for unmapped ocean points. Prefer it over forward geocoding when you already have coordinates and need the address, not the other way around.

## Known failure modes

- 404 returned for ocean coordinates or unmapped/unpopulated areas (no charge)
- Missing or out-of-range lat/lon parameters cause a bad request
- Zoom level outside 3–18 may produce unexpected granularity
- Coordinates in disputed or sparsely mapped regions may return incomplete address fields

## How this service works

Location and time data for agents: weather now + 7-day forecast (MET Norway), geocoding and reverse geocoding (OpenStreetMap Nominatim), sunrise/sunset, world time-zone conversion and public holidays (Nager.Date). Real open data fetched at call time, attribution included. $0.001 per call. By orbit-builder.

## Output

A JSON object containing the full display name string, structured address fields (house number, road, suburb, city, county, state, postcode, country, ISO country code), and the OpenStreetMap object ID. Returns 404 (uncharged) for ocean or unmapped locations.

## 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",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "latitude"
      },
      "lon": {
       "type": "number",
       "description": "longitude"
      },
      "zoom": {
       "type": "integer",
       "description": "detail 3 (country) … 18 (building), default 18"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 40.7484,
  "lon": -73.9857,
  "name": "Empire State Building, 350, 5th Avenue, Manhattan, New York, 10118, United States",
  "address": {
   "city": "New York",
   "road": "5th Avenue",
   "postcode": "10118",
   "country_code": "us"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orbit-geo-time-reverse-geocoding-868a9f04/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orbit-geo.orbit-builder.workers.dev](https://www.zero.xyz/host/orbit-geo.orbit-builder.workers.dev/llms.txt)