geolocator

Google Places Search n8n node

Package Information

Downloads: 6 weekly / 23 monthly
Latest Version: 0.1.1
Author: Niko

Available Nodes

Google Places Search icon
Google Places Search
Search for places using the Google Places API (New) Text Search endpoint

Documentation

n8n-nodes-geolocator

This is an n8n community node for searching places using the Google Places API (New).

Features

  • Text Search: Search for places using a text query (e.g., "coffee shops in Paris").
  • Field Masking: Optimize billing and response size with presets (Basic, Contact, Location, Wildcard) or custom masks.
  • Location Biasing: Bias results towards a specific geographic area using latitude, longitude, and radius.
  • Filtering: Filter by place type, price level, and current opening status.
  • Internationalization: Support for language and region codes.
  • Raw Response: Option to return the full API response object.

Installation

Community Nodes UI

  1. Go to Settings > Community Nodes in your n8n instance.
  2. Click Install a community node.
  3. Enter n8n-nodes-geolocator and click Install.

Manual Installation

In your n8n installation directory, run:

npm install n8n-nodes-geolocator

Prerequisites

  1. Google Cloud Project: You need a Google Cloud project with the Places API (New) enabled.
  2. API Key: Create an API key in the Google Cloud Console.
  3. Billing: Ensure billing is enabled for your project.

Credentials Setup

  1. In n8n, create a new Google Places API credential.
  2. Paste your API Key.
  3. Click Save.

Node Parameters

Parameter Type Description
Operation Options Currently supports Text Search.
Text Query String The search string, e.g. "coffee shops in Paris".
Field Mask Options Preset or custom field selection (controls billing).
Page Size Number Max results per page (1–20).
Language Code String BCP-47 language code e.g. en, fr.
Region Code String CLDR two-character region code e.g. us, gb.
Included Type String Restrict to a single place type e.g. restaurant.
Open Now Boolean Only return currently open places.
Min/Max Price Level Options Filter by price tier.
Location Bias Number Center point and radius for result biasing.
Output Raw Response Boolean Return full API response instead of one item per place.

Field Mask & Billing

The Google Places API (New) uses Field Masks to determine which fields are returned and how you are billed.

Preset X-Goog-FieldMask String Billing Tier
Basic places.id,places.displayName,places.formattedAddress,places.rating,places.nationalPhoneNumber,places.googleMapsUri,places.location Essentials / Pro
Contact ...places.websiteUri,places.regularOpeningHours,places.currentOpeningHours Enterprise
Location ...places.viewport,places.plusCode,places.addressComponents Pro
Wildcard * Enterprise (Highest)

Example Output

{
  "id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "displayName": {
    "text": "Google Australia",
    "languageCode": "en"
  },
  "formattedAddress": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
  "rating": 4.5,
  "nationalPhoneNumber": "(02) 9374 4000",
  "googleMapsUri": "https://maps.google.com/?cid=10281119596374313810",
  "location": {
    "latitude": -33.866651,
    "longitude": 151.195827
  }
}

Resources

Discussion