Automatische Vervollständigung mithilfe von Amazon Location - Amazon Location Service
Automatische Vervollständigung verwendenVerwenden der Ergebnisse der automatischen VervollständigungAutomatische Vervollständigung in der Nähe einer PositionAutomatische Vervollständigung innerhalb eines BegrenzungsrahmensAutomatische Vervollständigung innerhalb eines LandesBeispielantwort

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.

Automatische Vervollständigung mithilfe von Amazon Location

Die automatische Vervollständigung bietet Endbenutzern bei der Eingabe ihrer Suchabfrage ein responsives Feedback. Es bietet Vorschläge für Adressen und Sehenswürdigkeiten, die auf unvollständigem oder falsch geschriebenem Freiformtext basieren. Sie können Ortsindex-Ressourcen verwenden, um Vorschläge zur automatischen Vervollständigung anzufordern und die daraus resultierenden Vorschläge in Ihrer Anwendung anzuzeigen.

Amazon Location unterstützt das Speichern von Vorschlägen zur automatischen Vervollständigung nicht. Es wird ein Fehler zurückgegeben, wenn der Ortsindex, der für einen Autocomplete-Aufruf verwendet wird, für die Verwendung mit gespeicherten Geocodes konfiguriert ist. Um gespeicherte Geocodes zu verwenden und Vorschläge abzufragen, müssen Sie mehrere Ortsindizes erstellen und konfigurieren.

In diesem Abschnitt wird beschrieben, wie Sie eine Autocomplete-Anfrage senden. Es beginnt mit der einfachsten Form der Anfrage und zeigt dann optionale Parameter, mit denen Sie die Relevanz von Suchergebnissen mit automatischer Vervollständigung erhöhen können.

Verwenden der automatischen Vervollständigung

Mithilfe des Vorgangs können Sie eine einfache Anfrage für Vorschläge zur automatischen Vervollständigung einreichen. SearchPlaceIndexForSuggestions Die einfachste Form der Anfrage hat einen einzigen erforderlichen Parameter, die AbfrageText:

  • Text— Der formlose Teiltext, der zur Generierung von Ortsvorschlägen verwendet werden soll. Zum Beispiel die Zeichenfolgeeiffel tow.

Um die Anzahl der zurückgegebenen Ergebnisse zu begrenzen, fügen Sie den optionalen MaxResults Parameter hinzu:

  • MaxResults— Beschränkt die Anzahl der in der Abfrageantwort zurückgegebenen Ergebnisse.

Sie können den Amazon-Standort APIs oder den verwenden AWS CLI.

API

Das folgende Beispiel ist eine SearchPlaceIndexForSuggestions Anfrage zur Suche nach der Ortsindex-Ressource, ExamplePlaceIndex, für bis zu 5 Vorschläge, die auf dem unvollständigen Ortsnamen basieren kamp. 

POST /places/v0/indexes/ExamplePlaceIndex/search/suggestions
Content-type: application/json

{
    "Text": "kamp",
    "MaxResults": 5
}
AWS CLI

Das folgende Beispiel ist ein search-place-index-for-suggestions Befehl zum Durchsuchen der Ortsindex-Ressource, ExamplePlaceIndex, für bis zu 5 Vorschläge, die auf dem unvollständigen Ortsnamen basieren kamp. 

aws location \
              search-place-index-for-suggestions \
              --index-name ExamplePlaceIndex \
              --text kamp \
              --max-results 5

Der Aufruf SearchPlaceIndexForSuggestions führt zu einer Liste von Orten mit jeweils einem Namen und einer ID. Sie können diese Ergebnisse verwenden, um Vorschläge zu unterbreiten, wonach der Benutzer möglicherweise während der Eingabe sucht, z. B. eine Dropdownliste mit Auswahlmöglichkeiten unter einem Textfeld bereitzustellen. Hier sind zum Beispiel die Ergebnisse für Vorschläge, die auf einer Benutzereingabe basieren kamp.

{
    "Summary": {
        "Text": "kamp",
        "MaxResults": 5,
        "DataSource": "Esri"
    },
    "Results": [
        {
            "Text": "Kampuchea",
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ"
        },
        {
            "Text": "Kampoul, Kabul, AFG",
            "PlaceId": "AQAAAIAAA1mxl_-9ffzXD07rBgo9fh6E01Pd1YKvuT5rz2qBDxqBkhTlgkeiOPR2s5sa3YBLxUqQI8bhymsYcu9R-DkX3L9QSi3CB5LhNPu160iSFJo6H8S1CrxO3QsJALhrr9mdbg0R4R4YDywkhkeBlnbn7g5C5LI_wYx873WeQZuilwtsGm8jcMA0Ya5oK4netQC6piVx6zmnPdwBs-UeXcb_bg"
        },
        {
            "Text": "Kampala, UGA",
            "PlaceId": "AQAAAIAAzZfZt3qMruKGObyhP6MM0pqy2L8SULlVWT7a3ertLBRS6Q5n7I4s9D7E0nRHADAj7mL7kvX1Q8HD-mpuiATXNJ1Ix4_V_1B15zHe8jlYKMWvXbgbO8cMpgR2fqYqZMR1x-dfBOO8OoqujKZldvPIDK1kNe3GwcaqvvMWWPMeaGd203brFynubAe-MmFF-Gjz-WBMfUy9og6MV7bkk6NGCA"
        },
        {
            "Text": "Kampar, Riau, IDN",
            "PlaceId": "AQAAAIAAvbXXx-srOi111tHOkPdao0GF7WQ_KaZ444SEnevycp6Gtf_2JWgPfCE5bIQCYwya1uZQpX2a8YJoFm2K7Col4fLu7IK0yYOLhZx4kp6QzbG4xEAGzfWtWq6nfbb0lZfuHY6r0g1sRlN1aucvwim4AEcKRzckqaa93JI8064pj6Q59kN37pAa3JX4ayEzH1DzIL3m3oqxzd4O16yGfhAIgA"
        },
        {
            "Text": "Kampung Pasir Gudang Baru, Johor, MYS",
            "PlaceId": "AQAAAIAA4HLQHdjUDcaaXLE9wtNIT1cjQYLgkBnMoG2eNN0AaQ8PJoWabLRXmmPUaAj8MAD6vT0i6zqaun5Mixyj7vnYXrk2xp59cbgdqvQaPoWhSCVxBOX0WGs3cZ8TnIRn3c-6v8_UfmqC7es1gUyECfMGK04VBKiwpHwCzjNsqymkd9BC3A9K3QlMgd3dkrGjv_vV94iLlnFTbaecrckl2UDCkA"
        }
    ]
}

Im nächsten Abschnitt wird erklärt, wie Sie die PlaceID aus diesen Ergebnissen gewonnenen Ergebnisse verwenden können.

Verwenden der Ergebnisse der automatischen Vervollständigung

Der Aufruf von SearchPlaceIndexForSuggestions führt zu einer Liste von Orten mit jeweils einem Namen und einer ID. Sie können diese Ergebnisse verwenden, um Vorschläge zu unterbreiten, wonach der Benutzer möglicherweise während der Eingabe sucht, z. B. eine Dropdownliste mit Auswahlmöglichkeiten unter einem Textfeld bereitzustellen. Wenn der Benutzer eines der Ergebnisse auswählt, können Sie den GetPlaceVorgang mit der ID seiner Auswahl aufrufen, um die Details dieses Ortes, einschließlich Standort, Adresse oder andere Details, zurückzugeben.

Anmerkung

A PlaceId ist nur gültig, wenn alle der folgenden Angaben in der ursprünglichen Suchanfrage und dem Aufruf von identisch sindGetPlace.

  • Kunde AWS-Konto

  • AWS-Region

  • In der Ortsindexressource angegebener Datenanbieter

In der Regel verwenden Sie GetPlace den Amazon-StandortAPIs. Das folgende Beispiel ist eine GetPlace Anfrage, um einen der Vorschläge aus dem vorherigen Abschnitt zu finden. Dieses Beispiel basiert auf dem unvollständigen Ortsnamen kamp. 

POST /places/v0/indexes/ExamplePlaceIndex/places/AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ

Automatische Vervollständigung in der Nähe einer Position

Wenn Sie mithilfe von nach Platzvorschlägen für die automatische Vervollständigung suchenSearchPlaceIndexForSuggestions, können Sie weitere lokal relevante Vorschläge erhalten, indem Sie den folgenden optionalen Parameter hinzufügen:

  • BiasPosition— Die Position, nach der Sie in der Nähe suchen möchten. Definiert als[longitude, latitude].

Im folgenden Beispiel wird eine SearchPlaceIndexForSuggestions Anfrage verwendet, um die Ortsindex-Ressource zu durchsuchen ExamplePlaceIndex für Ortsvorschläge, die der partiellen Abfrage entsprechen kamp in der Nähe der Position [32.5827,0.3169]. 

POST /places/v0/indexes/ExamplePlaceIndex/search/suggestions
Content-type: application/json

{
    "Text": "kamp",
    "BiasPosition": [32.5827,0.3169]
}

Die Vorschläge, die für dasselbe zurückgegeben werden, Text können unterschiedlich sein, wenn ein anderes ausgewählt BiasPosition wird, wie zum Beispiel [-96.7977, 32.7776].

Automatische Vervollständigung innerhalb eines Begrenzungsrahmens

Sie können Ihre Suche mit der automatischen Vervollständigung einschränken, sodass Sie nur Vorschläge für Orte erhalten, die sich innerhalb einer bestimmten Grenze befinden, indem Sie den folgenden optionalen Parameter hinzufügen:

  • FilterBBox— Ein Begrenzungsrahmen, den Sie angeben, um Ihre Ergebnisse nach Koordinaten innerhalb der Grenzen des Felds zu filtern. Definiert als [LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]

    Anmerkung

    Eine Anfrage kann nicht sowohl die als auch die FilterBBox BiasPosition Parameter enthalten. Wenn Sie beide Parameter in der Anfrage angeben, wird ein ValidationException Fehler zurückgegeben.

Im folgenden Beispiel wird eine SearchPlaceIndexForSuggestions Anfrage verwendet, um die Ortsindex-Ressource zu durchsuchen ExamplePlaceIndex für Ortsvorschläge, die der partiellen Abfrage entsprechen kamp, und die innerhalb des Begrenzungsrahmens enthalten sind, wobei:

  • Der Längengrad der südwestlichen Ecke des Begrenzungsrahmens ist 32.5020.

  • Der Breitengrad der südwestlichen Ecke des Begrenzungsrahmens ist 0.2678.

  • Der Längengrad der nordöstlichen Ecke des Begrenzungsrahmens ist 32.6129.

  • Der Breitengrad der nordöstlichen Ecke des Begrenzungsrahmens ist 0.3502.

POST /places/v0/indexes/ExamplePlaceIndex/search/suggestions
Content-type: application/json

{
    "Text": "kamp",
    "FilterBBox": [
        32.5020, 0.2678,
        32.6129, 0.3502
    ]
}

Die Vorschläge, die für dasselbe zurückgegeben Text werden, unterscheiden sich, wenn ein anderes ausgewählt FilterBBox wird, wie z. B. [-97.9651, 32.0640, -95.1196, 34.0436].

Automatische Vervollständigung innerhalb eines Landes

Sie können Ihre Suche mit der automatischen Vervollständigung einschränken, sodass Sie nur Vorschläge für Orte erhalten, die sich in einem bestimmten Land oder einer Reihe von Ländern befinden, indem Sie den folgenden optionalen Parameter hinzufügen:

  • FilterCountries— Die Länder, in denen Sie nach Ortsvorschlägen suchen möchten. Sie können bis zu 100 Länder in einer Anfrage angeben, indem Sie einen aus drei Buchstaben bestehenden ISOLändercode 3166 verwenden. Verwenden Sie dies beispielsweise AUS für Australien.

Im folgenden Beispiel wird eine SearchPlaceIndexForSuggestions Anfrage verwendet, um die Ortsindex-Ressource zu durchsuchen ExamplePlaceIndex für Ortsvorschläge, die der partiellen Abfrage entsprechen kamp und die in Uganda, Kenia oder Tansania enthalten sind:

POST /places/v0/indexes/ExamplePlaceIndex/search/suggestions
Content-type: application/json

{
    "Text": "kamp",
    "FilterCountries": ["UGA", "KEN", "TZA"]
}

Die Vorschläge, die für dasselbe zurückgegeben Text werden, unterscheiden sich, wenn eine andere FilterCountries Liste ausgewählt wird, z. B. [“USA"].

Beispielantwort

Im Folgenden finden Sie ein Beispiel für eine Antwort mit vorgeschlagenen Autovervollständigungen für den SearchPlaceIndexForSuggestions Vorgang unter Verwendung des folgenden Textes kamp.

{
    "Summary": {
        "Text": "kamp",
        "MaxResults": 5,
        "DataSource": "Esri"
    },
    "Results": [
        {
            "Text": "Kampuchea",
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ"
        },
        {
            "Text": "Kampoul, Kabul, AFG",
            "PlaceId": "AQAAAIAAA1mxl_-9ffzXD07rBgo9fh6E01Pd1YKvuT5rz2qBDxqBkhTlgkeiOPR2s5sa3YBLxUqQI8bhymsYcu9R-DkX3L9QSi3CB5LhNPu160iSFJo6H8S1CrxO3QsJALhrr9mdbg0R4R4YDywkhkeBlnbn7g5C5LI_wYx873WeQZuilwtsGm8jcMA0Ya5oK4netQC6piVx6zmnPdwBs-UeXcb_bg"
        },
        {
            "Text": "Kampala, UGA",
            "PlaceId": "AQAAAIAAzZfZt3qMruKGObyhP6MM0pqy2L8SULlVWT7a3ertLBRS6Q5n7I4s9D7E0nRHADAj7mL7kvX1Q8HD-mpuiATXNJ1Ix4_V_1B15zHe8jlYKMWvXbgbO8cMpgR2fqYqZMR1x-dfBOO8OoqujKZldvPIDK1kNe3GwcaqvvMWWPMeaGd203brFynubAe-MmFF-Gjz-WBMfUy9og6MV7bkk6NGCA"
        },
        {
            "Text": "Kampar, Riau, IDN",
            "PlaceId": "AQAAAIAAvbXXx-srOi111tHOkPdao0GF7WQ_KaZ444SEnevycp6Gtf_2JWgPfCE5bIQCYwya1uZQpX2a8YJoFm2K7Col4fLu7IK0yYOLhZx4kp6QzbG4xEAGzfWtWq6nfbb0lZfuHY6r0g1sRlN1aucvwim4AEcKRzckqaa93JI8064pj6Q59kN37pAa3JX4ayEzH1DzIL3m3oqxzd4O16yGfhAIgA"
        },
        {
            "Text": "Kampung Pasir Gudang Baru, Johor, MYS",
            "PlaceId": "AQAAAIAA4HLQHdjUDcaaXLE9wtNIT1cjQYLgkBnMoG2eNN0AaQ8PJoWabLRXmmPUaAj8MAD6vT0i6zqaun5Mixyj7vnYXrk2xp59cbgdqvQaPoWhSCVxBOX0WGs3cZ8TnIRn3c-6v8_UfmqC7es1gUyECfMGK04VBKiwpHwCzjNsqymkd9BC3A9K3QlMgd3dkrGjv_vV94iLlnFTbaecrckl2UDCkA"
        }
    ]
}