{"uid":"cap_9i87bh72IHyVktzxrKFIa","slug":"payload402-geo-lookup-place-coordinates-to-timezone-fe2cb36b","name":"payload402 Geo Lookup (Place/Coordinates to Timezone)","description":"Resolve a place name or lat/lon to IANA timezone and coordinates (Open-Meteo). Use for agent scheduling, travel logistics, and local-time questions without LLM guessing. Not IP geolocation.","url":"https://payload402.edgebytenet.workers.dev/geo/lookup","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":"number","description":"Latitude; requires lon"},"lon":{"type":"number","description":"Longitude; requires lat"},"place":{"type":"string","description":"Place name (e.g. London)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"London","note":"Place geocoding and timezone from Open-Meteo; use lat/lon for coordinates without a place name","source":"open-meteo","country":"United Kingdom","latitude":51.50853,"timezone":"Europe/London","longitude":-0.12574,"country_code":"GB"}},"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_-UnFtH9K1Hhwt4S3hswF-","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":"Resolves a place name or lat/lon coordinates to IANA timezone identifier, canonical coordinates, and country metadata using Open-Meteo geocoding.","exampleAgentPrompt":"What's the IANA timezone and coordinates for Istanbul? I need to schedule a meeting in local time there.","exampleUseCases":[{"title":"Cross-timezone meeting scheduler","prompt":"I need to schedule a call with someone in Melbourne — can you look up the IANA timezone for Melbourne so I know what UTC offset to use?"},{"title":"Travel itinerary local time planning","prompt":"I'm building a trip itinerary and need the timezone and exact coordinates for Reykjavik so I can show local times correctly."},{"title":"GPS coordinates to timezone conversion","prompt":"I have coordinates lat 35.6762, lon 139.6503 — what IANA timezone do those map to?"}],"resultDescription":"A JSON object with the canonical place name, country, country code, latitude, longitude, IANA timezone string (e.g. 'Europe/London'), and a source field indicating Open-Meteo as the geocoding provider.","failureModes":["Ambiguous or misspelled place name returns incorrect or no match","Providing lat without lon (or vice versa) triggers a validation error","Very small or obscure localities may not be recognized by Open-Meteo geocoding","Payment failure (402) if USDC balance is insufficient","Rate limiting or upstream Open-Meteo unavailability causing 5xx errors"],"whenToPreferThis":"Use this endpoint when an agent needs a deterministic, authoritative IANA timezone string for a named city or lat/lon pair — especially for scheduling, calendar, or travel logistics tasks where guessing the timezone from an LLM would be unreliable. Prefer this over IP-geolocation endpoints (which infer location from network address) and over asking an LLM to recall timezone data, which can be stale or wrong. Best suited for single-location synchronous lookups rather than batch geocoding jobs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:39:42.316Z","isFirstParty":false}