> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Google Maps

**Authentication:** OAuth or API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Find sushi restaurants near 1 Hacker Way with 4+ stars, open now.
* Get the driving distance and ETA from SFO to the Mountain View office.
* List coffee shops within 500m of this address.

## Available Tools

#### geocode

Convert a street address to geographic coordinates (latitude/longitude). Use components filter for disambiguation (e.g., 'country:US').

#### reverse\_geocode

Convert geographic coordinates (lat/lng) to a street address. Use result\_type to filter (e.g., 'street\_address', 'locality').

#### text\_search

Search places by text query with optional location bias, type/price/rating filters. Pagination via page\_token from page\_info. Returns up to 20 results per page.

#### nearby\_search

Search places near a lat/lng within radius. Max 20 results, no pagination. Use included\_types to filter (e.g., 'restaurant', 'cafe').

#### get\_place\_details

Get place details by ID including hours, reviews, photos, contact info. Use text\_search or nearby\_search to find place IDs.

#### autocomplete

Get place autocomplete suggestions for partial text input. Returns place IDs and display text. Use location bias for better results.

#### get\_place\_photo\_url

Get a photo URL from a photo resource name found in place details. Specify max\_width or max\_height to control size (1-4800px).

#### compute\_routes

Get directions between origin and destination. Supports place IDs, addresses, or lat/lng. Options: travel mode, waypoints, avoidance, departure time.

#### compute\_route\_matrix

Compute distance/duration matrix for multiple origins and destinations. Each location needs place\_id, address, or lat/lng.

#### get\_elevation

Get elevation in meters for one or more coordinates. Provide pipe-separated lat,lng pairs (e.g., '36.578,-118.292|36.240,-116.832').

#### get\_time\_zone

Get time zone for a latitude/longitude. Returns time zone ID, name, and UTC/DST offsets. Defaults to current time if no timestamp given.