Search nearby
Google Maps nearby search API and MCP. Find places around a latitude and longitude.
Each place includes a place_id for Place details, Place reviews, and Place photos.
/v1/google-maps/nearby-searchhttps://api.vee3.io/v1/google-maps/nearby-search
Authorization
Send your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
MCP
The same capability is available as an MCP tool on Vee3 hosted MCP.
Tool name
google-maps.nearby_searchParameters11 fields
locationstringRequiredLatitude and longitude of the search point (for example 40,-110).
max length 64
radiusintegerOptionalSearch radius in meters (default 1000).
min 1, max 50000
open_nowbooleanOptionalWhen true, return only places open for business at query time.
min_priceintegerOptionalMinimum price level (0–4, inclusive).
min 0, max 4
max_priceintegerOptionalMaximum price level (0–4, inclusive).
min 0, max 4
cursorstringOptionalPagination cursor from cursor_next on a previous response.
max length 4096
languagestringOptionalLanguage code for results (for example en).
max length 16
regionstringOptionalTwo-character region code (for example us). On search endpoints this biases results by ccTLD. On place endpoints this selects regional place data.
max length 8
place_typestringOptionalRestrict results to a single Google Maps place type (for example restaurant).
max length 64
sort_by"Relevance" | "Distance"OptionalResult ordering: "Relevance" (default) or "Distance".
max length 32
keywordstringOptionalKeyword to match nearby places (for example restaurant).
max length 256
Response17 fields
placesarrayitems14 fieldsNearby places matching the search criteria. Additional upstream fields may appear.
placesarrayitemsnamestringPlace display name.
full_addressstringFull formatted address when available.
place_idstringGoogle Maps place identifier.
ratingnumberAverage user rating when available.
locationobject2 fieldsPlace coordinates when available.
locationobjectlatitudenumberPlace latitude.
longitudenumberPlace longitude.
hoursobject3 fieldsOpening hours when available.
hoursobjectopen_nowbooleanWhether the place is open now when only open_now is available.
<day>arrayitems1 fieldOpening hours ranges for a day of the week.
<day>arrayitemshours_rangestringOpening hours range entry.
statusstringHuman-readable open/closed status when available.
typesstring[]Place type labels when available.
business_statusstringOperational status when available.
cursor_nextstringCursor for the next page when more results are available.
cursor_previousstringCursor for the previous page when available.
HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_maps_not_configured, google_maps_upstream_error