{"uid":"cap_ATXq_G8vkbjQmuastjalj","slug":"onhub-places-google-maps-grounded-local-search-0907db28","name":"OnHub Places — Google Maps Grounded Local Search","description":"OnHub is the pay-per-request API layer for agents. Text inference paid per request with USDC on Base.","url":"https://x402.onhub.ai/v1/places?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","maxLength":2000,"minLength":3,"description":"A local/places question to research with Google Maps grounding, e.g. \"best ramen near the ferry building\"."},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Caller latitude. Improves relevance for \"near me\"-style queries; omit for non-local questions."},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Caller longitude. Must be supplied together with latitude."},"max_results":{"type":"integer","default":5,"maximum":8,"minimum":1}}},"responseSchema":{"type":"json","example":{"query":"Best Italian restaurants within walking distance","answer":"Maccheroni Republic (4.6★) is a short walk away.","object":"places.result","places":[{"url":"https://maps.google.com/?cid=10713702449749472098","title":"Maccheroni Republic","place_id":"ChIJvVvovUvGwoARYrOMSp23rpQ"}],"searched_at":"2026-09-22T00:00:00.000Z","evidence_status":"grounded"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2UuYYUbe-hM5AS6np_oot","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Answers local/places queries using Google Maps grounding, returning ranked venue results with names, star ratings, and map URLs.","exampleAgentPrompt":"Find me the top 5 best ramen restaurants near the Ferry Building in San Francisco — I'm currently at latitude 37.7955 and longitude -122.3937.","exampleUseCases":[{"title":"Restaurant discovery near user location","prompt":"I'm at 40.7580° N, 74.0060° W in Midtown Manhattan — can you find me the top 5 highly rated Italian restaurants within walking distance?"},{"title":"Travelers finding local coffee shops","prompt":"I'm visiting Seattle and I'm near Pike Place Market at latitude 47.6085, longitude -122.3404 — find me the 3 best independent coffee shops nearby."},{"title":"Late-night pharmacy or convenience lookup","prompt":"I need to find a 24-hour pharmacy close to where I am right now — I'm at latitude 34.0522, longitude -118.2437 in Los Angeles, show me up to 4 options."}],"resultDescription":"Returns a natural-language answer grounded in Google Maps data, plus a list of up to 8 matching places each containing a venue title, Google Maps CID URL, and place_id. Also includes the original query, a timestamp of when it was searched, and an evidence_status field indicating whether the answer is grounded.","failureModes":["Query too short (under 3 characters) returns a validation error","Latitude provided without longitude (or vice versa) may degrade relevance or cause a schema error","Non-local or abstract queries may return low-confidence or empty place lists","Payment failure via x402 protocol results in 402 response before any search is performed","Google Maps grounding may return no results for very obscure or rural locations","max_results exceeding 8 is rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you need real-time, Google Maps-grounded local business and place recommendations with verifiable map URLs and ratings. It is especially useful when the user's query is location-sensitive and you have or can infer lat/lon coordinates. Prefer this over generic web search endpoints when you specifically need structured place data (name, map link, place_id) rather than a free-text answer. The per-request USDC micropayment model makes it suitable for on-demand agent workflows without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:47:05.780Z","isFirstParty":false,"canonicalSlug":"onhub-places-google-maps-grounded-local-search-0907db28"}