> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps

> Configure a workflow step that geocodes addresses, searches places, and calculates routes using a connected account

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:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Google Maps if you have not already done that.
2. Add a **Google Maps** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Text Search** in **Action** and enter a query such as `coffee shops in Austin, TX`.
5. Pass coordinates or place IDs from **Output** into a later **Get Route** step.
6. 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](../../../workspace/integrations), [Creating and Editing](../../creating-and-editing), and [Testing and Iteration](../../testing-and-iteration)