{"uid":"cap_54NEjaAapUn1GhF9ZxxIy","slug":"zeroclick-x402-service-registry-geocode-1c35bb1d","name":"Geocode (Forward & Reverse) via Mapbox","description":"Forward and reverse geocoding via Mapbox. Forward: convert an address or place name to latitude/longitude coordinates. Reverse: convert lat/lng coordinates back to a human-readable address. Input: `action` (forward/reverse), `query` for forward (address string), `lat` + `lng` for reverse (decimal degrees). Optional `country` (ISO 2-letter code) to bias results, `limit` (1-10, default 5). Returns: `features` array of {name, full_address, lat, lng, type, relevance}, `count` of results. Relevance is 0.0-1.0 (higher = better match). Types: address, place, postcode, locality, neighborhood, region, country, poi.","url":"https://geocode.withzero.ai/run?utm_source=zero.xyz","method":"POST","headers":{"X-ZAM-Access-Key":"zeroclick"},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude for reverse geocoding"},"lng":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude for reverse geocoding"},"limit":{"type":"integer","default":5,"maximum":10,"minimum":1,"description":"Max results to return (1-10, default 5)"},"query":{"type":"string","maxLength":500,"minLength":1,"description":"Address or place name for forward geocoding"},"action":{"enum":["forward","reverse"],"type":"string","default":"forward","description":"forward: address→coordinates; reverse: coordinates→address"},"country":{"type":"string","maxLength":2,"minLength":2,"description":"ISO 2-letter country code to bias results (e.g. us, gb, de)"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["features","count"],"properties":{"count":{"type":"number","description":"Number of results returned"},"features":{"type":"array","items":{"type":"object","required":["name","full_address","lat","lng","type","relevance"],"properties":{"lat":{"type":"number","description":"Latitude"},"lng":{"type":"number","description":"Longitude"},"name":{"type":"string","description":"Short place name"},"type":{"type":"string","description":"Feature type (address, place, poi, etc.)"},"relevance":{"type":"number","description":"Match relevance score 0.0-1.0"},"full_address":{"type":"string","description":"Full formatted address"}},"additionalProperties":false},"description":"Geocoding results"}},"additionalProperties":false},"example":{"request":{"limit":5,"query":"Statue of Liberty, New York","action":"forward"},"response":{"count":5,"features":[{"lat":41.795768,"lng":-74.744928,"name":"State Street","type":"address","relevance":0.711481,"full_address":"State Street, Liberty, New York 12754, United States"},{"lat":40.698986,"lng":-74.060876,"name":"Theodore Conrad Drive","type":"address","relevance":0.663333,"full_address":"Theodore Conrad Drive, Jersey City, New Jersey 07305, United States"},{"lat":41.799525,"lng":-74.745775,"name":"Liberty","type":"place","relevance":0.637037,"full_address":"Liberty, New York, United States"},{"lat":41.55846,"lng":-77.105059,"name":"Liberty","type":"place","relevance":0.274074,"full_address":"Liberty, Pennsylvania, United States"},{"lat":41.339579,"lng":-71.785685,"name":"Liberty","type":"address","relevance":0.274074,"full_address":"Liberty, Westerly, Rhode Island 02891, United States"}]}},"exampleRequest":{"limit":5,"query":"Statue of Liberty, New York","action":"forward"},"tags":["location","geocode","address","coordinates","mapbox","maps"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.54","successRate":"1.00","reviews":2,"stars":"3.2","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fWKuy6xPzbfhzDTVSmxwL","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"geocode:1"}],"brandName":"ZeroClick x402 Service Registry","brandSlug":"zeroclick-x402-service-registry","brandBaseUrl":"https://withzero.ai","brandDocsUrl":null,"whatItDoes":"Converts addresses or place names to lat/lng coordinates (forward geocoding) and lat/lng coordinates back to human-readable addresses (reverse geocoding) using Mapbox.","exampleAgentPrompt":"Can you forward-geocode '1600 Pennsylvania Avenue NW, Washington DC' and give me the top 3 results with their coordinates and relevance scores?","exampleUseCases":[{"title":"Map user delivery addresses to coordinates","prompt":"I have a list of customer delivery addresses that I need to convert to lat/lng so I can plot them on a map. Can you geocode each one and give me the most relevant result with coordinates?"},{"title":"Identify city from GPS coordinates","prompt":"My device just recorded GPS coordinates 40.7128, -74.0060. Can you reverse-geocode that and tell me what city and address that corresponds to?"},{"title":"Validate and normalize address data","prompt":"I want to clean up our customer addresses by geocoding them and getting back the standardized full address format. Can you geocode '123 Main St, Springfield' and show me the top matches with their full formatted addresses?"}],"resultDescription":"An array of up to 10 geocoding features, each with a short place name, full formatted address, latitude, longitude, feature type (address, place, poi, postcode, neighborhood, locality, region, country), and a relevance score from 0.0 to 1.0. Also includes a count of total results returned.","failureModes":["No results found for an ambiguous or misspelled query — returns empty features array with count 0","Invalid lat/lng range (lat outside -90 to 90 or lng outside -180 to 180) — schema validation error","Missing required field: forward geocoding without query, or reverse geocoding without lat/lng","Country code not a valid ISO 2-letter code — may return unbiased results or error","Limit outside 1-10 range — schema validation rejection","Service unavailable from upstream Mapbox API — may return 5xx error"],"whenToPreferThis":"Use this endpoint when you need to convert between human-readable addresses and geographic coordinates, or vice versa, with relevance scoring and multiple result candidates. Backed by Mapbox's high-quality geocoding data, it supports country-biasing and returns typed features (POI, address, neighborhood, etc.), making it ideal for location enrichment, map pin placement, address validation, or any workflow that requires precise lat/lng from text input.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":8,"lastUsedAt":"2026-07-02T20:30:27.953Z","lastSuccessfullyRanAt":"2026-07-02T20:30:27.953Z","lastHealthCheckAt":"2026-10-10T00:38:22.909Z","isFirstParty":true,"canonicalSlug":"zeroclick-x402-service-registry-geocode-1c35bb1d"}