{"uid":"cap_DGQ84Y6dX3zVDJQYE1tn_","slug":"orbit-geo-time-forward-geocoding-2c08f303","name":"orbit Geo & Time: Forward Geocoding","description":"Location and time data for agents: weather now + 7-day forecast (MET Norway), geocoding and reverse geocoding (OpenStreetMap Nominatim), sunrise/sunset, world time-zone conversion and public holidays (Nager.Date). Real open data fetched at call time, attribution included. $0.001 per call. By orbit-builder.","url":"https://orbit-geo.orbit-builder.workers.dev/v1/geocode?utm_source=zero.xyz","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":"place name or address"},"limit":{"type":"integer","description":"1-5 (default 3)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"Eiffel Tower, Paris","results":[{"lat":48.8583,"lon":2.2945,"name":"Tour Eiffel, … Paris, France","type":"attraction","address":{"city":"Paris","country":"France","country_code":"fr"}}]}},"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_wbu9m8yKOyCkJ0Y3hWbmW","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":"Converts a place name or address string into up to 5 geocoded matches with lat/lon coordinates, bounding box, and structured address components via OpenStreetMap Nominatim","exampleAgentPrompt":"Can you find the latitude and longitude for the Eiffel Tower in Paris? I'd like the top 3 matches with their full address details.","exampleUseCases":[{"title":"Pinning a landmark on a map","prompt":"What are the coordinates for the Colosseum in Rome? Give me up to 3 results with their full display names so I can pick the right one."},{"title":"Geocoding a delivery address","prompt":"I need the lat/lon for 221B Baker Street, London — can you look that up and give me the structured address breakdown too?"},{"title":"Finding coordinates for a city center","prompt":"Can you geocode 'downtown Austin, Texas' and return the top result's coordinates and bounding box?"}],"resultDescription":"A JSON array of up to 5 geocode matches, each containing latitude, longitude, full display name, place type and class, importance score, bounding box, and a structured address object with fields like road, city, state, postcode, country, and country code. Returns 404 (not billed) if no match is found.","failureModes":["404 returned when no match found for the query string (not charged)","Ambiguous or misspelled place names may return unexpected or low-relevance results","Limit parameter outside 1-5 range may cause validation error","Missing required 'q' parameter returns an error or runs example input","Rural or very obscure locations may not be in OpenStreetMap data"],"whenToPreferThis":"Choose this endpoint when you need to convert a human-readable place name or address into geographic coordinates (lat/lon) with structured address data, especially when OpenStreetMap coverage is sufficient and cost per call ($0.001 USDC) is a factor. Prefer this over paid geocoding APIs (Google Maps, HERE) for open-data use cases, OSM-licensed projects, or high-volume lookups where cost matters. It returns up to 5 candidate matches, making it useful for disambiguation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:31:32.784Z","isFirstParty":false,"canonicalSlug":"orbit-geo-time-forward-geocoding-2c08f303"}