@blackcess/n8n-nodes-innate-google-places
v0.1.0
Published
An n8n community node that integrates with the Google Places API (New) — Text Search endpoint.
Maintainers
Readme
n8n-nodes-innate-google-places
An n8n community node that integrates with the Google Places API (New) — Text Search endpoint.
Search for restaurants, landmarks, businesses, or any place on Earth directly from your n8n workflows.
Features
- 🔑 Secure API Key credential — stored encrypted by n8n
- 🗺️ Text Search — search by any natural language query (e.g. "coffee shops in Berlin")
- 🎛️ Field Mask control — only request the fields you need (controls billing!)
- 📊 Flat output — each place is a separate n8n item, ready for downstream nodes
- ⚙️ Advanced filters — max results, language, region, open now, price level, min rating
Prerequisites
- A Google Cloud project with billing enabled
- The Places API (New) enabled in your project
- An API Key (restrict it to the Places API for security)
Get your key: https://developers.google.com/maps/documentation/places/web-service/get-api-key
Installation
In n8n Desktop / Cloud
- Go to Settings → Community Nodes
- Click Install
- Enter:
n8n-nodes-innate-google-places - Click Install
Self-hosted n8n (npm)
cd ~/.n8n
npm install n8n-nodes-innate-google-places
# Restart n8nSetup
- In n8n, open any workflow and search for "Google Places Search"
- Click Create new credential → enter your API Key
- Type your search query and run!
Node Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| Text Query | ✅ | Natural language query, e.g. "pizza in London" |
| Field Mask | ✅ | Fields to return (affects billing). Default includes common fields. |
| Max Result Count | ⬜ | 1–20 results (default: 20) |
| Language Code | ⬜ | BCP-47 code, e.g. en, fr |
| Region Code | ⬜ | ISO 3166-1 alpha-2, e.g. US, GB |
| Open Now Only | ⬜ | Filter to currently open places |
| Minimum Rating | ⬜ | Only return places rated ≥ this value (0–5) |
| Price Levels | ⬜ | Filter by price: Free / Inexpensive / Moderate / Expensive |
Output Fields (default Field Mask)
Each place becomes one n8n output item with these fields:
{
"id": "ChIJ...",
"displayName": "Joe's Pizza",
"formattedAddress": "123 Main St, London, UK",
"nationalPhoneNumber": "020 7946 0958",
"rating": 4.5,
"googleMapsUri": "https://maps.google.com/?cid=...",
"latitude": 51.5074,
"longitude": -0.1278
}Field Mask Examples
| Use Case | Field Mask |
|----------|-----------|
| Basic info only | places.id,places.displayName,places.formattedAddress |
| With contact info | places.id,places.displayName,places.nationalPhoneNumber,places.websiteUri |
| With coordinates | places.id,places.displayName,places.location |
| Full details | places.id,places.displayName,places.formattedAddress,places.nationalPhoneNumber,places.rating,places.userRatingCount,places.googleMapsUri,places.location,places.priceLevel,places.types |
License
MIT
