Name: reverse-geocode
Price: 0.02 USDC
Availability: InStock

$ man reverse-geocode

agentutility / locale / reverse-geocode

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

utilities

STATUS

● live

NAME

reverse-geocode — converts latitude/longitude coordinates into a structured street address

SYNOPSIS

POST https://x402.agentutility.ai/reverse-geocode
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Converts latitude/longitude coordinates into a structured street address. Returns house_number, road, neighborhood, suburb, city, county, state, postcode, country, and country_code, plus a human-readable display_name, place type, OSM id, and bounding box; a configurable zoom level controls address granularity (street vs. neighborhood vs. city). OSM Nominatim — global coverage, ODbL attribution required. Use it as a reverse geocoder, lat-lng to address, coords to street, GPS to postal code, what-city-is-this lookup, Nominatim reverse, or OpenStreetMap reverse-geocoding API.

INPUT — request schema

property	type	description	req?
latitude	number	Latitude in decimal degrees. Range -90 to 90.	required
longitude	number	Longitude in decimal degrees. Range -180 to 180.	required
zoom	number	Address detail level. 3 (country) → 5 (state) → 10 (city) → 13 (village) → 17 (street, default) → 18 (building).	optional

OUTPUT — response shape

field	type	description
latitude	number	Echoed latitude of the queried point in decimal degrees.
longitude	number	Echoed longitude of the queried point in decimal degrees.
zoom	number	Nominatim zoom level controlling address granularity (3=country, 18=building).
display_name	string	Full human-readable address string joined from the address components.
address	object	Structured address parts: road, house_number, city, state, postcode, country, country_code.
name	string	Local name of the matched place, when Nominatim has one distinct from the full address.
type	string	OSM feature type of the match (e.g. residential, city, house, restaurant).
class	string	OSM feature class of the match (e.g. highway, place, building, amenity).
importance	number	Nominatim importance score from 0 to 1 ranking the match's prominence.
bounding_box	array	[south, north, west, east] lat/lng bounds of the matched feature.
osm_id	number	OpenStreetMap object ID of the matched feature.
place_id	number	Nominatim internal place identifier for the matched feature.
source	string	Upstream data source for the lookup, here "nominatim" (OpenStreetMap).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/reverse-geocode \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the reverse-geocode tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: geocodereverselocationmapsosm
methods: POST
cluster: locale
price: $0.02 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
address-geocode	Converts a free-form address, postal code, place name, or POI into latitude/longitude.	$0.02
airport-delays	Reports live US airport delays, ground stops, and closures from the FAA National Airspace System Status feed.	$0.02
bin-lookup	Looks up a credit card BIN: the first 6-8 digits resolve to issuer, country, brand, and card type via binlist.net.	$0.02
bin-lookup-api	Looks up card BINs, resolving the first 6-8 card digits to scheme, issuer, country, card type, prepaid/debit/credit signal, and payment-r…	$0.02
card-bin-lookup	Resolves the first 6-8 digits of a card number to issuer bank, country, brand (Visa/Mastercard/Amex/Discover/JCB/UnionPay), and card type…	$0.02
geocode	Geocodes addresses and place names to coordinates; exact short alias for address-geocode so agents searching for 'geocode' can discover t…	$0.02
iin-lookup	Resolves an issuer identification number (the first 6-8 card digits) to scheme, issuer, country, card type, and prepaid/debit/credit sign…	$0.02
satellite-bbox	Builds a cloud-free Sentinel-2 mosaic over any bounding box and returns it as a single PNG composite.	$0.02