Places Category Sweep (official Google Places API, your key)
Pricing
from $1.00 / 1,000 results
Places Category Sweep (official Google Places API, your key)
Every place of a given type in a country or bounding box: place_id, address, rating, hours, reviews. Uses the official Places API (New) on your own key, so the data is licensed to you.
Pricing
from $1.00 / 1,000 results
Rating
0.0
(0)
Developer
Joel Chambers
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Places Category Sweep
Every Google place of one type inside a whole country or any bounding box, with Place ID, address, coordinates, rating, phone, website, opening hours, business status and Google's returned reviews.
Runs on the official Google Places API (New) with your own API key. Google bills your project for the API calls; the data you get is licensed to you under Google's terms. This actor charges only for its run time.
What it does
- Splits the area into a grid of Nearby Search circles.
- Google caps each Nearby Search at 20 results, so any cell that hits the cap is split into four and searched again, down to about 1 km, until every cell comes back under the cap. Dense cities get fine cells, empty countryside gets coarse ones.
- Deduplicates by Place ID.
- Optionally fetches Place Details for each result (hours, status, reviews, Maps link).
Input
| Field | Meaning |
|---|---|
apiKey | Your Google Places API (New) key. Stored as a secret. |
placeType | A Places API type, e.g. veterinary_care, dentist, gym, pharmacy, car_repair. |
country | DE, AT, CH, UK, NL, US, FR, ES. |
bbox | Optional [south, west, north, east] for any other area. Overrides country. |
fetchDetails | Add hours, status and reviews (one extra Google call per place). Default on. |
maxPlaces | Stop after this many places. Handy for a test run. |
Output
One dataset row per place:
The key-value store gets a SUMMARY record with the place count and the number of Google calls made.
Google cost
Nearby Search and Place Details are billed by Google per call. A country-wide sweep of one category makes a few thousand Nearby calls plus one Details call per place. With reviews included, Place Details is roughly USD 20 per 1,000 places. Set fetchDetails to false for a cheap first pass, or use maxPlaces to test.
Notes
- Google returns at most five reviews per place through the API. That is a Google limit, not the actor's.
- Place types must be from Google's Places API (New) table. Unknown types return zero results.
- 429 responses are retried with a short back-off.
