n8n-nodes-google-maps-places-api
v0.1.1
Published
Search Google Maps and return places with ratings, addresses, phone numbers, and coordinates. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.
Maintainers
Readme
n8n-nodes-google-maps-places-api
An n8n community node that searches Google Maps and returns structured places: title, address, rating, type, phone, website, and coordinates. It is backed by the Google Maps Places API on Apify and bills per result, so there are no subscriptions and no minimums.
Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources
What it does
Give the node a search term and an optional location, and it returns one item per place with the title, address, rating, review count, category, phone, website, and GPS coordinates. It also works as an AI Agent tool, so an agent can pull local business data on demand. This is great for lead generation and local research.
- Search Google Maps for any business or place
- Localize with a location and language
- Control how many results to return
- Choose how much data to return per place: Simplified, Raw, or Selected Fields
Installation
Follow the n8n community nodes installation guide:
- In n8n, open Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-google-maps-places-apias the npm package name. - Agree to the risks of using community nodes, then select Install.
After it installs, the Google Maps Places node appears in the nodes panel.
n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.
Credentials
You need a free Apify account and an API token.
- Sign in to the Apify Console.
- Open Settings > Integrations and copy your Personal API token.
- In n8n, create a new Apify API credential and paste the token.
- Use the credential's Test button to confirm it works.
The node also supports Apify OAuth2 if you prefer to connect that way.
Operations
Place > Search returns places that match a search term.
| Parameter | Description | | --- | --- | | Search Term | What to search Google Maps for. Required. | | Location | Location to center the search on. Optional. | | Language | Two-letter language code for the results. Optional. | | Maximum Results per Search | How many places to return. | | Output | How much data to return: Simplified, Raw, or Selected Fields. |
Output
Each place is returned as its own n8n item. The API returns more than ten fields per place, so the Output parameter lets you choose how much to return:
- Simplified (default): a compact object with
title,address,rating,ratingCount,type,phoneNumber,website,latitude,longitude, andplaceId. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small. - Raw: every field the API returns for each place, using the original field names below.
- Selected Fields: pick exactly which fields to include.
Fields (Raw and Selected Fields)
| Field | Type | Description |
| --- | --- | --- |
| searchTerm | string | The term that produced this result |
| position | integer | Rank in the results |
| title | string | Place name |
| address | string | Full address |
| latitude | number | Latitude |
| longitude | number | Longitude |
| rating | number | Average rating |
| ratingCount | integer | Number of ratings |
| priceLevel | string | Price level |
| type | string | Primary category |
| types | array | All categories |
| phoneNumber | string | Phone number |
| website | string | Website URL |
| description | string | Short description |
| openingHours | object | Hours by day |
| thumbnailUrl | string | Thumbnail image URL |
| cid | string | Google customer ID |
| fid | string | Google feature ID |
| placeId | string | Google place identifier |
Example workflows
1. Build a local lead list
- Manual Trigger.
- Google Maps Places: Search Term a category and city, Output
Simplified. - Google Sheets: append each place's
title,address,phoneNumber, andwebsite.
2. Enrich place data
- Read a list of business names.
- Google Maps Places: search each name.
- Set: keep
rating,ratingCount, andwebsite.
3. Let an AI Agent find places
- AI Agent node.
- Attach Google Maps Places as a tool.
- Ask "Find top-rated plumbers in Denver." The agent calls the node (in Simplified mode) and answers with live places.
Pricing
This node calls the Google Maps Places API on Apify, which is billed pay-per-result, with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the Actor page for current rates.
Resources
- Google Maps Places API on Apify
- npm package
- n8n community nodes documentation
- Apify n8n integration guide
