{"uid":"cap_y9_RmuddQppljoDq-jP84","slug":"forward-geocoding-api-ban-openstreetmap-d6eb9e3b","name":"Forward Geocoding API (BAN + OpenStreetMap)","description":"Turn an address into coordinates: BAN for France (INSEE code, score), OpenStreetMap elsewhere. Address to coordinates: for France the official BAN registry (house number, street, postcode, city, INSEE code, match score), elsewhere OpenStreetMap Nominatim. Query: ?q=8 rue de la Paix Paris&country=fr&limit=1","url":"https://api.x-402.online/v1/geo/forward?utm_source=zero.xyz","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","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fqT0LjtyD1c4m_lQRo-5H","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a free-text address into geographic coordinates, using France's official BAN registry for French addresses and OpenStreetMap Nominatim for all other countries.","exampleAgentPrompt":"Can you geocode '8 rue de la Paix, Paris' and give me the exact coordinates along with the INSEE code and match score?","exampleUseCases":[{"title":"Geocode French delivery address","prompt":"I have a delivery address — 14 avenue des Champs-Élysées, 75008 Paris — can you get me the exact lat/lon and the INSEE code using the official French BAN registry?"},{"title":"Map user-submitted form addresses","prompt":"A customer just submitted their address as '3 place du Capitole, Toulouse, France' — can you resolve that to coordinates so I can pin it on a map?"},{"title":"Geocode international address via OpenStreetMap","prompt":"I need the coordinates for '221B Baker Street, London, UK' — can you forward geocode that address for me?"}],"resultDescription":"Returns one or more geocoded results containing latitude and longitude coordinates. For French addresses (country=fr), includes BAN-specific fields: house number, street name, postcode, city, INSEE municipality code, and a confidence/match score. For other countries, returns OpenStreetMap Nominatim results with coordinates and place metadata.","failureModes":["Ambiguous address string returns low-confidence or incorrect match","Address not found in BAN or Nominatim returns empty results array","Invalid country code parameter may fall back to wrong data source","Rate limiting or payment failure returns HTTP 402 error","Malformed query string returns 400 bad request"],"whenToPreferThis":"Prefer this endpoint when you need official French address geocoding with INSEE codes and confidence scores (sourced from the authoritative BAN registry), or when you need a unified geocoding endpoint that handles both French and international addresses. It is well-suited for AI agents requiring pay-per-call geocoding without account setup, billed per query via USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T00:50:48.837Z","isFirstParty":false,"canonicalSlug":"forward-geocoding-api-ban-openstreetmap-d6eb9e3b"}