Zum Inhalt

Autocomplete

Willkommen zur Dokumentation der SmartMaps Autocomplete API. Diese leistungsstarke Funktion ermöglicht dynamische Adress- und Standortvorschläge während der Eingabe und verbessert so die Benutzererfahrung und die Genauigkeit der Ergebnisse.

Für eine einfachere Integration bietet SmartMaps vorgefertigte Bibliotheken sowohl im UMD- als auch im ESM-Format. Weitere Informationen zur Verwendung dieser Bibliotheken finden Sie im Abschnitt Library-Dokumentation.

Einführung

SmartMaps Autocomplete wurde entwickelt, um Benutzer bei der Eingabe von Adressen und Suchbegriffen zu unterstützen, indem intelligente Vorschläge auf Basis der eingegebenen Zeichen bereitgestellt werden. Während der Eingabe erzeugt die Autocomplete-Funktion in Echtzeit eine Liste passender Vorschläge, sodass die gewünschte Adresse oder der gewünschte Standort schnell und einfach ausgewählt werden kann.

Hauptfunktionen

Intelligente Vorschläge

SmartMaps Autocomplete nutzt eine umfangreiche Datenbank mit Adressen und Standorten, um präzise und relevante Vorschläge zu liefern. Während der Eingabe werden die Vorschläge dynamisch aktualisiert, sodass Benutzer schnell die gesuchte Adresse oder den gesuchten Standort finden können.

Anpassbare Parameter

Die Autocomplete-Funktionalität kann über verschiedene anpassbare Parameter auf spezifische Anwendungsfälle zugeschnitten werden. Mit diesen Parametern können Sie:

  • Ergebnisse basierend auf Nähe oder einer Bounding Box boosten
  • Ergebnisse auf einen bestimmten geografischen Bereich oder Radius filtern
  • Vorschläge auf bestimmte Länder, Regionen oder Adresstypen (z. B. Points-of-Interest) beschränken

Nahtlose Integration

Die Integration von SmartMaps Autocomplete in Ihre bestehenden Anwendungen ist denkbar einfach. Mit dem bereitgestellten API-Key können Sie die Autocomplete-Funktion problemlos in Ihre Webseiten und Apps einbinden und so die Benutzererfahrung verbessern sowie die Adresseingabe optimieren.

Erste Schritte

Um mit SmartMaps Autocomplete zu starten, gehen Sie wie folgt vor:

  1. Registrieren Sie sich für ein SmartMaps-Konto und besorgen Sie sich Ihren SmartMaps API-Key.
  2. Fordern Sie ein Authentifizierungstoken an, indem Sie Ihren API-Key verwenden — die Autocomplete API benötigt ein Bearer-Token, nicht den API-Key direkt. Siehe Token API für Details.
  3. Binden Sie die SmartMaps-Autocomplete-Bibliothek in Ihre Webseite oder Anwendung ein.
  4. Initialisieren Sie die Autocomplete-Komponente mit den gewünschten Einstellungen und Optionen.
  5. Verarbeiten Sie die ausgewählte Adresse bzw. den ausgewählten Standort in Ihrer Anwendungslogik.

Nutzen Sie stattdessen die Library

Wenn Sie Token-Anfragen nicht manuell verwalten möchten, verwenden Sie die SmartMaps Autocomplete Library. Sie übernimmt die Authentifizierung automatisch — geben Sie einfach Ihren API-Key an.

API-Referenz

Die SmartMaps Autocomplete API stellt Endpunkte für die Durchführung von Autocomplete-Suchen auf geografischen Daten bereit. Sie ermöglicht die Suche nach Städten, Straßen, Points of Interest und anderen räumlichen Entitäten.

Endpunkte

  • GET /api/v5/Autocomplete: Führt eine Autocomplete-Suche basierend auf der angegebenen Abfragezeichenfolge und optionalen Parametern durch.

Eine vollständige Liste der verfügbaren Endpunkte, Anfrageparameter und Antwortformate finden Sie in der API-Referenz.