# Google Maps Nearby Search (Full)

> Google Maps Nearby Search (Full) is a paid API for AI agents from stable-enrich-git-shafu-stableenrich-nearb-74cfdf-merit-systems.vercel.app, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-15).

Finds places near a given latitude/longitude using Google Places supported type filters, returning full place details.

## Facts

- Endpoint: POST https://stable-enrich-git-shafu-stableenrich-nearb-74cfdf-merit-systems.vercel.app/api/google-maps/nearby-search/full
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-maps-nearby-search-full-5ec81630
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tcXN1qeahEpv0vRKyb_Ga

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-maps-nearby-search-full-5ec81630 -d '<json body>'
```

Example prompt: Find all restaurants within 500 meters of latitude 37.7749, longitude -122.4194 using the 'restaurant' place type filter.

## When to prefer this

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'.

## Known failure modes

- 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

## How this service works

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".

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-maps-nearby-search-full-5ec81630/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-enrich-git-shafu-stableenrich-nearb-74cfdf-merit-systems.vercel.app](https://www.zero.xyz/host/stable-enrich-git-shafu-stableenrich-nearb-74cfdf-merit-systems.vercel.app/llms.txt)