{"uid":"cap_FxdyCc-q5SxXl3SeCPgbM","slug":"google-maps-local-business-search-by-coordinates-viewport-141415fd","name":"Google Maps Local Business Search by Coordinates Viewport","description":"Google Maps local business search — find places by query and map location (coordinates viewport), returning ratings, reviews, address, phone, website, hours & service options as clean JSON.","url":"https://places.use.x402atlas.com/local?utm_source=zero.xyz","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","required":["q"],"properties":{"q":{"type":"string","maxLength":400,"description":"Google Maps search query (business, category, or 'near me' phrase)"},"gl":{"type":"string","maxLength":8,"description":"Optional country code (e.g. us)"},"hl":{"type":"string","maxLength":8,"description":"Optional language code (e.g. en)"},"ll":{"type":"string","maxLength":64,"description":"Optional viewport to bias results: @latitude,longitude,zoom (e.g. @40.7455,-74.0083,14z)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","queried_at","results"],"properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","required":["title"],"properties":{"type":{"type":"string"},"hours":{"type":"object","description":"Opening hours, upstream shape passed through as-is"},"phone":{"type":"string"},"price":{"type":"string"},"title":{"type":"string"},"rating":{"type":"number"},"address":{"type":"string"},"data_id":{"type":"string"},"reviews":{"type":"integer"},"website":{"type":"string"},"place_id":{"type":"string"},"position":{"type":"integer","description":"Rank in the result list"},"open_state":{"type":"string"},"gps_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"service_options":{"type":"object","description":"Dine-in/takeout/delivery flags, upstream shape passed through as-is"}}}},"queried_at":{"type":"string","format":"date-time"}}}}}}},"responseSchema":{"type":"json","example":{"query":"coffee","results":[{"type":"Coffee shop","title":"Blue Bottle Coffee","rating":4.5,"address":"1 Rockefeller Plaza, New York, NY","reviews":812,"place_id":"ChIJN1t_tDeuEmsRUsoyG83frY4","position":1,"gps_coordinates":{"latitude":40.7443,"longitude":-74.0034}}],"queried_at":"2026-07-10T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZkhJUHIFP0vFWdu_hYJJg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Google Maps for local businesses by query string and optional coordinate viewport, returning structured results with ratings, reviews, address, phone, website, hours, and service options.","exampleAgentPrompt":"Search Google Maps for highly rated Italian restaurants near Times Square, New York — use coordinates around @40.7580,-73.9855,14z — and give me their names, ratings, addresses, phone numbers, and hours.","exampleUseCases":null,"resultDescription":"A JSON object containing the original query string, a timestamp, and an array of place results. Each result includes business title, rating, review count, address, phone number, website URL, open/closed state, opening hours object, GPS coordinates (lat/lng), place_id, data_id, position rank, price level, business type, and service options flags (dine-in/takeout/delivery).","failureModes":["No results returned if query is too specific or location viewport is too narrow","Payment failure (402) if USDC balance is insufficient or x402 handshake fails","Rate limiting or upstream Google Maps data unavailability causing empty or partial results","Invalid ll parameter format causing query to ignore viewport bias","Query exceeding 400 character limit rejected with validation error"],"whenToPreferThis":"Use this endpoint when you need Google Maps business data biased to a specific geographic coordinate viewport (latitude, longitude, zoom). Prefer this over the free-text location variant when you have precise coordinates. Prefer Google Maps data over the Apple Maps or DuckDuckGo siblings when review counts and Google ratings are important, or when the user explicitly references Google Maps results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-08T02:39:58.065Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:34:09.944Z","isFirstParty":false,"canonicalSlug":"google-maps-local-business-search-by-coordinates-viewport-141415fd"}