google_maps_search
Read-onlyIdempotent
Retrieve structured local business results from Google Maps. Provide a query and coordinates to get name, address, rating, and reviews count for building datasets or competitive analysis.
Instructions
Retrieve parsed Google Maps place/business results for a query.
Returns structured local business/place results (name, address, rating,
reviews count, category, coordinates) from Google Maps for a query,
optionally centered on a latitude/longitude and zoom level.
When to use:
- Local business discovery ('coffee shops in Austin')
- Building local listings datasets; location-based competitive research
When NOT to use:
- Non-local web results (use 'google_search')
- Driving directions or routing (not provided by this endpoint)
Args:
params (GoogleMapsSearchParams): query, latitude, and longitude are
required; optional zoom, country_code, tld, output_format, and
include_html.
Returns:
str: JSON (default) or CSV containing the structured maps results.
Raises:
ToolError: If the API key is missing, the rate limit is exceeded, or
the request fails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |