> ## 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

> Verbinde Google Maps mit Langdock, um Orte zu suchen, Adressen zu geocodieren und Routen direkt aus deinen Conversations abzurufen

## Überblick

Google Maps bietet Standortdienste wie Ortssuche, Geocodierung und Routenplanung. Nach der Verbindung kannst du über Langdock Orte finden, Adressen in Koordinaten umwandeln und Routen direkt aus deinen Conversations heraus berechnen.

<Info>
  **Authentifizierung:** API Key
  **Kategorie:** Standort & Karten
  **Verfügbarkeit:** Alle Workspace-Pläne
</Info>

## Voraussetzungen

* Ein Google Cloud-Projekt mit aktivierter Abrechnung
* Folgende APIs müssen im Projekt aktiviert sein:
  * Places API
  * Geocoding API
  * Directions API
  * Distance Matrix API

## Einrichtung

<Steps>
  <Step title="Erforderliche APIs aktivieren und API Key erstellen">
    Folge [Googles Anleitung zum Erstellen eines API Keys](https://developers.google.com/maps/documentation/javascript/get-api-key), um die erforderlichen APIs (Places, Geocoding, Directions, Distance Matrix) zu aktivieren und einen Key in der Google Cloud Console zu erstellen.
  </Step>

  <Step title="API Key einschränken (empfohlen)">
    Schränke den Key in den Einstellungen auf die vier oben genannten APIs ein, um seinen Geltungsbereich zu begrenzen.
  </Step>

  <Step title="Zu Integrationen in Langdock navigieren">
    Geh zu [Integrationen](https://app.langdock.com/integrations) und suche **Google Maps** in der Liste.
  </Step>

  <Step title="API Key eingeben">
    Füge den API Key ein und speichere.
  </Step>

  <Step title="Google Maps in Langdock verwenden">
    Tagge die Integration mit `@` in einem beliebigen Agenten, um Orte zu suchen, Adressen zu geocodieren oder Routen abzurufen.
  </Step>
</Steps>

## Häufige Anwendungsfälle

<CardGroup cols={2}>
  <Card title="Ortssuche" icon="location-dot">
    Unternehmen, Restaurants oder Sehenswürdigkeiten in der Nähe eines Standorts per natürlicher Sprache finden
  </Card>

  <Card title="Geocodierung" icon="map-pin">
    Adressen in Koordinaten umwandeln oder Koordinaten in lesbare Adressen zurückwandeln
  </Card>

  <Card title="Routenplanung" icon="route">
    Routen zwischen Standorten mit Unterstützung für Auto, Fußgänger, Fahrrad und ÖPNV abrufen
  </Card>

  <Card title="Entfernungsmatrix" icon="arrows-left-right">
    Reisezeit und Entfernung zwischen mehreren Ausgangs- und Zielpunkten berechnen
  </Card>
</CardGroup>

## Fehlerbehebung

| Problem                      | Lösung                                                                                                   |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Ungültiger API Key**       | Überprüfe, ob der Key korrekt ist und die erforderlichen APIs in der Google Cloud Console aktiviert sind |
| **Anfrage abgelehnt**        | Stelle sicher, dass die Abrechnung für dein Google Cloud-Projekt aktiviert ist                           |
| **API nicht aktiviert**      | Geh zur Google Cloud Console → APIs & Dienste → Bibliothek und aktiviere die fehlende API                |
| **Kontingent überschritten** | Überprüfe deine Nutzungslimits in der Google Cloud Console und erhöhe sie bei Bedarf                     |
