# Rotary Agency Photon Geocoding API

> Rotary Agency Photon Geocoding API is a paid API for AI agents from rotaryagency.uk, paid per call via x402, $0.002/call, status down (last checked 2026-10-13).

Forward and reverse geocoding using the Photon open-source geocoder, returning structured location data from OpenStreetMap data

## Facts

- Endpoint: GET https://rotaryagency.uk/api/free/photon?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rotary-agency-photon-geocoding-api-4a03ffba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w5jpLRIe4C810Rj4PV17T

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 rotary-agency-photon-geocoding-api-4a03ffba
```

Example prompt: Can you geocode '10 Downing Street, London' and give me the exact latitude and longitude using the Photon geocoder?

## When to prefer this

Choose this endpoint when you need free, open-source-backed geocoding without vendor lock-in, leveraging OpenStreetMap data via Photon. Ideal for agents that need to convert place names or addresses to coordinates (or vice versa) at low cost ($0.002/call) without a Google Maps or HERE API key. Prefer it for general forward/reverse geocoding where OSM coverage is sufficient.

## Known failure modes

- Empty results array if no matching place is found for the query
- Ambiguous results when query matches multiple places (returns ranked list)
- HTTP 402 payment required if USDC payment header is missing or insufficient
- Rate limiting or timeout if the upstream Photon service is unavailable
- Malformed query string may return unexpected or zero results

## How this service works

Free-source data APIs (100% margin, no proxy, $0.002/call): ...

## Output

Returns a GeoJSON FeatureCollection with matched location features, each including geometry (coordinates), and properties such as name, country, city, street, housenumber, postcode, OSM type, and OSM ID.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "varies": "endpoint-specific structured JSON"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rotary-agency-photon-geocoding-api-4a03ffba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rotaryagency.uk](https://www.zero.xyz/host/rotaryagency.uk/llms.txt)