# Suverse Geocode Place

> Suverse Geocode Place is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Converts a place name into geographic coordinates (latitude/longitude) and metadata using Open-Meteo's geocoding service, returning ranked matches with country, admin region, and population.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-geocode-place
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-geocode-place-1bc3aec8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IqENOnVKLen5Dect1Uwmq

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 suverse-geocode-place-1bc3aec8 -d '<json body>'
```

Example prompt: What are the latitude and longitude coordinates for Lyon, France? I need them to pass into a weather or mapping lookup.

## When to prefer this

Choose this endpoint when you need to resolve a human-readable place name to geographic coordinates without managing an API key. It is ideal for AI agents that need to feed coordinates into downstream services (weather, maps, time zones) and want a no-auth, pay-per-call solution. Prefer it over Google Maps Geocoding or Mapbox when cost predictability and keyless operation matter more than exhaustive address-level precision.

## Known failure modes

- Ambiguous place name returns multiple ranked matches requiring disambiguation
- Very obscure or misspelled place names may return zero results
- The upstream Open-Meteo geocoding service being unavailable causes a degraded or error response
- Payment failure via x402 protocol blocks the request before geocoding occurs

## How this service works

Geocode a place name to coordinates via the Open-Meteo geocoding service, no key. Returns ranked matches with latitude, longitude, country, admin region, and population. For AI agents turning place names into coordinates for downstream lookups.

## Output

Returns a ranked list of matching locations for the queried place name, each including latitude, longitude, country name, country code, administrative region, and population. Results are ordered by relevance so the top match is typically the most canonical location.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-geocode-place-1bc3aec8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)