{"uid":"cap_6aW1lqmOqXoiLSXGwgKMF","slug":"agent-time-place-reverse-geocoding-5f2f1d62","name":"Agent Time & Place – Reverse Geocoding","description":"Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).","url":"https://time-place.agent-utils.workers.dev/v1/reverse","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":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees (WGS84)"},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees (WGS84)"},"limit":{"type":"integer","default":1,"maximum":10,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"name":{"type":"string"},"ascii":{"type":"string"},"admin1":{"type":"string","description":"First-level region (state/province)"},"capital":{"type":"boolean"},"country":{"type":"string","description":"ISO 3166-1 alpha-2"},"timezone":{"type":"string","description":"IANA timezone id"},"distanceKm":{"type":"number"},"population":{"type":"integer"},"countryName":{"type":"string"}}}},"timezone":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"lat":40.4168,"lon":-3.7038,"results":[{"lat":40.4165,"lon":-3.7026,"name":"Madrid","ascii":"Madrid","admin1":"Madrid","capital":true,"country":"ES","timezone":"Europe/Madrid","distanceKm":0.1,"population":3255944,"countryName":"Spain"}],"timezone":"Europe/Madrid"}},"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_l6Y3wtupovhhT5hTRBvga","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 latitude/longitude coordinates into place names, administrative regions, country codes, IANA timezones, and distances","exampleAgentPrompt":"What city and timezone am I in if my GPS coordinates are latitude 40.4168, longitude -3.7038?","exampleUseCases":[{"title":"Timezone resolution for scheduled tasks","prompt":"My device is reporting coordinates lat 35.6762, lon 139.6503 — what timezone is that in so I can schedule the meeting correctly?"},{"title":"Identifying country from GPS log","prompt":"I have a GPS trace that hit lat -33.8688, lon 151.2093 — what country and city is that, and is it a capital?"},{"title":"Enriching delivery location data","prompt":"We have a shipment that pinged at lat 48.8566, lon 2.3522 — can you tell me the city name, region, and country code so I can fill in the delivery record?"}],"resultDescription":"Returns the queried lat/lon, the IANA timezone for that coordinate, and an array of up to N nearest places each containing: place name, ASCII name, first-level administrative region (state/province), country ISO code, country name, whether it is a capital, the matched place's coordinates, distance in km, and population.","failureModes":["Missing required lat or lon parameter returns an error","lat outside [-90, 90] or lon outside [-180, 180] fails schema validation","No nearby named place found may return an empty results array","Payment not provided or insufficient USDC results in HTTP 402","Network/worker timeout on edge cold start"],"whenToPreferThis":"Choose this endpoint when you need a fast, deterministic, sub-cent reverse geocode that also returns the IANA timezone in a single call — avoiding separate geocoding + timezone lookup roundtrips. It requires no API key; payment via x402/USDC is the sole authentication mechanism, making it ideal for autonomous AI agents that manage micropayments. Prefer it over nominatim or similar when you also need timezone and capital-city metadata bundled together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:08.177Z","isFirstParty":false}