Search nearby
Search Google Maps for places near a latitude and longitude.
← All Google Maps endpoints · Capability overview
/v1/google-maps/nearby-searchhttps://api.vee3.io/v1/google-maps/nearby-search
Search Google Maps for places near a latitude and longitude.
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
search_google_maps_nearbyParameters11 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
Response18 fields
placesarrayitems15 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.
typesarrayitems1 fieldPlace type labels when available.
typesarrayitemstypestringPlace type label.
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