# HubVibe Maps Places Search

> HubVibe Maps Places Search is a paid API for AI agents from hubvibe-io.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Search for businesses, addresses, and points of interest using Google Maps Grounding via a paid API endpoint

## Facts

- Endpoint: POST https://hubvibe-io.com/work/maps/places?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hubvibe-maps-places-search-71bbb459
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t0ljlNpLlmvpOfpco8IBn

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 hubvibe-maps-places-search-71bbb459 -d '<json body>'
```

Example prompt: Find me good coffee shops near the Ferry Building in San Francisco — I need a place with good wifi to work from this afternoon.

## When to prefer this

Choose this endpoint when you need Google Maps-quality place search results grounded in real business data, especially for local business discovery, address lookup, or POI search. It is preferable to generic web search when structured place data (names, addresses, categories) is needed rather than editorial content about a location.

## Known failure modes

- Maps Grounding Lite API key not configured by operator — endpoint returns unavailable error
- Vague or ambiguous query returns irrelevant results
- Region code not recognized or malformed — may fall back to global results
- No matching places found for the query in the specified region
- Rate limiting or payment failure on the $0.10 USDC per-call charge

## How this service works

Places near me / local search anywhere: 'coffee near the Ferry Building, San Francisco', 'ramen near Shibuya Station', 'pharmacy' at coordinates. From Overture Maps open places data (80M+ places): name, category, distance, address, website, phone, brand, open status and confidence, nearest first; the area widens when nothing is close. Input: query; optional near, lat and lng, radius_m, limit.

## Output

A list of matching places including business names, addresses, and relevant location details sourced from Google Maps, filtered to the query and optional region bias.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "lng": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "near": {
   "type": "string",
   "maxLength": 200
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
   "maxLength": 35
  },
  "radius_m": {
   "type": "number",
   "maximum": 10000,
   "minimum": 50
  },
  "region_code": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "near": {
    "lat": 37.7955,
    "lon": -122.3937,
    "name": "San Francisco Ferry Building (building in San Francisco)",
    "source": "Wikidata Q1060289"
   },
   "what": "coffee",
   "notes": [],
   "query": "coffee near the Ferry Building, San Francisco",
   "places": [
    {
     "id": "8333e7a5-b1ca-4c61-969d-5543d8de977a",
     "lat": 37.7953,
     "lon": -122.3931,
     "name": "Red Bay Coffee Ferry Building",
     "brand": "Red Bay Coffee",
     "phone": "(415) 983-8000",
     "address": "Ferry Building, 1, San Francisco, CA, 94111",
     "country": "US",
     "sources": [
      "meta"
     ],
     "website": "http://redbaycoffee.com",
     "category": "coffee_shop",
     "confidence": 0.942,
     "distance_m": 54,
     "operating_status": "open"
    }
   ],
   "radius_m": 1000,
   "checked_at": "2026-09-26T18:00:00Z",
   "attribution": [
    {
     "url": "https://docs.overturemaps.org/attribution/",
     "text": "Places data from Overture Maps Foundation ..."
    }
   ],
   "place_count": 10
  },
  "status": "ok",
  "worker": "maps.places",
  "price_usd": 0.1,
  "provenance": {
   "steps": [
    {
     "ms": 640,
     "ok": true,
     "step": "places",
     "provider": "places"
    }
   ],
   "attempts": 1,
   "elapsed_ms": 660,
   "providers_used": [
    "places"
   ]
  },
  "receipt_id": "rcpt_9f1c2b3a4d5e6f70",
  "receipt_url": "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hubvibe-maps-places-search-71bbb459/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hubvibe-io.com](https://www.zero.xyz/host/hubvibe-io.com/llms.txt)