# sat.ipintel.ai Address-to-Coordinates (Forward Geocoding)

> sat.ipintel.ai Address-to-Coordinates (Forward 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 a free-form address, landmark, city, postcode, or place name into latitude/longitude coordinates with normalized address components and confidence metadata.

## Facts

- Endpoint: POST https://sat.ipintel.ai/address-to-coordinates
- 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-address-to-coordinates-forward-geocoding-3fa2a0ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NWDDf32eVmpd7H1c7EQyl

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-address-to-coordinates-forward-geocoding-3fa2a0ff -d '<json body>'
```

Example prompt: What are the latitude and longitude coordinates for 221B Baker Street, London, UK? Give me up to 2 results and respond in English.

## When to prefer this

Use this endpoint when you need to convert a human-readable address or place name into machine-readable coordinates (latitude/longitude) with normalized address output and confidence scoring. Prefer this over reverse geocoding (coordinates-to-address) endpoints. Ideal for agents that need to geolocate user-provided addresses, enrich location data, or feed coordinates into downstream services like mapping, hazard detection, or satellite imagery.

## Known failure modes

- Address not found or too ambiguous — returns empty results or low-confidence matches
- Invalid or malformed address string shorter than 3 characters — validation error
- Unsupported language code — may fall back to default or return error
- Invalid country_code (not ISO 3166-1 alpha-2) — validation error
- Payment failure (x402) — request rejected before processing
- Rate limiting — too many requests in a short window

## How this service works

Worldwide forward geocoding for agents. Convert an address, landmark, city, postcode, or place name into latitude and longitude with normalized address components and confidence metadata.

## Output

Returns up to 5 geocoding results (default 1), each containing latitude and longitude coordinates, normalized address components, and confidence metadata indicating match quality for the queried address or place name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 1,
   "maximum": 5,
   "minimum": 1
  },
  "address": {
   "type": "string",
   "maxLength": 500,
   "minLength": 3,
   "description": "Free-form place or postal address."
  },
  "language": {
   "type": "string",
   "maxLength": 12,
   "minLength": 2,
   "description": "Preferred response language, for example en or es."
  },
  "country_code": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2,
   "description": "Optional ISO 3166-1 alpha-2 country filter."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "address-to-coordinates",
  "cached": false,
  "results": [
   {
    "lat": 48.8584,
    "lon": 2.2945,
    "confidence": 0.99,
    "country_code": "FR",
    "formatted_address": "Eiffel Tower, 5 Avenue Anatole France, 75007 Paris, France"
   }
  ],
  "provider": "geoapify",
  "match_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sat-ipintel-ai-address-to-coordinates-forward-geocoding-3fa2a0ff/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)