{"uid":"cap_K9y9bHpGXScJ_FsUF2Mjz","slug":"geocode-forward-reverse-via-openstreetmap-nominatim-4cf8bfc7","name":"Geocode (Forward & Reverse) via OpenStreetMap Nominatim","description":"Forward geocode an address (q=) or reverse geocode lat=+lon= using OpenStreetMap Nominatim. Returns up to 5 hits with display name and address parts. Community map data — not a postal authority.","url":"https://402.com.tr/api/x402/geocode","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Address text (forward)"},"lat":{"type":"string","description":"Latitude (reverse)"},"lon":{"type":"string","description":"Longitude (reverse)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iV4DJu0e6Jisn4Lrd8EQD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Forward geocodes an address string or reverse geocodes lat/lon coordinates using OpenStreetMap Nominatim, returning up to 5 results with display names and address components.","exampleAgentPrompt":"Can you geocode '1600 Pennsylvania Avenue NW, Washington, DC' and give me the latitude, longitude, and full address components?","exampleUseCases":[{"title":"Address to coordinates for mapping","prompt":"I have the address '221B Baker Street, London, UK' — can you look up its latitude and longitude so I can pin it on a map?"},{"title":"Reverse geocode GPS coordinates","prompt":"I've got coordinates lat=48.8584 and lon=2.2945 — what address or landmark is at that location?"},{"title":"Validate and structure a user-submitted address","prompt":"A user submitted '10 Downing Street, Westminster, London' as their address — can you geocode it and give me back the structured address parts like city, postcode, and country?"}],"resultDescription":"Returns up to 5 geocoding hits from OpenStreetMap Nominatim, each containing a display name (human-readable full address), structured address parts (street, city, county, country, postcode, etc.), and geographic coordinates. Results are community-sourced map data, not from a postal authority.","failureModes":["No results found for ambiguous or misspelled address — returns empty array","Missing required parameter (neither q nor lat+lon provided) — likely returns error","Coordinates outside valid range (lat > 90, lon > 180) — may return empty or error","Very new or obscure addresses not yet in OpenStreetMap — no results","Rate limiting or payment failure for $0.01 USDC per call"],"whenToPreferThis":"Choose this endpoint when you need lightweight forward or reverse geocoding backed by OpenStreetMap/Nominatim community data, especially for non-commercial or global address lookups. Ideal for agents that need to resolve place names to coordinates or coordinates to human-readable addresses without needing postal-authority accuracy. Good for automation pipelines that require affordable geocoding ($0.01/call) with structured address components. Prefer commercial geocoders (Google, HERE) when authoritative postal data or high result accuracy is critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:59:50.398Z","isFirstParty":false}