# sat.ipintel.ai Reverse Geocoding

> sat.ipintel.ai Reverse Geocoding is a paid API for AI agents from sat.ipintel.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Converts latitude and longitude coordinates into a normalized address with locality, administrative area, postcode, and country metadata

## Facts

- Endpoint: POST https://sat.ipintel.ai/coordinates-to-address
- 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/sat-ipintel-ai-reverse-geocoding-1af3bc46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O_LOS6Roi-GGOAoqaLNp4

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 sat-ipintel-ai-reverse-geocoding-1af3bc46 -d '<json body>'
```

Example prompt: What's the street-level address at coordinates 48.8584° N, 2.2945° E? Give me the full address including postcode and country in English.

## When to prefer this

Use this endpoint when you have GPS or decimal-degree coordinates and need a human-readable address or location metadata. Ideal for enriching location data from device GPS, satellite imagery, or IoT sensors. Choose this over forward geocoding when you have coordinates but not a place name. The granularity type parameter lets you control resolution from country-level down to street or amenity level.

## Known failure modes

- Coordinates out of valid range (lat outside -90/90 or lon outside -180/180) return a validation error
- Coordinates falling in ocean or remote area with no address data may return null or partial results
- Unsupported language codes may fall back to default language or return an error
- Missing required lat/lon fields return a 400-level error
- Network or service unavailability returns a 5xx error

## How this service works

Worldwide reverse geocoding for agents. Convert latitude and longitude into a normalized address, locality, administrative area, postcode, and country metadata.

## Output

A normalized address object containing structured components: street address, locality (city/town), administrative area (state/region), postcode, and country metadata corresponding to the input coordinates, resolved to the requested granularity level.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "type": {
   "enum": [
    "country",
    "state",
    "city",
    "postcode",
    "street",
    "amenity"
   ],
   "type": "string"
  },
  "language": {
   "type": "string",
   "maxLength": 12,
   "minLength": 2,
   "description": "Preferred response language."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "coordinates-to-address",
  "cached": false,
  "result": {
   "lat": 48.8584,
   "lon": 2.2945,
   "city": "Paris",
   "country_code": "FR",
   "formatted_address": "Eiffel Tower, 5 Avenue Anatole France, 75007 Paris, France"
  },
  "provider": "geoapify"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sat-ipintel-ai-reverse-geocoding-1af3bc46/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sat.ipintel.ai](https://www.zero.xyz/host/sat.ipintel.ai/llms.txt)