Migration

Eine Google-Places-Autocomplete-Integration ablösen

Autocomplete ist eine andere Art von Integration als ein einzelner Geokodierungsaufruf. Es wird bei nahezu jedem Tastendruck in einem Adressfeld ausgelöst, hängt bei manchen Anbietern von sitzungsbasierter Preisgestaltung oder Gruppierung ab, und die Antwort muss so schnell zurückkommen, dass eine Verzögerung für die tippende Person nicht spürbar wird. Die Migration dieses Teils birgt mehr UX-Risiko als ein Batch-Geokodierungsjob, gerade weil Nutzer direkt und in Echtzeit damit interagieren.

Google Places Autocomplete liefert eine Liste von Vorhersagen, jede mit einem description-String und einer place_id, die in einem anschließenden Details-Aufruf verwendet wird, um die vollständige Adresse und die Koordinaten abzurufen. Dieses zweistufige Muster, zuerst Vorhersagen, dann Details, ist ein bestimmtes Interaktionsmodell, das viel Frontend-Code prägt, der darauf aufbaut, einschließlich des Debounce-Timings und der Art, wie ausgewählte Ergebnisse angezeigt werden, bevor der Details-Aufruf abgeschlossen ist.

Hier kommt es darauf an, die Fähigkeiten ehrlich zu beschreiben. My Geocode bietet Adress-Autovervollständigung als Teil seiner Abfrage-Endpunkte, mit Anfrage und Antwort wie unter /docs/address-autocomplete/ dokumentiert. Das konkrete Verhalten eines Autocomplete-Endpunkts, einschließlich Sitzungsgruppierung und Ergebnisranking, sollten Sie jedoch direkt mit Ihren eigenen Adressdaten und Nutzungsmustern testen, statt eine Eins-zu-eins-Entsprechung zum zweistufigen Modell von Google vorauszusetzen. Verschiedene Anbieter strukturieren den Ablauf vom Vorschlag zum Detail unterschiedlich, und dieser strukturelle Unterschied ist hier meist die größte eigentliche Migrationsaufgabe, mehr als jeder einzelne Feldname.

Praktische Schritte für diese Migration:

  • Klären Sie, ob Ihre aktuelle Implementierung das zweistufige Muster aus Vorhersagen und anschließenden Details braucht oder ob ein Vorschlags-Endpunkt mit einem einzigen Aufruf Ihren Frontend-Code tatsächlich vereinfachen würde
  • Testen Sie Debounce- und Mindestzeichenzahl-Einstellungen mit den echten Antwortzeiten des neuen Endpunkts unter Ihren eigenen Netzwerkbedingungen, statt Werte wiederzuverwenden, die auf die Infrastruktur von Google abgestimmt waren
  • Prüfen Sie, wie Ihre Oberfläche mit einer Vorhersageliste umgeht, die leer oder mit nur einem Ergebnis zurückkommt, da sich das Ranking zwischen Anbietern deutlich unterscheidet und Ihre Fallback-UX nicht davon abhängen sollte, mehrere Vorschläge zu erhalten

Die Authentifizierung für den neuen Endpunkt funktioniert mit einem Schlüssel als X-API-Key-Header, per Authorization: Bearer, HTTP Basic Auth oder als Query-Parameter. Es gibt 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel und 2.500 weitere kostenlos pro Schlüssel und Tag, gezählt pro Netzwerk. Darüber hinaus gibt es Prepaid-Guthaben zu 0,0001 € pro Anfrage oder einen Unlimited-Schlüssel zu 50 € pro Monat, zum selben Tarif wie jeder andere Endpunkt.

Da Autocomplete-Aufrufe im Verhältnis zu eigentlichen Geokodierungsaufrufen ein hohes Volumen erreichen können, weil die meisten Tastendrücke eine Anfrage erzeugen, lohnt es sich, das erwartete Tagesvolumen mit dem kostenlosen Kontingent und dem Preis pro Anfrage abzugleichen, bevor Sie sich auf einen Starttermin festlegen. So erleben Sie in der ersten Woche mit Live-Traffic keine Überraschungen.