Catalog
MapsPOSTlive

Geocode

Convert a place name into latitude/longitude coordinates.

$0.005
per call
Success
100%
p50 latency
1.84s
p95 latency
1.84s
Calls (30d)
1

Provider contract

Call path
/routes/locus-openweather/maps/geocode
Method
POST
Selected provider
locus-openweatherdefault
Provider price
$0.005
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/locus-openweather/maps/geocode' \
  -H 'content-type: application/json' \
  -d '{"q":"Seoul,KR","limit":5}'
CLI
h402 call 'maps/geocode' --provider 'locus-openweather' --method POST --json '{"q":"Seoul,KR","limit":5}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

qstringrequired

Place name to resolve, optionally with state and ISO country code (e.g. 'London,GB' or 'Springfield,IL,US'). Resolves at the city/place level.

e.g.
limitintegeroptional1–5default 5

Maximum matching locations to return.

POST/routes/locus-openweather/maps/geocode
Request body
{
  "q": "Seoul,KR",
  "limit": 5
}

ResponseExample response
{
  "data": {
    "success": true,
    "data": [
      {
        "name": "Seoul",
        "local_names": {
          "sl": "Seul",
          "mr": "सोल",
          "sv": "Seoul",
          "os": "Сеул",
          "tk": "Seul",
          "bg": "Сеул",
          "ko": "서울",
          "af": "Seoel",
          "ro": "Seul",
          "fi": "Soul",
          "az": "Seul",
          "uz": "Seul",
          "oc": "Seol",
          "fa": "سئول",
          "pt": "Seul",
          "lv": "Seula",
          "et": "Soul",
          "ca": "Seül",
          "fr": "Séoul",
          "es": "Seúl",
          "bn": "সিওল",
          "ka": "სეული",
          "he": "סיאול",
          "eu": "Seul",
          "vo": "Söul"
        },
        "lat": 37.5666791,
        "lon": 126.9782914,
        "country": "KR"
      }
    ]
  },
  "h402": {
    "routeId": "maps/geocode",
    "provider": "locus-openweather",
    "selectedCandidateId": "maps/geocode/locus-openweather",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

locus-openweather
mpp
100
Success
100%
p50
1.84s
Calls
1
100%
$0.005$0.0050/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider