{"uid":"cap_zvnVZr-lclqXSUYHxJvf8","slug":"dopaminedesk-geocoding-api-b02ad537","name":"DopamineDesk Geocoding API","description":"Resolve a location or address query to current place candidates and coordinates through Open-Meteo.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/geocoding","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","properties":{"lat":{"type":"number","description":"Latitude for reverse geocoding."},"lng":{"type":"number","description":"Longitude for reverse geocoding."},"address":{"type":"string","description":"Address to convert to coordinates."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","source","fetched_at","query","count","results","marketplace_metadata"],"properties":{"count":{"type":"integer"},"query":{"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"string"}},"success":{"type":"boolean"},"fetched_at":{"type":"string"},"marketplace_metadata":{"type":"object","required":["data_mode","billable","availability","source"],"properties":{"source":{"type":"string"},"billable":{"type":"boolean"},"data_mode":{"type":"string"},"availability":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"count":5,"query":"Mountain View, CA","source":"Open-Meteo Geocoding API","results":["[nested detail omitted from the challenge header; see the full example in /openapi.json]"],"success":true,"fetched_at":"2026-08-07T07:32:44.786Z","marketplace_metadata":{"source":"Open-Meteo Geocoding API","billable":true,"data_mode":"live_source","availability":"operational"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bC8rSWtu_iDhF9pXy2cv0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a street address to coordinates (forward geocoding) or converts lat/lng coordinates to a human-readable address (reverse geocoding).","exampleAgentPrompt":"Can you convert the address '1600 Amphitheatre Pkwy, Mountain View, CA' to GPS coordinates so I can use it on a map?","exampleUseCases":[{"title":"Address to coordinates for delivery routing","prompt":"I need to get the latitude and longitude for '350 5th Ave, New York, NY 10118' so I can plug it into our delivery routing system."},{"title":"Reverse geocode GPS ping to street address","prompt":"I have GPS coordinates 37.7749 latitude and -122.4194 longitude from a device — can you tell me what street address that corresponds to?"},{"title":"Standardize user-submitted location data","prompt":"A user submitted '1 Infinite Loop, Cupertino, California' as their location — can you geocode that and give me back the canonical formatted address and place ID?"}],"resultDescription":"Returns a JSON object with a status field ('OK' on success) and a results array. Each result includes a formatted_address string, a coordinates object with lat and lng, a location_type (e.g. 'ROOFTOP', 'APPROXIMATE'), and a place_id string uniquely identifying the location.","failureModes":["Missing required query parameters (neither address nor lat/lng provided) — likely returns an error status","Invalid or unrecognizable address string — results array may be empty with a non-OK status","Coordinates outside valid range — may return empty results or an error","Payment failure via x402 — HTTP 402 returned before geocoding is attempted","Rate limiting or quota exhaustion — request may fail with a 429 or service error"],"whenToPreferThis":"Choose this endpoint when you need pay-per-use geocoding without a long-term API subscription, especially in agentic workflows using x402 USDC micropayments on Base. It is well-suited for sporadic geocoding needs where you want per-call billing at $0.01 USDC rather than managing a Google Maps API key or monthly quota. Prefer it when building autonomous agents that need to resolve addresses or reverse-geocode coordinates on demand within a crypto-native payment stack.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:32:12.471Z","isFirstParty":false}