{"uid":"cap_j1VSU3PukrcDtPGg9I5y0","slug":"suverse-photon-geocoder-9f2f2c68","name":"Suverse Photon Geocoder","description":"Geocode a place name or address to coordinates via Photon, the OpenStreetMap-backed geocoder. Returns ranked GeoJSON with name, country, city, postcode and OSM ids. Keyless.","url":"https://proxy.suverse.io/v1/data/suverse-photon-geocode","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__Rg8mwGKW4UNiQk5rcO5n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geocodes a place name or address to geographic coordinates using Photon (OpenStreetMap-backed), returning ranked GeoJSON results with name, country, city, postcode, and OSM IDs.","exampleAgentPrompt":"Can you geocode '10 Downing Street, London' and give me the latitude, longitude, postcode, and OSM ID from the top result?","exampleUseCases":[{"title":"Store locator coordinate enrichment","prompt":"I have a list of store addresses and I need to convert them to latitude/longitude coordinates — can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' and give me the GeoJSON with its coordinates and postcode?"},{"title":"City-name to coordinates for travel app","prompt":"I'm building a travel feature — can you look up the coordinates for 'Kyoto, Japan' and return the top ranked GeoJSON result with its country, city, and OSM ID?"},{"title":"Address validation and geolocation","prompt":"Can you geocode 'Eiffel Tower, Paris' and tell me the exact latitude, longitude, and postcode so I can pin it on a map?"}],"resultDescription":"A ranked list of GeoJSON Feature objects, each containing geometry (type and coordinates), and properties such as name, country, city, postcode, and OSM IDs. Results are ordered by relevance to the input query.","failureModes":["Ambiguous place name returns unrelated or low-confidence results","Non-existent or misspelled address returns empty feature list","Network timeout or upstream Photon service unavailability returns error","Malformed POST body causes 400 bad request","x402 payment failure prevents call from completing"],"whenToPreferThis":"Choose this endpoint when you need keyless, OpenStreetMap-backed geocoding with GeoJSON output that includes OSM IDs, postcode, city, and country — especially in agent workflows that avoid managing API keys or when OSM coverage and licensing is preferred over commercial geocoders like Google Maps or Mapbox.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:58:16.373Z","isFirstParty":false}