WorqHat
Utility

Google Maps

Category
Utility
Node Type
Integration

Overview

The Google Maps Node allows your workflow to connect with Google Maps services and retrieve various location-based data or features. This can include operations such as finding routes, geocoding addresses, fetching nearby places, or analyzing map data.

It serves as a convenient bridge between your workflow and Google Maps functionalities without requiring direct API setup or code.

Description

Access Google Maps features.

The Google Maps Node enables you to use features of Google Maps within your workflow. You can select a specific function through the option parameter.

Geocoding

Convert addresses to coordinates and vice versa.

Directions & Distance

Calculate routes, travel time, and distance.

Once executed, this node interactions with Google Maps and returns structured results. It’s ideal for automating tasks that involve location lookup, distance calculation, travel planning, or region-based analysis.

Input Parameters

The Google Maps Node accepts the following input parameters:

optionstringRequired
The Google Maps feature to perform.
Example
"geocode"
Supported Options
  • geocode: Convert address to coordinates.
  • reverse-geocode: Convert coordinates to an address.
  • get-directions: Retrieve route details.
  • get-distance: Calculate travel distance and duration.
  • nearby-search: Find nearby locations.

Output Parameters

The node returns key details about the operation.

processingCountnumberOptional
Number of items processed.
Example
1
processingTimestringOptional
Total time taken for the operation.
Example
"2025-10-27T11:22:00Z"
processingIdstringOptional
Unique identifier for the request.
Example
"gmaps-req-98213"
resultobjectOptional
The actual data returned by Google Maps (coordinates, distance, etc.).

Output Type

Output Type: JSON

The output is returned as structured text in JSON format, which may include location details, travel times, or place information depending on the option used.

Example Usage

Example 1: Get Coordinates (Geocode)

Convert an address to latitude/longitude.

{  "option": "geocode",  "address": "1600 Amphitheatre Parkway, Mountain View, CA"}
{  "processingCount": 1,  "processingId": "gmaps-req-98213",  "result": {    "lat": 37.422,    "lng": -122.084  }}

Example 2: Calculate Distance

Find distance between two points.

{  "option": "get-distance",  "origin": "New York, NY",  "destination": "Boston, MA"}
{  "processingCount": 1,  "result": {    "distance": "215 mi",    "duration": "3 hours 50 mins"  }}

How to Use in a No-Code Workflow

1

Add the Node

Drag and drop the Google Maps Node into your workflow.

2

Set Option

Specify the option (e.g., "geocode", "get-distance").

3

Provide Data

Map required inputs (like addresses or coordinates) from previous nodes.

4

Use Results

Pass the computed map information to another node (e.g., save to database).

Best Practices

  • Double-check the option value matches your intent.
  • Ensure you have necessary API permissions if using a custom key.

Do / Don’t

Do
  • ✔️ Use descriptive node names (e.g., "Get Office Distance").
  • ✔️ Use the processingId for troubleshooting.
  • ✔️ Validate addresses before sending them to the node.
Don’t
  • ❌ Don’t send empty location data.
  • ❌ Don’t use unsupported option strings.

Common Errors

Missing optionErrorOptional
The `option` parameter was not provided.
Invalid option valueErrorOptional
The selected `option` is not supported.
Request failedErrorOptional
Google Maps API could not process the request (invalid data).

Example Workflow Integration

Use Case: Calculate Delivery Distance

Estimate delivery time and cost based on distance.

  1. Order Placed: Trigger workflow when a new order comes in.
  2. Google Maps: Use get-distance with store and customer addresses.
  3. Update Database: Save the estimated delivery time and distance.

Workflow Data Flow:

{{order.customerAddress}} → {{googleMaps.destination}}
{{googleMaps.result.distance}} → {{db.update.distance}}