# Google Maps AI integration on Definable

> Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application.

## What this connects

Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application.

Vendor: https://www.google.com/maps

## Tools available

**19** tools available. First 12:

- `GOOGLE_MAPS_AUTOCOMPLETE` — Autocomplete Place Predictions — Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. Returns up to five predictions ordered by relevance.
- `GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX` — Compute Route Matrix — Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes. Matrix is capped at 625 elements (e.g., 25×25); chunk larger sets to avoid RESOURCE_EXHAUSTED errors. Response elements may be returned out of input order — always use originIndex and destinationIndex to map results. Only use elements where condition='ROUTE_EXISTS'; the matrix may be incomplete.
- `GOOGLE_MAPS_DISTANCE_MATRIX_API` — Distance Matrix (Legacy) — DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times. Capped at 100 elements per request (elements = origins × destinations count); split large sets into batches.
- `GOOGLE_MAPS_GEOCODE_ADDRESS` — Geocode Address — DEPRECATED: Legacy API to convert street addresses into geographic coordinates (latitude and longitude). This API works best with API key authentication. For OAuth connections without an API key, you may need to provide the 'key' parameter or use the newer 'Text Search' action instead. Use when you need to geocode an address or location to get its precise latitude/longitude coordinates.
- `GOOGLE_MAPS_GEOCODE_ADDRESS_WITH_QUERY` — Geocode Address With Query — Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify `formattedAddress`, `region`, and `addressComponents` in the response before using returned coordinates.
- `GOOGLE_MAPS_GEOCODE_DESTINATIONS` — Geocode Destinations — Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points. Use when you need comprehensive destination data for an address, place ID, or geographic coordinates.
- `GOOGLE_MAPS_GEOCODE_LOCATION` — Reverse Geocode Location — Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result.
- `GOOGLE_MAPS_GEOCODE_PLACE` — Geocode Place by ID — Tool to perform geocode lookup using a place identifier to retrieve address and coordinates. Use when you need to get detailed geographic information for a specific Google Place ID.
- `GOOGLE_MAPS_GEOCODING_API` — Geocoding API — Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication. Exactly one of `address`, `latlng`, or `place_id` must be provided per request; omitting all three or mixing incompatible combinations yields no useful results.
- `GOOGLE_MAPS_GEOLOCATE` — Geolocate Device — Tool to determine location based on cell towers and WiFi access points. Use when you need to find the geographic location of a device using network infrastructure data.
- `GOOGLE_MAPS_GET2D_TILE` — Get 2D Map Tile — Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. Use when you need to download individual map tile images for roadmap, satellite, or terrain views. Requires a valid session token from the createSession endpoint.
- `GOOGLE_MAPS_GET3D_TILES_ROOT` — Get 3D Tiles Root — Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls.

## Auth

Auth schemes: `OAUTH2`, `API_KEY`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Google Maps

Inside a Definable workflow, Google Maps is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Google Maps** — the Researcher (GPT-5.5) pulls context from Google Maps (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Google Maps** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Google Maps (create record, post message, draft email).
- **Designer / Engineer → Distributor → Google Maps** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Google Maps (attach file, open PR comment, post status).

The Verifier checks every Google Maps call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/google_maps/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt