# skill-audit Geocoding

> skill-audit Geocoding is a paid API for AI agents from eltociear-skill-audit.hf.space, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Resolves a place name into coordinates, country, admin region, timezone, elevation, and population for use in downstream location-aware calls

## Facts

- Endpoint: POST https://eltociear-skill-audit.hf.space/world/geocode
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/skill-audit-geocoding-506c1912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EnWgAJkNLD5nMW4DBw3YS

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 skill-audit-geocoding-506c1912 -d '<json body>'
```

Example prompt: Look up the coordinates, timezone, country, admin region, elevation, and population for 'Nairobi' and give me up to 3 candidate matches.

## When to prefer this

Choose this endpoint when you need a one-call solution to resolve a human-readable place name into a full suite of geographic metadata (coordinates, timezone, country, admin region, elevation, population) before feeding downstream location-aware APIs. Prefer it over raw geocoding-only services when you also need timezone or population in the same response.

## Known failure modes

- Ambiguous place name returns unexpected top candidate — use count parameter to retrieve multiple candidates and disambiguate
- Place name not found returns empty candidates array
- Misspelled or unofficial place name may return no results or a wrong match
- Request with count outside 1-20 range may be rejected or clamped

## 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 one or more candidate location records, each containing coordinates (latitude/longitude), country, administrative region, timezone, elevation in metres, and population estimate, ranked by relevance to the input place name.

## 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/skill-audit-geocoding-506c1912/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-skill-audit.hf.space](https://www.zero.xyz/host/eltociear-skill-audit.hf.space/llms.txt)