{"uid":"cap_Q8hQW7O6UKXuBxNq21Y6Z","slug":"address-place-geocoding-api-c841f4ec","name":"Address & Place Geocoding API","description":"ManyFish location resolver for forward geocoding. Convert an address, landmark, city, postal code, or place name into coordinates, normalized address components, IANA time zone, and current UTC offset.","url":"https://manyfish-seller.redcliff-d7368db1.westus2.azurecontainerapps.io/api/v1/maps/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":5,"minimum":1},"query":{"type":"string","pattern":".*\\S.*","minLength":1},"language":{"type":"string","pattern":"^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$","maxLength":35,"minLength":2},"biasLatitude":{"type":"number","maximum":90,"minimum":-90},"biasLongitude":{"type":"number","maximum":180,"minimum":-180}}},"responseSchema":{"type":"json","example":{"count":1,"query":"Space Needle, Seattle","results":[{"type":"PointOfInterest","country":"United States","latitude":47.6205,"locality":"Seattle","timeZone":"America/Los_Angeles","longitude":-122.3493,"utcOffset":"-07:00","confidence":"High","matchCodes":["Good"],"postalCode":"98109","streetName":null,"addressLine":"Space Needle","countryCode":"US","streetNumber":null,"adminDistrict":"Washington","adminDistrict2":"King County","formattedAddress":"Space Needle, Seattle, WA 98109, United States","adminDistrictCode":"WA"}],"utcOffsetAt":"2026-08-31T20:15:00.000Z"}},"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_pfY9L7K83LM_-uZnZjzIW","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 free-text address, landmark, city, postal code, or place name into normalized coordinates, a structured address, IANA time zone, and current UTC offset.","exampleAgentPrompt":"Can you geocode '1600 Pennsylvania Avenue NW, Washington DC' and give me its coordinates, normalized address, and time zone — return up to 2 results in English?","exampleUseCases":[{"title":"Enrich delivery address with coordinates","prompt":"I have a delivery address — '221B Baker Street, London, NW1 6XE' — can you convert it to lat/lng coordinates and also tell me what time zone it's in?"},{"title":"Find coordinates for a landmark","prompt":"What are the GPS coordinates and IANA time zone for the Eiffel Tower in Paris? I need the normalized address too."},{"title":"Resolve postal code to location","prompt":"Can you geocode the postal code '10001' in New York and give me back the coordinates, normalized place name, and current UTC offset?"}],"resultDescription":"Returns up to the requested number of geocoded results, each containing normalized latitude and longitude coordinates, a structured/normalized address string, the IANA time zone identifier (e.g. 'America/New_York'), and the current UTC offset for that location.","failureModes":["Query string matches no known location — empty results array returned","Ambiguous query with no bias results in low-confidence or irrelevant matches","Invalid language code causes validation error","Bias coordinates outside valid range (-90/90 lat, -180/180 lon) rejected","Blank or whitespace-only query rejected by pattern validation","Rate limiting or payment failure returns 402 or error response"],"whenToPreferThis":"Choose this endpoint when you need to convert a human-readable place name, address, or postal code into machine-usable coordinates along with a verified time zone and UTC offset in a single call. It is especially useful when your workflow requires both geolocation and time zone data together without making two separate API calls. Prefer it over reverse geocoding when you have text input rather than coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:00.272Z","isFirstParty":false}