{"uid":"cap_AXk1IaPSKEGA-TrNgoRMO","slug":"reverse-geocoding-api-x402-donnyautomation-com-5ef4f0f9","name":"Reverse Geocoding API (x402.donnyautomation.com)","description":"Reverse geocoding: latitude/longitude to a street address, worldwide, via OpenStreetMap Nominatim. Returns displayName plus structured address (road, city, state, postcode, country), place type and attribution. Requires BOTH ?lat= and ?lon=. Errors: 400 bad_coords (either missing or non-numeric) or coords_out_of_range (lat -90..90, lon -180..180), 404 no_match for ocean or unmapped points, 502 geocoder_unavailable. The OPPOSITE direction (name to coordinates) is /geocode.","url":"https://x402.donnyautomation.com/reverse-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"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"string","description":"Latitude, -90..90 (e.g. 48.8584)."},"lon":{"type":"string","description":"Longitude, -180..180 (e.g. 2.2945)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ts":"2026-08-01T00:00:00.000Z","lat":48.8584,"lon":2.2945,"address":{"city":"Paris","road":"Avenue Gustave Eiffel","country":"France","postcode":"75007"},"attribution":"Data © OpenStreetMap contributors, ODbL. Geocoding via Nominatim.","displayName":"Tour Eiffel, Avenue Gustave Eiffel, Paris, France"}},"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_WRT8H_oYMlK0rz739BCks","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":"Converts latitude and longitude coordinates to a human-readable street address and place name using OpenStreetMap Nominatim with worldwide coverage.","exampleAgentPrompt":"What's the street address at latitude 48.8584, longitude 2.2945? I need the full structured address including road, city, and country.","exampleUseCases":[{"title":"Delivery tracking address display","prompt":"I have a delivery driver's GPS position at latitude 37.7749, longitude -122.4194 — can you tell me the street address there so I can show it on the tracking dashboard?"},{"title":"Geofence entry alert labeling","prompt":"My IoT device just entered a geofence at coordinates 51.5074 north, -0.1278 west — what's the human-readable address or place name at that location so I can label the alert?"},{"title":"Photo location tagging","prompt":"This photo has EXIF coordinates of latitude 35.6762 and longitude 139.6503 — what street address or neighborhood does that correspond to so I can tag it properly?"}],"resultDescription":"Returns the display name (full human-readable address string), structured address fields (road, city, state, postcode, country), plus place type and category. Returns 404 for ocean coordinates or unmapped areas — never fabricates an address.","failureModes":["Coordinates in ocean or unmapped area return 404 with no fabricated fallback","Invalid latitude (outside -90..90) or longitude (outside -180..180) returns an error","Missing lat or lon query parameter results in a validation error","Very remote or sparse areas may return only partial address fields (e.g. country only)"],"whenToPreferThis":"Choose this endpoint when you need a reliable, worldwide reverse geocode with no risk of hallucinated addresses — it explicitly returns 404 rather than fabricating a result. Ideal for AI agents in logistics, delivery tracking, geofencing, and mapping that need trustworthy structured address data. At $0.01 USDC per call it is cost-effective for moderate-volume use cases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:17.743Z","isFirstParty":false}