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

• Google Places API (New) Documentation
• Field Mask Reference