{"uid":"cap_MMANeYhjl2O1_icLHU-CN","slug":"agent-time-place-geocode-3f900913","name":"Agent Time & Place – Geocode","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/geocode","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":["q"],"properties":{"q":{"type":"string","description":"City name, native or English spelling (e.g. 'München' or 'Munich')"},"limit":{"type":"integer","default":5,"maximum":25,"minimum":1},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 filter, e.g. 'DE'"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"query":{"type":"string"},"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"},"population":{"type":"integer"},"countryName":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"query":"Munich","results":[{"lat":48.1374,"lon":11.5755,"name":"München","ascii":"Munich","admin1":"Bavaria","capital":false,"country":"DE","timezone":"Europe/Berlin","population":1260391,"countryName":"Germany"}]}},"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_doPqUbtOO_jmw0VgmZHc9","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 city name (in any spelling or language) into structured geographic data including coordinates, timezone, region, and population.","exampleAgentPrompt":"What are the coordinates and timezone for Munich, Germany?","exampleUseCases":[{"title":"Timezone lookup before scheduling","prompt":"I need to schedule a meeting with someone in München — what timezone are they in and what are the coordinates of the city?"},{"title":"Travel app city resolution","prompt":"The user typed 'Köln' as their destination — can you resolve that to coordinates, country code, and IANA timezone so I can set up their itinerary?"},{"title":"Multi-city population comparison","prompt":"Look up the geographic details for São Paulo, Brazil — I need the population, lat/lon, and which admin region it's in."}],"resultDescription":"Returns a JSON object with a count of matches, the original query string, and an array of result objects each containing: latitude, longitude, native name, ASCII name, first-level administrative region (state/province), whether it is a capital, ISO 3166-1 alpha-2 country code, IANA timezone identifier, population, and full country name.","failureModes":["City name not found: returns empty results array with count 0","Ambiguous city name without country filter: returns multiple results requiring disambiguation","Invalid country filter (non-ISO code): may return no results or an error","Payment not attached or invalid x402 payment: request rejected with 402 status","Rate or quota issues on the underlying worker"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable city name (in any language or spelling) to structured geographic data including coordinates, IANA timezone, country, and administrative region. It is ideal for AI agents that need to chain geocoding into downstream operations (timezone lookups, distance calculations, holiday checks, sun times) within the same Agent Time & Place service suite. Prefer it over general-purpose geocoding APIs when sub-cent deterministic pricing and no API-key authentication (x402 payment-as-auth) are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:17.192Z","isFirstParty":false}