Address Geocoding

Turn an address into latitude and longitude, with its components and bounding box, from OpenStreetMap.

Pay by wallet (x402) address-geocode

Example

Input

{
  "address": "Eiffel Tower, Paris"
}

Answer

{
  "found": true,
  "latitude": 48.8582599,
  "longitude": 2.2945006,
  "place_type": "tower",
  "bounding_box": {
    "east": 2.2956897,
    "west": 2.2933119,
    "north": 48.8590453,
    "south": 48.8574753
  },
  "display_name": "Tour Eiffel, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, Île-de-France, France métropolitaine, 75007, France",
  "input_address": "Eiffel Tower, Paris",
  "importance_score": 0.6205937724353116
}

Inputs

Field	Type	Required	What it is
`address`	string	Yes	Address or place name to geocode

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`latitude`	number	Always (present in every successful answer)
`longitude`	number	Always (present in every successful answer)
`place_type`	string	Usually (present for most inputs)
`bounding_box`	object	Usually (present for most inputs)
`display_name`	string	Always (present in every successful answer)
`importance_score`	number	Usually (present for most inputs)
`input_address`	—	Always (present in every successful answer)
`found`	—	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "address-geocode",
    "inputs": {
      "address": "Eiffel Tower, Paris"
    },
    "max_price_cents": 2
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "address-geocode",
    "inputs": {
      "address": "Eiffel Tower, Paris"
    },
    "max_price_cents": 2
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "address-geocode",
  inputs: {
    "address": "Eiffel Tower, Paris"
  },
  max_price_cents: 2,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="address-geocode",
    inputs={
        "address": "Eiffel Tower, Paris",
    },
    max_price_cents=2,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/address-geocode?address=Eiffel+Tower%2C+Paris'

Limitations

Rate limited to 1 request per second
Shares Nominatim rate limit with address-validate — max 1 req/sec total
Geocoding is approximate for vague queries
Vague queries (e.g., just a city name) return approximate centre coordinates