{"uid":"cap_Zp4Ms2YcQTA7tR3QDJ_ZN","slug":"x402-forgemesh-io-city-to-coordinates-geocoding-814d826e","name":"x402.forgemesh.io City-to-Coordinates Geocoding","description":"Geocoding API: city or place name to latitude/longitude with country, region, population, and timezone — top matches ranked. The bridge between human place names and every coordinates-based API.","url":"https://x402.forgemesh.io/city-to-coordinates","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","description":"place name, e.g. Houston"}}},"responseSchema":{"type":"json","example":{"data":{"results":[{"name":"Houston","latitude":29.76328,"timezone":"America/Chicago","longitude":-95.36327,"population":2296224,"country_code":"US"}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2fJ-gLO8WNvwhu5G8HwQj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a city or place name to latitude/longitude coordinates, returning country, region, population, and timezone for top-ranked matches.","exampleAgentPrompt":"What are the latitude, longitude, timezone, and country for Bangkok? I need to pass coordinates to a weather or earthquake API.","exampleUseCases":null,"resultDescription":"Returns a ranked list of top matching places for the input name, each with latitude, longitude, country, region/state, population, and timezone — so the agent can pick the best match and feed coordinates into any downstream coordinates-based API.","failureModes":["Unknown or misspelled place name returns empty results or no matches","Ambiguous city name (e.g. 'Springfield') returns multiple candidates requiring disambiguation","Network or payment failure returns HTTP error or 402 payment required","Invalid input format (non-string city field) returns validation error"],"whenToPreferThis":"Use this endpoint when you have a human-readable place name and need machine-readable coordinates (lat/lng) plus enrichment data (timezone, country, region, population) to feed into any coordinates-based API such as weather, earthquake, precipitation, or wave data. Prefer it over static databases when you need ranked top matches and don't have a pre-built geocoding integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:08:47.956Z","isFirstParty":false}