Automatisch vervollständigen - Amazon Location Service
AnwendungsfälleVerstehen Sie die AnfrageVerstehen Sie die Antwort

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Automatisch vervollständigen

Autocompletegibt vollständige Adressen und Adressbestandteile auf der Grundlage teilweiser Eingaben zurück. Zu den wichtigsten Anwendungsfällen gehören das automatische Ausfüllen von Adressformularen und die Adressvervollständigung mit Texteingabe (interaktives Ausfüllen der Adresse, während der Endbenutzer sie eingibt).

Anmerkung

Standardmäßig werden für jedes Ergebnis nur die Orts-ID, der Ortstyp und die Labelattribute zurückgegeben. Umfangreiche zusätzliche Details, einschließlich der vollständigen Adressaufschlüsselung und der Eingabehervorhebungsbereiche für interaktive Anwendungsfälle, erhalten Sie, indem Sie das AdditionalFeatures Eingabeattribut festlegen. Beachten Sie jedoch, dass das Anfordern zusätzlicher Funktionen Auswirkungen haben kann Preise für Orte

Anmerkung

Japanische Adressen werden nicht unterstützt.

Bei den Ergebnissen handelt es sich immer um Adressen oder Adresskomponenten wie Straßen, Postleitzahlen und Länder. Sonderziele werden niemals zurückgegeben. Die Ergebnisse beinhalten keine Geocodes, da der Schwerpunkt auf der Adressvervollständigung und nicht auf der Geokodierung Autocomplete liegt. Verwenden Sie den Vorgang Geocode, um Koordinaten für die Geokodierung von Adressen abzurufen. Die Ergebnisse können nach geografischem Gebiet gefiltert werden. Sie können auch nach Ortstyp gefiltert werden, um beispielsweise nur Orte oder nur Postleitzahlen einzubeziehen.

Vollständige Informationen zu allen Anforderungs- und Antwortattributen für Autocomplete finden Sie unter Autocomplete in der Amazon Location Service API-Referenz.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter So verwenden Sie Autocomplete.

Anwendungsfälle

  • Verbessern Sie das Checkout-Erlebnis: Sorgen Sie für die Adressvervollständigung in Echtzeit, wenn Kunden ihre Adresse in E-Commerce-Checkout-Erlebnissen und anderen Adresseingabe-Erlebnissen auf Websites oder Apps eingeben. Stellen Sie sicher, dass die Liefer- oder Abholorte mit bekannten Adressen übereinstimmen, um kostspielige Fehler zu vermeiden und die Kundenzufriedenheit zu erhöhen.

  • Support Sie den Kundenservice: Geben Sie Kundendienstmitarbeitern in Bereichen wie Kontaktzentren und Notfalldiensten in Echtzeit Adressvorschläge, optimieren Sie den Prozess der Erfassung genauer Adressinformationen und verbessern Sie die Kundenzufriedenheit, indem Sie den Zeitaufwand für die Beschaffung korrekter Adressinformationen reduzieren.

Verstehen Sie die Anfrage

Der Autocomplete Vorgang unterstützt viele optionale Anforderungsattribute, um die Suchergebnisse zu verfeinern. Die vollständige Liste der Anforderungsattribute finden Sie unter Autocomplete in der Amazon Location Service API-Referenz.

Die Anfrage akzeptiert die folgenden Schlüsselparameter:

Authentifizierung

Der Autocomplete-API-Vorgang unterstützt zwei alternative Authentifizierungsmodi. Sie können sich authentifizieren, indem Sie die Anfrage entweder mit einer Sigv4-Signatur signieren oder einen API-Schlüssel angeben.

  • Wenn Sie Anfragen mit einem sprachspezifischen AWS-SDK oder der AWS-CLI stellen, wird Ihre Anfrage normalerweise standardmäßig mit SigV4 signiert.

  • In einigen Anwendungsfällen, z. B. bei Anfragen über einen Webbrowser oder bei der Verwendung eines anderen SDK-Clients, der nicht von AWS stammt, sind API-Schlüssel eine geeignetere Form der Authentifizierung. Verwenden Sie das optionale Schlüsselanforderungsattribut, um einen API-Schlüssel für die Authentifizierung bereitzustellen. Autocomplete

Weitere Informationen finden Sie Authentifizieren Sie sich mit Amazon Location Service in der Amazon Location Service API-Referenz.

Angabe der Adresse, die abgefragt werden soll

  • Verwenden Sie das obligatorische QueryText Anforderungsattribut, um den abzufragenden Text in freier Form bereitzustellen.

  • BiasPosition: Verwenden Sie das optionale BiasPosition Anforderungsattribut, um eine Pinposition als [longitude, latitude] Koordinatenpaar anzugeben, um die Relevanz der zurückgegebenen Ergebnisse zu verbessern.

Weitere Informationen finden Sie Abfragen und Voreingenommenheit in der Amazon Location Service API-Referenz.

Einschließlich aller Antwortattribute

Setzen Sie das optionale Feld AdditionalFeatures auf den Wert ["Core"], um alle verfügbaren Ergebnisattribute in die Antwort aufzunehmen, einschließlich der vollständigen Aufschlüsselung der Adressen und der interaktiven hervorgehobenen Positionen. Beachten Sie, dass sich die Anforderung dieser zusätzlichen Attribute auf die Preisgestaltung auswirken kann

Ergebnisse verfeinern

Verwenden Sie das Filterattribut, um die zurückgegebenen Ergebnisse nach bestimmten Ländern, Ortstypen oder geografischen Gebieten zu filtern. Weitere Informationen finden Sie Filtern im Amazon Location Service Developer Guide.

Verstehen Sie die Antwort

Das Antwortobjekt enthält ein benanntes Array-AttributResultItems, das die Liste der Ergebnisse in aufsteigender Reihenfolge ihrer Relevanz enthält. Die vollständige Liste der Ergebnisartikelattribute finden Sie unter Autocomplete in der Amazon Location Service API-Referenz.

Im Folgenden finden Sie eine kurze Liste einiger der wichtigsten Attribute von Ergebniselementen.

Adresse und zugehörige Informationen

  • PlaceTypeenthält den Ortstyp des Ergebnisses, der uns sagt, ob die Adresse eine Punktadresse, eine Straße usw. darstellt. Ergebnisse, die von zurückgegeben Autocomplete werden, haben immer einen Ortstyp, der entweder eine vollständige Adresse oder einen Bestandteil einer Adresse darstellt, z. B. eine Straße oder eine Postleitzahl. Die Ergebnisse werden niemals Sehenswürdigkeiten enthalten.

  • Addressenthält die Ergebnisbeschriftung und, falls ["Core"] für angegebenAdditionalFeatures, auch die vollständige Aufschlüsselung der Adresse in strukturierte Felder wie Hausnummer, Straßenname, Postleitzahl, Land und dergleichen..

Analyse der Ergebnisse

Stellt Analysedaten für jedes Ergebnis in Bezug auf die Eingabeabfrage bereit.

  • Distance: Wenn in der Anfrage a angegeben BiasPosition wurde, enthält jedes Ergebniselement ein Distance Attribut, das die Entfernung dieses Ergebnisses in Metern von der angibtBiasPosition. Der Parameter AdditionalFeatures muss auf den Wert ["Core"] festgelegt sein.

  • Highlightszeigt, wo Wörter, Ausdrücke und Teilzeichenfolgen aus der Eingabe genau in einem Ergebnisattribut QueryText vorkommen, sodass Anwendungen ihren Benutzern hilfreiche Benutzererfahrungen bieten und Treffer hervorheben können. Der Parameter AdditionalFeatures muss auf den Wert ["Core"] festgelegt sein.