# Google Maps Local Business Search by Coordinates Viewport

> Google Maps Local Business Search by Coordinates Viewport is a paid API for AI agents from places.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

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.

## Facts

- Endpoint: GET https://places.use.x402atlas.com/local?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Success rate: 0% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-maps-local-business-search-by-coordinates-viewport-141415fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FxdyCc-q5SxXl3SeCPgbM

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-local-business-search-by-coordinates-viewport-141415fd
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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

## Request schema (JSON Schema)

```json
{
 "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": {
     
… (truncated)
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-maps-local-business-search-by-coordinates-viewport-141415fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from places.use.x402atlas.com](https://www.zero.xyz/host/places.use.x402atlas.com/llms.txt)