Google Maps

Use Google Maps when you want a workflow step to geocode addresses, search for places, retrieve place details, calculate routes, or look up time zones from a connected account.

Configuration

Option	Required	Description
Name	No	Label for the step in the workflow canvas.
Authentication	Yes	The connected Google Maps account to use for this step.
Action	Yes	The maps action to perform (for example Text Search, Geocoding API, Get Route).
Arguments	Yes	Per-action form fields generated from the action’s schema. Each text field has an Insert Variable button for injecting `{{placeholder}}` values. A Raw JSON tab is available for advanced usage.
When the step fails	No	Controls whether the workflow should Terminate Workflow or Continue if this step fails.

Before you configure this step, connect Google Maps in Integrations for your workspace using the OAuth flow. If no active connection is available, the step shows a warning with a link to Integrations instead of the account selector.

Arguments form

When you select an action, the Arguments section automatically renders a form driven by the action’s input schema. Text and query fields support workflow placeholders via Insert Variable. Switch to the Raw JSON tab for power users or when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

Available actions

The workflow action picker shows a curated subset focused on location lookups and routing:

Action	Description
Text Search	Find places using a free-text query.
Nearby Search	Search for places within a circular area.
Get Place Details	Retrieve details for a place by ID.
Autocomplete	Return place predictions for partial text input.
Geocoding API	Convert addresses to coordinates or reverse-geocode coordinates.
Geocode Address	Geocode a single address string.
Geocode Address With Query	Geocode using the modern query-parameter API.
Reverse Geocode Location	Convert coordinates to a human-readable address.
Geocode Place	Resolve a place ID to coordinates.
Get Route	Calculate a route with distance and duration.
Get Direction	Retrieve turn-by-turn directions between two points.
Compute Route Matrix	Calculate distances and times across multiple origins and destinations.
Distance Matrix (Legacy)	Legacy distance/time matrix between origins and destinations.
Get Time Zone	Look up the time zone for a location.
Embed Google Map	Generate an embeddable map URL or iframe snippet.

Tile, aerial video, and device geolocation actions are not exposed in the workflow action picker.

Output

This step stores the Google Maps API response as the step output. The shape of the response depends on the action. Use the full output reference in later steps:

{{STEP_IDENTIFIER.output}}

Example

Open Integrations and connect Google Maps if you have not already done that.
Add a Google Maps step to your workflow.
Select a connected account in Authentication.
Choose Text Search in Action and enter a query such as coffee shops in Austin, TX.
Pass coordinates or place IDs from Output into a later Get Route step.
Click Run in the step header to test the action.

Notes

This step depends on a connected Google Maps integration in your workspace.
Google Maps API quotas and billing apply to workflow actions the same as direct API usage.
OAuth may show third-party authorization branding during the connect flow.

Using Google Maps as an Agent Tool

You can also add Google Maps as a tool in the Agent Editor. Open the agent, click Add tool, and select Google Maps. In the tool settings panel, choose the connected account the agent should use. See also: Integrations, Creating and Editing, and Testing and Iteration

Getting Started

Prompts

Workflows

Hive Agents

Agents

Knowledge Bases

Experiments

Your Workspace

Monitoring

User Tracking

Resources

Configuration

Arguments form

Available actions

Output

Example

Notes

Using Google Maps as an Agent Tool

​Configuration

​Arguments form

​Available actions

​Output

​Example

​Notes

​Using Google Maps as an Agent Tool

Configuration

Arguments form

Available actions

Output

Example

Notes

Using Google Maps as an Agent Tool