Handbuch i-Reserve - Beispiel: Google Autosuggest zum Kundenformular hinzufügen

Voorbeeld

difficulty level:

Google Places Konfiguration für Formulare

Wo stellen Sie dies ein

Gehen Sie zu Admin > Konfigurationsformular.
Wählen Sie Entity: customer.
Öffnen Sie die Zeile des Feldes, das als Suchfeld dienen soll (meist Adresse / address1).
Setzen Sie den Feldtyp auf googleplaces.
Klicken Sie auf Erweitert und fügen Sie Parameter hinzu.
Speichern Sie und testen Sie unter front?mod=registration.

API_KEY ist erforderlich.

Verwenden Sie einen Browser-API-Key aus Google Cloud. Dieser Feldtyp läuft im Browser (JavaScript), daher ist ein Server-Key hier nicht geeignet.

Gehen Sie zur Google Cloud Console und wählen/erstellen Sie ein Projekt.
Verknüpfen Sie Billing mit dem Projekt (ohne Billing liefert Places meist keine Ergebnisse).
Aktivieren Sie mindestens diese APIs:
- Maps JavaScript API
- Places API (in einigen Projekten sichtbar als Places API (New))
Gehen Sie zu APIs & Services > Credentials und wählen Sie Create credentials > API key.
Beschränken Sie den Key:
- Application restrictions: HTTP referrers (web sites)
- API restrictions: nur die oben genannten APIs zulassen
Tragen Sie den Key als Wert des Parameters API_KEY im Formularfeld ein.

Einstellung	Empfohlener Wert	Konsequenz bei falscher Wahl
Key-Typ	Browser-Key (HTTP referrer)	Android-/iOS-/Server-Key funktioniert für diesen Web-Flow nicht richtig
Billing	Im Projekt aktiv	REQUEST_DENIED oder keine Autocomplete-Ergebnisse
Aktivierte APIs	Maps JavaScript API + Places API	Vorschläge werden nicht geladen oder Fehler in der Konsole
Application restrictions	Nur Ihre Domains (z. B. https://.i-reserve.net/, https://.ngrok.io/)	Zu streng: funktioniert in einigen Umgebungen nicht. Zu offen: Missbrauchsrisiko
API restrictions	Auf benötigte APIs beschränken	Zu streng: Autocomplete schlägt fehl. Keine Einschränkung: höheres Sicherheitsrisiko

Schlüssel	Erforderlich	Beispiel	Wirkung	Konsequenz bei falschem/fehlendem Wert
API_KEY	Ja	AIza...	Lädt die Google Places API	Keine Vorschläge oder API-Fehler in der Browser-Konsole
COUNTRY_RESTRICTION	Nein	nl oder nl,be,de	Beschränkt Ergebnisse auf Ländercode(s)	Zu streng: wenige/keine Ergebnisse. Ungültig: unerwartete Filterung
COUNTRY_CODES	Nein	nl,be	Alias von COUNTRY_RESTRICTION	Wie oben
TYPES	Nein	address	Filtert den Typ der Autocomplete-Ergebnisse	Ungültige Typen: weniger brauchbare Ergebnisse
DEBUG	Nein	1 oder true	Protokolliert den gewählten Place und die Komponenten in die Konsole	Kein funktionales Problem, jedoch zusätzliche Konsolenausgabe
LOG_SELECTION	Nein	1	Alias von DEBUG	Wie oben

Verwenden Sie die Zuordnung nur, wenn Ihre Feldnamen von den standardmäßigen customer-IDs abweichen.

Schlüssel	Beispiel	Zielfeld	Konsequenz bei falschem Wert
MAP_ADDRESS1	cust_address1	Straßenname (ohne Hausnummer)	Straße bleibt leer oder wird in ein falsches Feld geschrieben
MAP_HOUSENUM	cust_housenum	Hausnummer	Hausnummer bleibt leer
MAP_POSTAL	cust_postal	Postleitzahl	Postleitzahl fehlt oder landet im falschen Feld
MAP_CITY	cust_city	Wohnort	Wohnort bleibt leer oder erhält einen Fallback-Wert
MAP_COUNTRY	cust_country	Land-Auswahl	Land wird nicht automatisch ausgewählt

address1: route/Straßenname (ohne Hausnummer)
housenum: street_number (mit Fallback-Parsing der ersten Adresszeile)
postal: postal_code + postal_code_suffix, ohne Leerzeichen (z. B. 3543CC)
city: locality, Fallback postal_town, danach administrative Ebenen
country: Abgleich über Ländername oder ISO-Code mit den Optionen in der Land-Auswahl

Führen Sie einen Hard Refresh der Seite durch (und leeren Sie bei Bedarf den Cache).
Geben Sie eine Adresse ein und wählen Sie einen Vorschlag.
Überprüfen Sie, ob Adresse, Hausnummer, Postleitzahl, Wohnort und Land korrekt ausgefüllt werden.
Setzen Sie vorübergehend DEBUG=1, wenn Felder nicht korrekt gefüllt werden, und überprüfen Sie die Konsole auf [googleplaces] place_changed.