# TELAGO Korea Building Geocode Address API

> TELAGO Korea Building Geocode Address API is a paid API for AI agents from telago-x402-discovery.vercel.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Geocodes a Korean address and returns building metadata including coordinates, floor counts, elevator availability, and normalized address.

## Facts

- Endpoint: POST https://telago-x402-discovery.vercel.app/korea-building/geocode-address?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telago-korea-building-geocode-address-api-ca8d11d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jyQLBZyBx3Vx4wInLrgHt

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 telago-korea-building-geocode-address-api-ca8d11d6 -d '<json body>'
```

Example prompt: Can you geocode the Korean address '서울특별시 관악구 미성3길 50' and tell me the GPS coordinates, building name, and whether it has an elevator?

## When to prefer this

Use this endpoint when you need to geocode Korean addresses with rich building-level metadata (elevator, floor count, building name) beyond simple lat/lng — especially for last-mile delivery, field service dispatch, or robotics navigation inside Korean buildings. Prefer this over generic geocoders (Google Maps, Kakao Maps) when you need structured building access intelligence specific to Korea's address system in a pay-per-call, agent-native x402 context.

## Known failure modes

- Address not found in Korea building database — returns ok: false or empty result
- Address string too short (under 3 chars) or too long (over 300 chars) — validation error
- Non-Korean address submitted — may return no result or incorrect data
- Payment failure via x402 protocol — 402 response before data is returned
- Ambiguous address matching multiple buildings — may return best-guess or error

## How this service works

Pay-per-call Korea execution intelligence for AI agents: address geocoding, building access, last-meter delivery, field service, robotics and cross-border logistics.

## Output

Returns a JSON object with the original query, normalized Korean address, latitude, longitude, building name, elevator presence (boolean), floors above ground, and floors below ground. Example: {ok: true, query: '서울특별시 관악구 미성3길 50', elevator: true, latitude: 37.47, longitude: 126.91, floorsAbove: 6, floorsBelow: 0, buildingName: '다쳐', normalizedAddress: '서울특별시 관악구 미성3길 50'}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 300,
   "minLength": 3
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "query": "서울특별시 관악구 미성3길 50",
  "elevator": true,
  "latitude": 37.4725288710309,
  "longitude": 126.917605285307,
  "floorsAbove": 6,
  "floorsBelow": 0,
  "buildingName": "다숲",
  "normalizedAddress": "서울특별시 관악구 미성3길 50"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telago-korea-building-geocode-address-api-ca8d11d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from telago-x402-discovery.vercel.app](https://www.zero.xyz/host/telago-x402-discovery.vercel.app/llms.txt)