Google Maps
Wie Sie einen Google-Maps-Schlüssel verbinden, damit die App beim Tippen Adressen vorschlägt und den Standort (Breiten- und Längengrad) jeder Adresse speichert.
Maps versorgt das Adressfeld in den Formularen der App und den Standort der Datensätze mit Adresse. Ohne den Schlüssel geht nichts kaputt, aber alles wird einfacher: Das Adressfeld wird zu einem gewöhnlichen Textfeld ohne Vorschläge, und der Datensatz speichert nur den Adresstext, ohne Breiten- und Längengrad. Funktionen, die vom Standort abhängen, etwa Entfernung oder Liefergebiet, bleiben ohne die Daten, die sie brauchen.
Bevor Sie anfangen
- Tarif: jeder, auch der Free. Nötig ist nur Ihr eigener Google-Schlüssel;
- Google-Cloud-Konto mit aktiver Abrechnung. Google verlangt eine hinterlegte Karte, selbst für die Nutzung innerhalb des kostenlosen Kontingents, und ohne Abrechnung wird der Schlüssel abgelehnt;
- Kosten: Die Nutzung rechnet Google über Ihr Konto ab, nach der Maps-Preisliste. Die Plattform berechnet für Adresssuchen keine Integrations-Credits.
Schritt für Schritt
- legen Sie in console.cloud.google.com ein Projekt an (oder wählen Sie ein vorhandenes);
- aktivieren Sie in diesem Projekt die Abrechnung;
- aktivieren Sie unter APIs & Dienste → Bibliothek zwei APIs:
- Geocoding API;
- Places API (New). Achten Sie auf das „(New)“: Die alte Version taugt nicht, und Google bietet sie neuen Kunden seit März 2025 nicht mehr an;
- legen Sie unter APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → API-Schlüssel den Schlüssel an und kopieren Sie ihn (er beginnt mit
AIza); - begrenzen Sie beim Schlüssel unter API-Einschränkungen die Nutzung auf die beiden APIs aus Schritt 3;
- öffnen Sie im Editor der App, Tab Integrationen, Kategorie Standort, die Karte Google Maps;
- fügen Sie den Schlüssel in das Feld API Key ein und klicken Sie auf Speichern und aktivieren.
Beschränken Sie den Schlüssel nicht nach Website
Es ist üblich, einen Maps-Schlüssel auf die Domain der App zu beschränken (Einschränkung nach „Websites“ oder „HTTP-Referrern“). Hier macht das die Integration kaputt. Der Schlüssel gelangt nie in den Browser der Menschen, die die App nutzen: Google rufen die Server von Fabapp auf, und diese Aufrufe tragen nicht die Adresse Ihrer Website. Ein nach Website beschränkter Schlüssel wird bei allen abgelehnt.
Der richtige Schutz ist der aus Schritt 5, die Beschränkung darauf, welche APIs der Schlüssel nutzen darf. Da der Schlüssel verschlüsselt auf dem Server liegt, erscheint er nicht im Code der App, wo ihn jemand kopieren könnte.
Woran Sie erkennen, dass es funktioniert
- beim Speichern führt die Plattform eine Testsuche nach einer echten Adresse durch. Akzeptiert Google, erscheint „Google Maps ist aktiv.“ und die Karte steht auf Verbunden;
- tippen Sie in der App eine Adresse in ein Formular: Die Vorschläge sollten beim Tippen erscheinen.
Die Adresssuche funktioniert nur für Menschen, die in der App angemeldet sind. Das ist Absicht: Jede Suche verbraucht das Kontingent Ihres Google-Projekts, und sie anonymen Besuchern offen zu lassen wäre eine Einladung zum Missbrauch.
Häufige Probleme
Der Test der Karte zeigt die Antwort von Google selbst, und der Code in Klammern nennt die Ursache:
| Die Karte sagt | Was zu tun ist |
|---|---|
| REQUEST_DENIED | prüfen Sie, ob die Geocoding API aktiviert ist und das Projekt eine aktive Abrechnung hat |
| OVER_DAILY_LIMIT | fast immer die Abrechnung: Das Rechnungskonto muss aktiv sein und eine gültige Zahlungsmethode haben |
| OVER_QUERY_LIMIT | das Kontingent des Schlüssels ist erschöpft: Warten Sie, bis es sich erneuert, oder erhöhen Sie das Limit im Projekt |
- Ich habe den Schlüssel gerade angelegt und er wird abgelehnt. Ein neuer Schlüssel braucht einige Minuten, bis er gilt. Warten Sie und speichern Sie erneut;
- Die Karte steht auf Verbunden, aber es erscheinen keine Vorschläge. Der Test der Karte nutzt nur die Geocoding API. Die Vorschläge nutzen die Places API (New): Prüfen Sie, ob sie im selben Projekt aktiviert ist und ob Sie nicht die alte Version aktiviert haben;
- Es hat eine Weile funktioniert und dann aufgehört. Prüfen Sie, ob die Abrechnung des Google-Projekts noch aktiv ist und ob der Schlüssel nicht eine Website-Einschränkung bekommen hat.