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

# Google Maps

> Connect Google Maps to Langdock to search places, geocode addresses, and get directions from your conversations

## Overview

Google Maps provides location services including place search, geocoding, and directions. Once connected, you can use Langdock to find places, convert addresses to coordinates, and compute routes directly from your conversations.

<Info>
  **Authentication:** API Key
  **Category:** Location & Maps
  **Availability:** All workspace plans
</Info>

## Prerequisites

* A Google Cloud project with billing enabled
* The following APIs enabled in your project:
  * Places API
  * Geocoding API
  * Directions API
  * Distance Matrix API

## Setup

<Steps>
  <Step title="Enable the required APIs and create an API key">
    Follow [Google's guide to getting an API key](https://developers.google.com/maps/documentation/javascript/get-api-key) to enable the required APIs (Places, Geocoding, Directions, Distance Matrix) and create a key in Google Cloud Console.
  </Step>

  <Step title="Restrict the API key (recommended)">
    In the API key settings, restrict it to the four APIs listed above to limit its scope.
  </Step>

  <Step title="Navigate to Integrations in Langdock">
    Go to [Integrations](https://app.langdock.com/integrations) and find **Google Maps** in the list.
  </Step>

  <Step title="Enter your API key">
    Paste the API key and save.
  </Step>

  <Step title="Start using Google Maps in Langdock">
    Tag the integration with `@` in any agent to search places, geocode addresses, or get directions.
  </Step>
</Steps>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Place Search" icon="location-dot">
    Find businesses, restaurants, or points of interest near a location using natural language
  </Card>

  <Card title="Geocoding" icon="map-pin">
    Convert street addresses to coordinates or coordinates back to readable addresses
  </Card>

  <Card title="Directions" icon="route">
    Get routes between locations with support for driving, walking, cycling, and transit
  </Card>

  <Card title="Distance Matrix" icon="arrows-left-right">
    Calculate travel time and distance between multiple origins and destinations
  </Card>
</CardGroup>

## Troubleshooting

| Issue               | Solution                                                                            |
| ------------------- | ----------------------------------------------------------------------------------- |
| **API key invalid** | Verify the key is correct and the required APIs are enabled in Google Cloud Console |
| **Request denied**  | Check that billing is enabled on your Google Cloud project                          |
| **API not enabled** | Go to Google Cloud Console → APIs & Services → Library and enable the missing API   |
| **Quota exceeded**  | Review your usage limits in Google Cloud Console and increase if needed             |