Umgekehrte Geokodierung mit Amazon Location

Die umgekehrte Geokodierung ist ein Prozess, bei dem ein Satz von Koordinaten in aussagekräftigen Text umgewandelt wird, z. B. eine Adresse, eine Region, einen Firmennamen oder eine Sehenswürdigkeit. Sie können Ortsindex-Ressourcen verwenden, um Anfragen zur umgekehrten Geokodierung einzureichen und Daten, die bei der umgekehrten Geokodierung abgerufen wurden, zu integrieren, um Daten auf einer Karte für Ihre Web- oder Mobilanwendung anzuzeigen.

In diesem Abschnitt erfahren Sie, wie Sie eine einfache Anfrage zur umgekehrten Geokodierung senden.

Umgekehrte Geokodierung

Sie können eine einfache Anfrage einreichen, um einen Satz von Koordinaten rückwärts zu geokodieren und sie mithilfe des Vorgangs in eine aussagekräftige Adresse, eine Sehenswürdigkeit oder eine allgemeine Position ohne Adresse umzuwandeln. SearchPlaceIndexForPosition Eine einfache Anfrage enthält den folgenden erforderlichen Parameter:

• Position— Ein Satz von Koordinaten, den Sie in eine Adresse, eine Sehenswürdigkeit oder einen allgemeinen Standort konvertieren möchten. Definiert unter Verwendung des Formats[longitude,latitude].

Um eine maximale Anzahl von Ergebnissen pro Seite anzugeben, fügen Sie den folgenden optionalen Parameter hinzu:

• MaxResults— Beschränkt die maximale Anzahl von Ergebnissen, die in der Abfrageantwort zurückgegeben werden.

Wenn Sie eine bevorzugte Sprache für die Ergebnisse Ihrer Abfrage angeben möchten, verwenden Sie den folgenden optionalen Parameter:

• Language— Ein Sprachcode, der zum Rendern von Ergebnissen verwendet werden soll. Der Wert muss ein gültiger BCP47-Sprachcode sein. Zum Beispiel en für Englisch.

Anmerkung

Wenn nicht angegeben Language ist oder die angegebene Sprache für ein Ergebnis nicht unterstützt wird, wird die Standardsprache des Partners für dieses Ergebnis verwendet.

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

API

Das folgende Beispiel ist eine SearchPlaceIndexForPosition Anfrage zur Suche nach der Ortsindex-Ressource, ExamplePlaceIndex, für eine aussagekräftige Adresse, eine Sehenswürdigkeit oder einen allgemeinen Standort in der Nähe der Position [122.3394,47.6159].

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

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 5,
   "Language": "de"
}

AWS CLI

Das folgende Beispiel ist ein search-place-index-for-position Befehl zum Durchsuchen der Ortsindex-Ressource, ExamplePlaceIndex, für eine aussagekräftige Adresse, eine Sehenswürdigkeit oder einen allgemeinen Standort in der Nähe der Position [122.3394,47.6159].

aws location \
    search-place-index-for-position \
        --index-name ExamplePlaceIndex \
        --position -122.3394 47.6159 \
        --max-results 5 \
        --language de

Beispielantwort

Im Folgenden finden Sie ein Beispiel für eine Antwort, wenn Sie den SearchPlaceIndexForPosition Vorgang von Amazon Location Places aus aufrufenAPIs. Die Ergebnisse geben relevante Orte und die Zusammenfassung der Anfrage zurück. Je nachdem, ob Esri oder Here als Partner ausgewählt wurde, werden zwei Antworten angezeigt.

Example request

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

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 1
}

Example response (Esri)

{
    "Results": [
        {
            "Place": {
                "AddressNumber": "2111",
                "Country": "USA",
                "Geometry": {
                    "Point": [
                        -122.33937999999995,
                        47.61591000000004
                    ]
                },
                "Interpolated": false,
                "Label": "The Spheres, 2111 7th Ave, Seattle, WA, 98121, USA",
                "Municipality": "Seattle",
                "Neighborhood": "Belltown",
                "PostalCode": "98121",
                "Region": "Washington",
                "SubRegion": "King County"
            },
            "Distance": 1.8685861313438727
        }
    ],
    "Summary": {
        "DataSource": "Esri",
        "MaxResults": 1,
        "Position": [
            -122.3394,
            47.6159
        ]
    }
}

Example response (HERE)

{
    "Summary": {
        "Position": [
            -122.3394,
            47.6159
        ],
        "MaxResults": 1,
        "DataSource": "Here"
    },
    "Results": [
        {
            "Place": {
                "Label": "2111 7th Ave, Seattle, WA 98121-5114, United States",
                "Geometry": {
                    "Point": [
                        -122.33938,
                        47.61591
                    ]
                },
                "AddressNumber": "2111",
                "Street": "7th Ave",
                "Neighborhood": "Belltown",
                "Municipality": "Seattle",
                "SubRegion": "King",
                "Region": "Washington",
                "Country": "USA",
                "PostalCode": "98121-5114",
                "Interpolated": false,
                "TimeZone": {
                    "Name": "America/Los_Angeles",
                    "Offset": -28800
                }
            },
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ",
            "Distance": 1.868586125090601
        }
    ]
}