===== Google Maps API ======

<WRAP lo>
**Schlagworte:** google-maps-api, kartendarstellung, tourenplanung,
einsatzplanung, datenschutz, geodaten, adm-cockpit, caats
</WRAP>

===== 🧭 Überblick =====
<WRAP info>
CAATS unterstützt die Nutzung der **Google Maps API** zur
kartengestützten Planung von Einsätzen und Touren.
</WRAP>

<WRAP>
Voraussetzung ist eine **eigene Google-Maps-Lizenz** sowie
ein gültiger **API-Schlüssel**, der in den **Mandanteneinstellungen**
des CAATS-Systems hinterlegt wird.
{{:adm:logistics:api.png?nolink&600|}}
</WRAP>

----

===== 🗺 Funktion =====
<WRAP info>
Kartendarstellung und Routenvisualisierung.
</WRAP>

^ Bereich ^ Nutzung ^
| Einsatzplanung | Anzeige von Einsätzen auf der Landkarte |
| Tourenplanung | Visualisierung & Optimierung von Fahrtrouten |
| Kartenansicht | Darstellung von Stopps und Adressen |

<WRAP lo>
Die Kartenfunktionen sind optional und nur aktiv,
wenn ein API-Schlüssel hinterlegt ist.
</WRAP>

----

===== ⚙️ Einrichtung =====
<WRAP>
Die Aktivierung erfolgt über:
</WRAP>

  * **Mandanteneinstellungen**
  * Hinterlegung des **Google Maps API-Schlüssels**

<WRAP lo>
Die Verwaltung des API-Schlüssels (Kosten, Limits, Gültigkeit)
liegt vollständig in der Verantwortung des Mandanten.
</WRAP>

----

===== ⚠️ Datenschutz & Verantwortung =====
<WRAP warning>
Bei Nutzung der Google Maps API werden **Adressdaten und Geokoordinaten**
von Klient:innen bzw. Familien an **Server von Google** übermittelt.
</WRAP>

^ Betroffen sind ^
| Klient:innenadressen |
| Liefer- und Einsatzadressen |
| Geokoordinaten für Karten & Routen |

<WRAP important>
Sie sind gegebenenfalls verpflichtet, diesen Umstand
in Ihrer **Datenschutz- bzw. Einwilligungserklärung**
gegenüber Kund:innen transparent offenzulegen.
</WRAP>

<WRAP lo>
CAATS speichert keine zusätzlichen Kartendaten –
die Verarbeitung erfolgt ausschließlich über den externen Dienst.
</WRAP>

----

<WRAP center round box 70%>
**❓ Was passiert, wenn …? (Google Maps API)**

^ Situation ^ Ursache ^ Maßnahme ^
| 🗺 Karte nicht sichtbar | Kein API-Schlüssel | Schlüssel prüfen / hinterlegen |
| 🚫 Kartenfehler | API-Limit erreicht | Google-Konto prüfen |
| 📍 Adresse nicht gefunden | Unvollständige Stammdaten | Adresse im System korrigieren |
| ⚠️ Datenschutzfrage | Externe Datenverarbeitung | Hinweis in Datenschutzerklärung aufnehmen |
</WRAP>