Search places
googlemap/placesFind places matching a text query, biased or restricted to an area.
- call
- $0.064
- Google Maps
- 5 min
Overview
Searches for places from an ordinary text query such as a cuisine, business name, or category with a location, and returns matching places with their identifiers, names, and addresses. Results can be biased toward a circle or rectangle, which prefers nearby places without excluding others, or narrowed by place type, minimum rating, price level, and whether the business is open now. Ranking is selectable between relevance and distance, and results page up to sixty in total.
A list of places with their id, display name, and formatted address, plus a page token when more remain.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| textQuery | string | Yes | What to search for, including the place or area. |
| pageSize | integer | No | How many places to return per page. |
| includedType | string | No | Restrict results to a single place type. |
| openNow | boolean | No | Only return places open at the time of the request. |
| minRating | number | No | Lowest average rating to accept. |
| locationBias | object | No | A circle or rectangle to prefer results near. |
| languageCode | string | No | Language of the returned place names. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"googlemap","endpoint":"places","input":{"textQuery":"coffee in Sydney, Australia","pageSize":10,"languageCode":"en"}}'Pricing
$0.064 per call on the default plan. Every run carries its price in the response.