{"uid":"cap_t67AvWfvQvSujlDfi0VOX","slug":"tbs-geocoding-api-reverse-geocoding-75033580","name":"TBS Geocoding API – Reverse Geocoding","description":"Geocoding for AI agents in one sub-cent call: forward geocoding (place name or address to coordinates), reverse geocoding (lat/lon to address) and place search. Open-Meteo + BigDataCloud, keyless, unified schema, USDC-payable via x402 on Base.","url":"https://geo-x402.tbs-digital.com/geo/reverse?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":{"lat":{"type":"string","description":"Latitude in [-90, 90], e.g. 48.8566"},"lon":{"type":"string","description":"Longitude in [-180, 180], e.g. 2.3522"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"source":{"type":"string"},"address":{"type":"object","nullable":true},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"source":"bigdatacloud","address":{"lat":48.8566,"lon":2.3522,"city":"Paris","country":"France","locality":"Paris","subdivision":"Île-de-France","country_code":"FR"},"request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-11T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QcmHj4ZDLx5Sy9TTsvRMI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a latitude/longitude coordinate pair into a structured address (city, country, subdivision, locality) using BigDataCloud, payable in USDC via x402.","exampleAgentPrompt":"What city and address information corresponds to the coordinates 48.8566° N, 2.3522° E?","exampleUseCases":[{"title":"Identify city from GPS ping","prompt":"I have a GPS coordinate from a delivery driver — latitude 51.5074, longitude -0.1278 — can you tell me what city and neighborhood that maps to?"},{"title":"Enrich user location data","prompt":"A user just shared their current coordinates: lat 40.7128, lon -74.0060. Can you look up the full address and region details so I can personalize their experience?"},{"title":"Label a photo's location","prompt":"I have a photo with geotag latitude 35.6762 and longitude 139.6503 — what city and country was it taken in?"}],"resultDescription":"Returns a structured JSON object containing the resolved address fields (lat, lon, city, locality, subdivision, country, country_code), the data source ('bigdatacloud'), a unique request_id, a generated_at timestamp, and payer information (wallet address and network).","failureModes":["Missing or out-of-range lat/lon parameters returns an error","Coordinates in remote oceans or uninhabited areas may return null or incomplete address fields","Payment failure or insufficient USDC balance prevents the call from completing","Network timeout or upstream BigDataCloud outage may cause 5xx responses"],"whenToPreferThis":"Choose this endpoint when you need a sub-cent, keyless reverse geocoding call with a unified JSON schema and USDC micropayment settlement on Base. It is ideal for AI agents that need on-demand coordinate-to-address resolution without managing API keys or monthly subscription billing. Prefer this over forward geocoding siblings when you already have coordinates and need human-readable location details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:59.687Z","isFirstParty":false,"canonicalSlug":"tbs-geocoding-api-reverse-geocoding-75033580"}