Google Places¶
Overview¶
The Google Places task shows how a business appears on Google Maps. It runs on BaseCloud's own Google access, so there is nothing to connect.
It has three actions:
| Action | What it tells you |
|---|---|
| Local rank grid | The business's position on Google Maps for a search, at every point of a grid around it, and the change since last time. |
| Look up a business | What Google shows about a business: address, phone, website, rating, reviews, category, opening hours. |
| Competitor snapshot | The top businesses for a search in an area, with their ratings and review counts. |
When to use this task:
- Track a client's local visibility for the searches that matter to them, week by week.
- Send a client a map of where they show up and where they don't.
- Show a prospect how they compare with the businesses that beat them.
- Fill in a new lead's phone, website and rating from their Google listing.
What the rank grid measures
The grid measures Google Maps positions: where the business's listing appears in the list of businesses for a search. It does not measure where the business's website appears in normal Google search results.
Positions come from Google's own ranking for someone searching at each point. They are very close to what the Google Maps app shows, but not always identical, because the app also personalises results and mixes in ads. Because every run measures the same way, the change from run to run is reliable, which is what matters for tracking.
Configuration¶
Builder fields¶
The Field column is the label as it appears in the task builder; Key is the name the value is stored under and referenced by.
| Field | Key | Type | Default | Notes |
|---|---|---|---|---|
| What to do | action |
select | rank_grid |
Options: Local rank grid · Look up a business · Competitor snapshot |
| Business | place_business |
google-place-select | – | |
| Business website (optional) | business_website |
text | – | |
| Search | keyword |
text | – | Only shown when action is rank_grid, competitor_snapshot |
| Search around | centre_mode |
select | business |
Options: The business · An address. Only shown when action is rank_grid, competitor_snapshot |
| Address | centre_address |
text | – | |
| Grid size | grid_size |
select | 5 |
Options: 3 × 3 (9 points) · 5 × 5 (25 points) · 7 × 7 (49 points) · 9 × 9 (81 points). Only shown when action is rank_grid |
| Distance between points | grid_spacing |
number | 1 |
Only shown when action is rank_grid |
| Unit | spacing_unit |
select | mi |
Options: Miles · Kilometers. Only shown when action is rank_grid |
| Create a grid image | create_image |
checkbox | 0 |
Only shown when action is rank_grid |
| How many businesses | result_count |
number | 10 |
Only shown when action is competitor_snapshot |
Choosing the business¶
The Business field has two modes, switched with the button beside it:
- Search: type the business name and pick it from Google's listings. This is the most reliable choice.
- Variable: use a value from an earlier step, or type the business name and town
(
Joe's Plumbing, Austin TX). A value from an earlier step can be a Google place ID, such aslocation_place_idfrom the Google Review Received trigger, or a name. When you type a name, also fill in Business website so the task picks the right business when several share a name.
Local rank grid settings¶
| Setting | Guidance |
|---|---|
| Search | What a customer types into Google Maps, e.g. emergency plumber. Leave the town out; the grid supplies the location. One search per step. For several, put this step inside a Loop. |
| Search around | The business's own location (usual), or an address, e.g. a town the business wants to win. |
| Grid size | 3 × 3 to 9 × 9. Larger grids show more detail and take a little longer. |
| Distance between points | About 0.5 miles in a busy city, 1 to 2 miles in a town, more for businesses that cover a wide area. |
| Create a grid image | Saves a map picture of the grid to Files. |
Output Fields¶
Local rank grid¶
| Field | Description |
|---|---|
{{task_ID_business_name}} |
The business measured. |
{{task_ID_place_id}} |
Its Google place ID. |
{{task_ID_keyword}} |
The search. |
{{task_ID_average_rank}} |
Average position across the grid, e.g. 5.4. A point where the business is not in the top 20 counts as 21. |
{{task_ID_top3_percent}} |
Share of points where it is in the top 3, e.g. 48. |
{{task_ID_top3_points}} |
Number of points where it is in the top 3. |
{{task_ID_found_percent}} |
Share of points where it is in the top 20. |
{{task_ID_best_rank}} / {{task_ID_worst_rank}} |
Best and worst position where it was found. Empty when it was not found anywhere. |
{{task_ID_points_total}} |
Number of points in the grid. |
{{task_ID_average_rank_change}} |
Change in average position since the last run of this step with the same business, search and grid. Negative means it moved up. Empty on the first run. |
{{task_ID_top3_percent_change}} |
Change in top 3 share since that run, e.g. 16. |
{{task_ID_previous_run_date}} |
The date of the run it was compared with. |
{{task_ID_business_rating}} |
The business's Google rating. |
{{task_ID_business_review_count}} |
Its number of Google reviews. |
{{task_ID_review_count_change}} |
New reviews since the compared run. |
{{task_ID_competitors}} |
The top 5 competitors across the grid: name, average_rank, top3_percent, rating, review_count, category. |
{{task_ID_grid}} |
Every point: row, col, lat, lng, rank (empty when not in the top 20). |
{{task_ID_grid_image_url}} |
Link to the grid image, when Create a grid image is on. |
{{task_ID_grid_image_file_id}} |
The image's Files ID, for attaching it to an email. |
{{task_ID_run_date}} |
The date of this run. |
{{task_ID_searches_made}} |
How many Google requests the run made. |
{{task_ID_run_text}} |
A plain summary, e.g. Joe's Plumbing for "emergency plumber": in the top 3 at 12 of 25 points. Average position 5.4, 1.2 places better than last run. |
Look up a business¶
business_name, place_id, address, phone, international_phone, website, rating,
review_count, category, opening_hours (one line per day), maps_url, business_status
(Open, Temporarily closed or Permanently closed), latitude, longitude.
Competitor snapshot¶
| Field | Description |
|---|---|
{{task_ID_results}} |
The businesses in order: position, name, rating, review_count, category, address, website, is_business. |
{{task_ID_business_position}} |
Where the chosen business sits (1–20), or empty when it is not in the top 20. |
{{task_ID_business_review_count}} |
The chosen business's review count. |
{{task_ID_top3_average_reviews}} |
Average review count of the top 3. |
{{task_ID_top3_average_rating}} |
Average rating of the top 3. |
The grid image¶
With Create a grid image on, the task saves a PNG to Files named
Rank grid - <search> - <date>.png. It shows:
- the business, search, grid size and date, with the average position, top 3 share and top 20 share
- a map with a numbered circle at every point: green 1–3, amber 4–10, red 11–20, grey not in the top 20
- a dark diamond marking the business when the grid is centred somewhere else
Attach it with the Email task using {{task_ID_grid_image_file_id}}, or place
{{task_ID_grid_image_url}} in a PDF.
Real-World Examples¶
Weekly visibility report for a client¶
Schedule Every Monday, 7am
└─ Google Places Local rank grid, "emergency plumber", 7 × 7, image on
└─ AI Prompt "Summarise this week's local visibility for the client in 3 sentences"
└─ Email summary + grid image to the client
Track several searches¶
Schedule
└─ Loop over "emergency plumber, water heater repair, drain cleaning"
└─ Google Places Local rank grid, Search = the Loop item
└─ Table add a row: date, search, average position, top 3 %
Keeping one row per run in a Table gives you the history to chart.
Alert when visibility drops¶
Google Places Local rank grid
└─ If Statement average_rank_change is greater than 2
└─ Email tell the account manager, with the grid image
Prospecting¶
Form Submission prospect's business name and town
└─ Google Places Competitor snapshot, Business = the prospect
└─ Email "You're #9 for 'dentist'. The top 3 average 180 reviews; you have 42."
Best Practices¶
- Run on a schedule and keep the settings fixed. The change since last run only compares runs with the same business, search, grid size, distance and centre.
- Use searches customers actually make. The client's Google Business Profile search terms are a good source.
- Read the whole grid, not single points. One point moving from 3 to 5 is often noise; the average and top 3 share are the trend.
- Watch reviews alongside positions. Review count and rating are among the biggest local ranking factors, and often move before positions do.
- Match the distance to the business. A grid far wider than the business's real service area mostly shows red, which says little.
Troubleshooting¶
| Message | Cause and fix |
|---|---|
No business chosen. |
Pick a business, or map one from an earlier step. |
Google has no business listing matching "…". |
Check the spelling, add the town, or search for it in the Business field instead. |
No Google listing for "…" has the website … |
Google found businesses with that name, but none with that website. The message lists the closest matches. Check the website, or pick the business with Search. |
No keyword given. |
Fill in Search. |
Google could not find the address "…". |
Use a fuller address, a zip code, or coordinates such as 30.2672, -97.7431. |
The spacing between points must be between 0.1 and 25 miles (40 km). |
Change Distance between points. |
…the map background could not load… |
The grid image was saved without its map. Contact BaseCloud support if this keeps happening. |
Google Places is not set up on this BaseCloud server yet. |
Contact BaseCloud support. |
Rate limited by Google — rescheduled for retry. |
Google asked us to slow down. The task runs again automatically. |
Frequently Asked Questions¶
Does this cost credits? No.
Does the client need to connect anything? No. It works for any business on Google Maps, including prospects and competitors.
Why is my average position 21? The business was not in the top 20 anywhere on the grid. Check you have the right business, or try a smaller distance between points.
Why doesn't it match exactly what I see on my phone? Your phone personalises results and shows ads. This task measures the same neutral way every time, so it is best for tracking change.
Does it show where the website ranks in Google search? No. It measures Google Maps listings only.
Related Tasks¶
- Loop - Run the grid for several searches
- Table - Keep a history of each run
- Email - Send the summary and grid image
- PDF - Put the grid image in a report
- Google Review Received - Supplies
location_place_idfor the business