Was macht es?

Die Adressautovervollständigung für Gravity Forms hilft Nutzern, genaue Adressen schneller einzugeben, indem sie während der Eingabe Google-basierte Vorschläge anzeigt. Funktioniert mit beiden Adresse und Einzeiliger Text Felder.

Wenn ein Benutzer einen Vorschlag auswählt, kann das Plugin auch nützliche Standortmetadaten (wie Place-ID und Koordinaten) erfassen und wichtige Adressteile zuordnen – oder sogar eine PLZ-Suche (Postleitzahl) durchführen –, um dedizierte Felder (einschließlich versteckter) für Routing, Automatisierung oder Berichterstellung zu füllen.

Funktionen

Schnellere Adresseingabe
Benutzer erhalten während der Eingabe Google-basierte Vorschläge, wodurch Tastenanschläge reduziert und Übermittlungen beschleunigt werden.
Funktioniert mit Adress- und einzeiligen Textfeldern
Aktivieren Sie die Autovervollständigung für beide Feldtypen, sodass Sie Ihre bestehenden Formularlayouts behalten können.
Zuordnung der analysierten Felder
Senden Sie Adresszeile 1, Zeile 2, Stadt/Ort, Bundesland/Region, Postleitzahl und Land in ein beliebiges ausgewähltes Feld desselben Formulars, einschließlich versteckter Felder.
International freundliche Adressverwaltung
Unterstützt globale Adressen und verwendet in den Einstellungen für Teams außerhalb der USA länderunabhängige Bezeichnungen.
Ergebnisse nach Land einschränken
Beschränken Sie die Vorschläge auf bestimmte Länder unter Verwendung von ISO-Codes (z. B. US, CA, GB).
Mit jedem Eintrag gespeicherte Metadaten
Speichert die Place-ID, den Breitengrad, den Längengrad und die formatierte Adresse für Integrationen, Automatisierung und Fehlerbehebung.
WordPress Multisite-kompatibel
Aktivieren Sie die Netzwerkfunktion einmalig, um sie auf allen Ihren Unterseiten zu nutzen. (Der Netzwerkmodus ist in den „Unlimited“-Tarifen verfügbar.)
Übersetzung bereit
Vollständig kompatibel mit dem von Ihnen gewählten Übersetzungs-Plugin. (Vorübersetzungen sind nicht enthalten, aber demnächst verfügbar)
Postleitzahlensuche
Wandeln Sie ein einzelnes Feld in eine Postleitzahlensuche um, die Ihre Felder für Stadt und Bundesland/Region (einschließlich versteckter) automatisch ausfüllt – ideal für “Prüfen Sie Ihr Gebiet”-Formulare und CRM-Routing.

Zu den Funktionsdetails springen

Wie aktiviere ich das Plugin?

Nach dem Kauf von „Address Autocomplete for Gravity Forms“ müssen Sie Folgendes tun:

Installieren Sie das Plugin auf Ihrer WordPress-Website.
Generieren Sie Ihren Google API-Schlüssel und geben Sie ihn ein.
Automatische Vervollständigung für eine Adresse aktivieren oder Einzeiliges Textfeld.

Die folgenden Anweisungen zeigen Ihnen, wie Sie Ihr Plugin installieren, einen Google API-Schlüssel für die Adressvervollständigung generieren und diesen für ein Adressfeld oder ein einzeiliges Textfeld aktivieren.

Registrieren Sie das Plugin mit Plugin Brewery

Generieren und geben Sie einen Google API-Schlüssel ein.

Bevor Sie die Adress-Autovervollständigung nutzen können, müssen Sie in der Google Cloud Platform-Konsole einen API-Schlüssel generieren.

Aktivieren Sie die Adressfelder

Aktivieren Sie die Aktivierung für einzeilige Textfelder

Generieren eines Google API-Schlüssels

Erstellen oder ein vorhandenes Google Cloud-Projekt auswählen

Bevor Sie Ihren Google API-Schlüssel erhalten können, müssen Sie einen neuen erstellen Google Cloud Platform-Projekt (oder wählen Sie ein bereits vorhandenes aus, falls Sie eines haben).

Hinweis: Wenn Sie ein neues GCP-Projekt erstellen, empfehlen wir Ihnen, es auf die Website zu beschränken, an der Sie arbeiten, falls Sie weitere Google API-Dienste für dieselbe Website benötigen.

Erforderliche APIs aktivieren

Nachdem Sie ein Google Cloud-Projekt erstellt oder ausgewählt haben, navigieren Sie zu APIs & Dienste > API-Bibliothek und aktivieren Sie die folgenden APIs:

Hinweis: Google verlangt, dass ein Abrechnungskonto mit Ihrem Projekt verknüpft wird, bevor die Places API aktiviert werden kann. Für die meisten Websites fällt die Nutzung unter das kostenlose Kontingent von Google, eine Zahlungsmethode ist jedoch dennoch erforderlich.

Orte-API (Neu)

Schnelllink

Möglicherweise bemerken Sie die Bezeichnungen “Places API” und “Places API (New)” – Unser Plugin ist so konzipiert, dass es mit “Places API (New)” kompatibel ist.”

Maps Javascript API

Schnelllink

Schlüssel generieren

Nachdem Sie nun beide APIs in Ihrem Projekt aktiviert haben, können Sie Ihren API-Schlüssel generieren.

Gehe zu APIs & Dienste > Anmeldeinformationen, Klicken Sie anschließend auf “+ Anmeldeinformationen erstellen” und schließlich auf “API-Schlüssel”.”

Es öffnet sich ein seitliches Dialogfenster, in dem Sie Ihrem Schlüssel einen Namen geben können.

An dieser Stelle könnten Sie nach unten scrollen und auf “Erstellen” klicken, woraufhin Ihr Schlüssel sofort generiert wird. ABER… Sie sollten im nächsten Schritt eine Einschränkung festlegen, um eine unbefugte Nutzung Ihres Schlüssels zu verhindern.

Hinweis: Dies ist sehr wichtig! Die Schlüssel sind einsehbar, damit niemand Ihre kostenlose Nutzung missbraucht.

Scrollen Sie im Dialogfenster weiter zu “Anwendungseinschränkungen”.

Wählen Sie unter “Anwendungseinschränkungen” die Option “Websites” aus.”

Fügen Sie unter “Website-Beschränkungen” die Websites hinzu, auf denen der API-Schlüssel verwendet werden soll. Fügen Sie kein https hinzu.

Wir empfehlen, eine Wildcard-Domain hinzuzufügen, um sicherzustellen, dass der Schlüssel sowohl auf www- als auch auf Nicht-www-Domains funktioniert, etwa so: *.example-website.com/*

Klicken Sie auf „Erstellen“, und Ihr Schlüssel wird anschließend angezeigt.

Ihr API-Schlüssel wurde nun erstellt! Kopieren Sie ihn und fügen Sie ihn in die Einstellungen für die Adressvervollständigung des Plugins ein – fertig!

Domänenformatierung: Geben Sie jede Domain in einer eigenen Zeile im folgenden Format ein: example.com/* - NEIN https://, kein abschließender Schrägstrich in der Domain selbst, aber enthalten /* Am Ende, um alle Seiten zuzulassen. Um alle Subdomains abzudecken (wie www), fügen Sie einen separaten Eintrag hinzu als *.example.com/*. Für die lokale Entwicklung verwenden localhost oder localhost:3000/* abhängig von Ihrer Konfiguration.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

Googles Nutzungsbedingungen und Datenschutzrichtlinie

Die Adress-Autovervollständigung von Plugin Brewery sendet Formulardaten an Google-Dienste, um Adresssuchen zu ermöglichen. Gemäß den Google-Richtlinien sollte jede Anwendung, die die Places API verwendet, einen Link zu Googles Adress-Autovervollständigung anzeigen. Nutzungsbedingungen und Datenschutzrichtlinie.

Je nach Land oder Region sind Sie möglicherweise auch verpflichtet, vor der Erfassung von Standortdaten die Zustimmung der Nutzer einzuholen.

Funktionsdetails

Unterstützte Feldtypen

Funktioniert mit beiden Feldtypen von Gravity Forms:

Adressfeld (Mehrfacheingabe)
Einzeiliger Text (einzeilige Adresseingabe)

Verwenden Sie Adressfelder, wenn Sie native GF-Adressunterfelder benötigen, oder einzeiligen Text, wenn Sie ein einfacheres Formularlayout wünschen.

Geparste Adresszuordnung (Neu)

Ordnen Sie ausgewählte Adressbestandteile den entsprechenden Feldern in Ihrem Formular zu:

Adresszeile 1
Adresszeile 2
Postleitzahl / Postleitzahl
Stadt / Ort
Staat / Provinz / Region
Land

Ideal für versteckte Felder, die bei Lieferzonenprüfungen, CRM-Routing, bedingten Benachrichtigungen und Automatisierungen verwendet werden.

Postleitzahlensuche (Neu)

Verwandeln Sie ein einzeiliges Textfeld in eine Postleitzahlensuche. Aktivieren Sie die Adress-Autovervollständigung und anschließend die Postleitzahlensuche in den erweiterten Einstellungen des Felds.

Die Vorschläge beschränken sich auf Postleitzahlen.
Das Feld speichert nur den ausgewählten Code (nicht die vollständige Adresse).
Stadt, Bundesland/Region (und Land/Landkreis, falls kartiert) werden automatisch ausgefüllt, auch in versteckte Felder.
Funktioniert für jedes Land mit Postleitzahlen

Ideal für Servicegebietsprüfungen, Versandlogik und das Senden sauberer Standortdaten an Ihr CRM-System.

Einzeiliger Text Post-/Postleitzahlenbearbeitung

Bei einzeiligen Textfeldern verwendet das Plugin die von Google formatierte Adresse und fügt die Postleitzahl hinzu, sofern diese verfügbar, aber im angezeigten Text nicht enthalten ist. Wenn Google keine Postleitzahl für ein Suchergebnis liefert, kann keine hinzugefügt werden.

Metadaten im Eintrag gespeichert

Wenn Benutzer einen Vorschlag auswählen, speichert das Plugin Folgendes:

Orts-ID
Breite
Länge
Formatierte Adresse

Länderbeschränkungen + Internationale Unterstützung

Sie können die Vorschläge auf bestimmte Länder mit ISO-Alpha-2-Codes beschränken (zum Beispiel: US,CA,GB), oder für globale Formulare uneingeschränkt lassen.

Die Beschriftungen und Kartierungsoptionen sind länderneutral, sodass die Arbeitsabläufe für Teams in den USA und außerhalb der USA übersichtlich bleiben.

Leistung + Kompatibilität

Konzipiert für reale Produktionsstandorte:

Frontend-Skripte werden nur dort initialisiert, wo aktivierte Felder vorhanden sind.
Funktioniert mit Standard- und AJAX-basierten Gravity Forms-Abläufen.
Kompatibel mit gängigen Caching-/CDN-Setups in den meisten Konfigurationen

Tags zusammenführen

Wählt ein Besucher einen Autocomplete-Vorschlag aus, kann das Plugin Metadaten zu diesem Eintrag speichern. Diese Daten lassen sich in Bestätigungen, Benachrichtigungen und anderen Bereichen einfügen, die Gravity Forms-Merge-Tags unterstützen.

Format: {pb_aac:ID:KEY}

Ersetzen Sie ID durch die Feld-ID des Adress- oder Einzeilen-Textfelds, bei dem die Adress-Autovervollständigung aktiviert ist (dasselbe Feld, in dem Vorschläge angezeigt werden).

Verfügbare Schlüssel (KEY):

SCHLÜSSEL	Was es ausgibt
`place_id`	Google Place ID
`lat`	Breite
`lng`	Länge
`formatted`	Formatierte Adresse (Googles formatierte Zeichenfolge)
`google_maps_url`	Eine Google Maps-Such-URL, die aus der Orts-ID (oder den Breiten- und Längengraden, falls die Orts-ID fehlt) erstellt wurde.

Beispiele (wenn Ihr Autocomplete-Feld Feld 12 ist):

{pb_aac:12:place_id}
{pb_aac:12:lat}
{pb_aac:12:lng}
{pb_aac:12:formatted}
{pb_aac:12:google_maps_url}

Picker: Im Formulareditor erhalten aktivierte Felder diese Tags auch im Merge-Tag-Picker unter Bezeichnungen wie “Adress-Autocomplete: …”.

Notiz: Werte existieren nur für Einträge, bei denen ein Vorschlag ausgewählt und die Metadaten gespeichert wurden; andernfalls ist das Tag leer (systembedingt).

FAQs

Ist die Google Places API kostenlos?

Google schreibt Ihrem Konto automatisch monatlich ein Guthaben von $200 gut, über das Ihre Nutzung der Places API abgerechnet wird. Für die meisten Websites deckt dies alle Kosten ab – bei den aktuellen Preisen fallen etwa 10.000 Autocomplete-Sitzungen pro Monat unter dieses Guthaben.

Allerdings können sich die Preise ändern, daher sollten Sie die Preise überprüfen. Preistabelle der Google Maps-Plattform für die aktuellsten Zahlen.

Kann ich es mit dem Feld “Einzeiliger Text” verwenden?

Ja! Zusätzlich zum Standard-Adressfeld können Sie die Autovervollständigung für jedes einzeilige Textfeld aktivieren. Ideal für Formulare, die nur eine einzige Adresseingabe erfordern.

Funktioniert es auch für internationale Adressen?

Absolut. Das Plugin unterstützt globale Adressdaten von Google.

Ist die Einrichtung kompliziert?

Überhaupt nicht. Fügen Sie einfach Ihren Google API-Schlüssel in den Plugin-Einstellungen hinzu, aktivieren Sie die Autovervollständigung für die gewünschten Felder, und schon sind Sie fertig. So einfach ist das.

Kann ich die Ergebnisse auf bestimmte Länder beschränken?

Ja. Geben Sie in den Feldeinstellungen eine durch Kommas getrennte Liste von ISO 3166-1 Alpha-2-Ländercodes an (z. B., US,CA,GB).

Welche Places API muss ich in Google Cloud aktivieren?

Aktivieren Sie “Places API (New)”, da die ältere “Places API” und die “Maps JavaScript API” eingestellt werden sollen.

Kann ich Adressmetadaten in Benachrichtigungen oder Integrationen verwenden?

Ja. Die Adressvervollständigung fügt Platzhalter für Orts-ID, Breitengrad, Längengrad, formatierte Adresse und eine Google Maps-URL hinzu. Verwenden Sie den Platzhalter-Auswahldialog von Gravity Forms in Benachrichtigungen, Bestätigungen oder Feed-Zuordnungen.

Können Entwickler die von Google zurückgegebenen Daten anpassen?

Ja. Verwenden Sie die pb_aac_request JavaScript-Filter zur Anpassung der Anfrage – beispielsweise zur Fokussierung der Ergebnisse auf eine Region, zum Hinzufügen eines Begrenzungsrahmens oder zur Erweiterung auf Unternehmen.

Kann ich ein Feld zur Postleitzahlensuche verwenden?

Ja. Aktivieren Sie in einem einzeiligen Textfeld die Adressvervollständigung und anschließend die Postleitzahlensuche. Das Feld zeigt Postleitzahlvorschläge an. Durch Auswahl eines Vorschlags werden die Felder für Stadt und Bundesland/Region (auch ausgeblendete) automatisch ausgefüllt. Ideal für Formulare zur Standortabfrage und CRM-Routing.