# Tokenguard Geocode — Place Name to Location Data

> Tokenguard Geocode — Place Name to Location Data is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Resolves a place name into geographic coordinates, country, admin region, timezone, elevation, and population data

## Facts

- Endpoint: GET https://eltociear-tokenguard.hf.space/world/geocode
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-geocode-place-name-to-location-data-85b15ec6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_szPu9JGj3ftwS6bCrEFrV

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 tokenguard-geocode-place-name-to-location-data-85b15ec6
```

Example prompt: Geocode 'Munich, Germany' and give me the top 3 candidates with their coordinates, timezone, elevation, and population.

## When to prefer this

Use this endpoint when you need a single call that returns rich geographic metadata (coordinates, timezone, elevation, population, admin region) from a free-text place name, especially as a prerequisite step before calling weather, mapping, routing, or time-zone-aware APIs. Prefer it over bare geocoders when you also need timezone and population alongside coordinates.

## Known failure modes

- Unknown or misspelled place name returns empty results array
- Count parameter outside 1–20 range may be rejected or clamped
- Very ambiguous single-word inputs (e.g. 'Springfield') return many low-confidence candidates requiring disambiguation
- Payment failure (x402) if USDC balance is insufficient
- Service unavailability on Hugging Face Spaces (cold start latency or downtime)

## How this service works

Turn a place name into coordinates, country, admin region, timezone, elevation and population — the lookup every other location-aware call needs first

## Output

Returns up to 20 ranked candidate locations matching the input name, each with: canonical name, latitude, longitude, country, admin region(s), IANA timezone string, elevation in meters, and population figure.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Place name to resolve"
  },
  "count": {
   "type": "integer",
   "description": "1-20 candidates (default 5)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "Osaka",
  "results": [
   {
    "name": "Osaka",
    "country": "Japan",
    "latitude": 34.69,
    "timezone": "Asia/Tokyo",
    "longitude": 135.5,
    "population": 2691185,
    "country_code": "JP"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-geocode-place-name-to-location-data-85b15ec6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)