Migration

Eine HERE-Autosuggest-Integration ablösen

Der Autosuggest-Endpunkt von HERE liefert Adress- und Ortsvorschläge, während ein Nutzer tippt, strukturiert als items-Array, in dem jeder Eintrag einen title enthält, einen resultType, der angibt, ob der Vorschlag eine vollständige Adresse, ein Ort oder eine Kategorie ist, und oft ein Hervorhebungsobjekt, das markiert, welche Zeichen mit der Eingabe übereinstimmten. Diese gemischte Typisierung der Ergebnisse, Adressen, Orte und Kategorien zusammen in einer Antwort, ist einer der markantesten Aspekte des Ansatzes von HERE und etwas, das Sie sorgfältig erfassen sollten, bevor Sie annehmen, dass die Autovervollständigung eines anderen Anbieters identisch funktioniert.

Autosuggest-Integrationen sind meist tief mit einer bestimmten Frontend-Komponente verdrahtet, einem Adressfeld mit Dropdown, und die Details der Interaktion (wie schnell Vorschläge erscheinen, wie die Hervorhebung dargestellt wird, was passiert, wenn ein Nutzer die Vorschläge ignoriert und einfach weitertippt) sind für Endnutzer meist wichtiger als jedes Implementierungsdetail im Backend. Deshalb ist die Migration teils eine Backend-Aufgabe und teils eine UX-Prüfung.

My Geocode bietet Adress-Autovervollständigung wie unter /docs/address-autocomplete/ dokumentiert, mit eigener Anfrage- und Antwortstruktur. Da das Mischen und Ranking von Ergebnissen wirklich spezifisch für die Implementierung jedes Anbieters ist, lohnt es sich, diesen Endpunkt direkt mit repräsentativen Suchanfragen Ihrer eigenen Nutzer zu testen, statt anzunehmen, dass die gemischte Ergebnisstruktur von HERE unverändert übernommen wird. Verschiedene Anbieter ziehen die Grenze zwischen einem Adressvorschlag und einem Ort unterschiedlich.

Schritte, die sich bei dieser Art von Migration meist bewähren:

  • Erfassen Sie die konkreten resultType-Werte, nach denen Ihr Frontend-Code derzeit verzweigt, da diese Verzweigungslogik am ehesten angepasst werden muss
  • Überprüfen Sie das Hervorhebungsverhalten bzw. die Darstellung übereinstimmender Teilstrings in Ihrer Oberfläche und prüfen Sie, ob der neue Endpunkt eine Entsprechung bietet oder ob dieses UI-Detail überarbeitet werden muss
  • Testen Sie den neuen Endpunkt mit einer Stichprobe echter historischer Suchanfragen aus Ihren Logs, nicht mit synthetischen Testadressen, denn echte Tippmuster von Nutzern (Tippfehler, unvollständige Wörter, Abkürzungen) decken Unterschiede im Ranking auf, die saubere Testdaten nicht zeigen

Die Authentifizierung verwendet einen Schlüssel, der als X-API-Key, per Authorization: Bearer, HTTP Basic Auth oder als Query-Parameter gesendet wird. Die Preise: 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, 2.500 weitere kostenlos pro Schlüssel und Tag, gezählt pro Netzwerk, danach Prepaid-Guthaben zu 0,0001 € pro Anfrage oder ein Unlimited-Schlüssel zu 50 € pro Monat, zum selben Tarif für jeden Endpunkt der Plattform.

Da Autosuggest im Vergleich zu einem typischen Geokodierungsaufruf sehr häufig ausgelöst wird, weil nahezu jeder Tastendruck eine Anfrage erzeugen kann, lohnt es sich, das Volumen vor einem vollständigen Start mit Ihrem kostenlosen Tageskontingent und dem Preis pro Anfrage abzugleichen, statt das tatsächliche Nutzungsmuster erst im Live-Betrieb zu entdecken.