{"uid":"cap_tcXN1qeahEpv0vRKyb_Ga","slug":"google-maps-nearby-search-full-5ec81630","name":"Google Maps Nearby Search (Full)","description":"Google Maps Nearby Search (Full). Finds places near a latitude/longitude using Google Places supported type filters. Use google-maps/text-search/full for natural-language searches like \"wedding planner\" or \"event planner\".","url":"https://stable-enrich-git-shafu-stableenrich-nearb-74cfdf-merit-systems.vercel.app/api/google-maps/nearby-search/full","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"languageCode":{"type":"string","default":"en"},"excludeFields":{"type":"array","items":{"type":"string"},"default":["photos"]},"excludedTypes":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Optional Google Places Table A place types to exclude."},"includedTypes":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Optional Google Places Table A place types only, e.g. restaurant, bar, store, real_estate_agency. Do not use natural-language categories like wedding_planner or event_planner; use google-maps/text-search/full for text queries."},"maxResultCount":{"type":"number","default":5,"maximum":5,"minimum":1},"rankPreference":{"enum":["POPULARITY","DISTANCE"],"type":"string","default":"POPULARITY"},"locationRestriction":{"type":"object","required":["circle"],"properties":{"circle":{"type":"object","required":["center","radius"],"properties":{"center":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"description":"Latitude/longitude center point for the nearby search circle.","additionalProperties":false},"radius":{"type":"number","maximum":50000,"minimum":0,"description":"Radius in meters. Google Places caps this at 50000."}},"additionalProperties":false}},"description":"Required search area. Use locationRestriction.circle.center and locationRestriction.circle.radius; do not send top-level center or radius fields.","additionalProperties":false}}},"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_-B6AYCjnNhpbPOBy8_0xO","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":"Finds places near a given latitude/longitude using Google Places supported type filters, returning full place details.","exampleAgentPrompt":"Find all restaurants within 500 meters of latitude 37.7749, longitude -122.4194 using the 'restaurant' place type filter.","exampleUseCases":[{"title":"Nearby restaurant discovery for travelers","prompt":"Find me restaurants within 1 kilometer of coordinates 48.8566, 2.3522 in Paris — filter by the 'restaurant' place type."},{"title":"Locating pharmacies near a patient","prompt":"Search for pharmacies near latitude 40.7128 and longitude -74.0060 within 800 meters so I can find the closest one to my current location."},{"title":"Hotel scouting near a venue","prompt":"Find hotels within 2 kilometers of the coordinates 51.5007, -0.1246 — I need somewhere to stay near that spot in London."}],"resultDescription":"Returns a list of nearby places matching the specified type filter, each including place name, address, geographic coordinates, place ID, business category, ratings, and where available opening hours and other details from Google Places.","failureModes":["Invalid or out-of-range latitude/longitude returns an error","Unsupported place type filter results in empty or error response","Radius value outside Google Places allowed bounds causes failure","No places found within the specified radius returns an empty results array","Payment not included or insufficient USDC causes x402 payment error"],"whenToPreferThis":"Use this endpoint when you have specific geographic coordinates and want to find places of a known Google Places type (e.g. 'restaurant', 'hospital', 'gas_station') nearby. Prefer this over text-search when the query is structured and type-based rather than a natural-language description like 'wedding planner'.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:22.179Z","isFirstParty":false}