Tool detail

2s

Converts a free-text address or place name into latitude/longitude plus structured address components (house number through country), using OpenStreetMap data.

Categories: Maps places

Use when

convert a street address into latitude/longitude
look up structured address components for a place name

Not for

not reverse geocoding (coordinates to address) — use the sister /reverse endpoint

Inputs

GET query params: q (string 2-500 chars, required); limit (integer 1-10, default 5, optional); country (string, optional ISO 3166-1 alpha-2 bias)

Admitted input schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5
    },
    "q": {
      "type": "string",
      "minLength": 2,
      "maxLength": 500
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://2s.io/api/geocode/address

Payment

Protocol: x402
Listed price: 0.0025 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://2s.io/api/geocode/address
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z