{"uid":"cap_RDXAqR8fW1RRJqb-hnyDA","slug":"openweather-reverse-geocoding-via-locus-x402-8800b1b4","name":"OpenWeather Reverse Geocoding via Locus x402","description":"Global weather data — current conditions, 5-day forecasts, hourly forecasts, air quality index with pollutants, geocoding, and One Call 3.0 with full weather suite and government alerts.","url":"https://openweather.x402.paywithlocus.com/openweather/reverse-geocode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"limit":{"type":"number"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"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_mWJYpwUb48gdI0V5SRP6m","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 geographic coordinates (latitude/longitude) into human-readable location names (city, region, country) using OpenWeather's reverse geocoding API.","exampleAgentPrompt":"What city and country are at coordinates 48.8566° N, 2.3522° E? Give me up to 3 matching location names.","exampleUseCases":[{"title":"Identify location from GPS coordinates","prompt":"I have a GPS fix at latitude 51.5074, longitude -0.1278 — what city and country is that? Show me the top 2 results."},{"title":"Enrich weather data with place names","prompt":"I've got coordinates 35.6895° N, 139.6917° E from a sensor — can you reverse geocode that to get the city name so I can label my weather report properly?"},{"title":"Validate user location claim","prompt":"A user says they're in Sydney, Australia, but their reported coordinates are -33.8688, 151.2093 — can you reverse geocode those and confirm what city comes back?"}],"resultDescription":"Returns an array of up to 5 location objects matching the given coordinates, each containing the city/town name, state/region, country code, and possibly local-language name variants. Response is wrapped in a Locus x402 payment envelope indicating settlement in USDC.","failureModes":["Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns a validation error","Coordinates in open ocean or uninhabited areas may return zero results or sparse data","Payment failure or insufficient USDC balance causes x402 payment rejection before the geocoding call is made","Limit value outside 1–5 may be rejected or clamped","Network timeout or OpenWeather upstream outage returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to convert raw GPS or map coordinates into human-readable place names, especially within a workflow already using OpenWeather data (weather lookup, air quality, forecasts). Prefer it over general-purpose geocoding APIs when you want a pay-per-call micropayment model with no subscription, and when you're already paying for OpenWeather data via the Locus x402 gateway. Not suitable for forward geocoding (address to coordinates).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:20.782Z","isFirstParty":false}