{"uid":"cap_2sLHjiaQvYB8GKGQ-4CT5","slug":"forward-geocoding-api-openstreetmap-nominatim-18f62956","name":"Forward Geocoding API (OpenStreetMap Nominatim)","description":"Forward geocoding: street address or place name to latitude/longitude, worldwide, via OpenStreetMap Nominatim. Returns best {lat, lon, displayName, type, importance}, count and attribution. Requires ?q=<address or place name>, max 300 chars. Errors: 400 missing_query|query_too_long, 404 no_match - a coordinate is never guessed, 502 geocoder_unavailable|geocoder_failed. The OPPOSITE direction (coordinates to an address) is /reverse-geocode. /weather needs lat+lon, so call this first.","url":"https://x402.donnyautomation.com/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":["q"],"properties":{"q":{"type":"string","description":"Street address or place name, e.g. \"1600 Amphitheatre Parkway, Mountain View\" or \"Eiffel Tower, Paris\". Max 300 chars."}}}},"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","best":{"lat":48.8583,"lon":2.2945,"type":"attraction","importance":0.71,"displayName":"Tour Eiffel, Avenue Gustave Eiffel, Paris, France"},"count":1,"query":"Eiffel Tower, Paris","attribution":"Data © OpenStreetMap contributors, ODbL. Geocoding via Nominatim."}},"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_7EVT1sJMvnJbTtbfrKEoJ","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 a street address, city, or place name into latitude/longitude coordinates with structured address parts, bounding box, and confidence score via OpenStreetMap Nominatim.","exampleAgentPrompt":"What are the latitude and longitude coordinates for 1600 Amphitheatre Parkway, Mountain View, California?","exampleUseCases":[{"title":"Delivery address to GPS coordinates","prompt":"I need to geocode this delivery address to lat/lon so I can route our driver — the address is 350 Fifth Avenue, New York, NY 10118."},{"title":"Travel planning location lookup","prompt":"Can you get me the coordinates for the Eiffel Tower in Paris so I can drop a pin on my itinerary map?"},{"title":"Logistics hub geocoding","prompt":"I need to convert our warehouse address — 1 Amazon Way, Bellevue, WA — into latitude and longitude for our shipment tracking system."}],"resultDescription":"Returns a ranked list of matches, each containing latitude, longitude, a human-readable display name, structured address components (road, city, country, postcode, etc.), a bounding box, and an importance score indicating match confidence. Returns 404 if no match is found — never a silently wrong guessed coordinate.","failureModes":["404 returned when no matching location is found for the query","Ambiguous place names may return multiple ranked results requiring the caller to select the best match","Very long or malformed query strings (over 300 chars) may be rejected","Rare or highly localized addresses with no OpenStreetMap coverage may not resolve"],"whenToPreferThis":"Choose this endpoint when you need worldwide forward geocoding without maintaining your own geocoding infrastructure, especially when confidence scoring and structured address decomposition are important. Prefer this over reverse geocoding services when you have a human-readable address or place name as input. The OpenStreetMap Nominatim backend provides broad global coverage suitable for mapping, logistics, travel, and location-aware agents. The 404-on-no-match behavior makes it safe for automated pipelines that need to detect lookup failures explicitly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:34.721Z","isFirstParty":false}