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.
Geokodierung mit Amazon Location
Geokodierung ist ein Prozess, bei dem Text, z. B. eine Adresse, eine Region, ein Firmenname oder eine Sehenswürdigkeit, in eine Reihe von geografischen Koordinaten umgewandelt wird. Sie können Ortsindex-Ressourcen verwenden, um Geokodierungsanfragen zu senden und Daten, die bei der 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 Geokodierungsanforderung und Geokodierungsanforderungen mit optionalen Spezifikationen senden.
Geokodierung
Mithilfe des SearchPlaceIndexForText Vorgangs zur Konvertierung einer Adresse in einen Satz von Koordinaten können Sie eine einfache Geokodierungsanforderung einreichen. Eine einfache Anfrage enthält den folgenden erforderlichen Parameter:
-
Text— Eine Adresse, ein Name, eine Stadt oder eine Region, die in einen Satz von Koordinaten umgewandelt werden sollen. Zum Beispiel die ZeichenfolgeAny Town.
Verwenden Sie den folgenden optionalen Parameter, um eine maximale Anzahl von Ergebnissen pro Seite anzugeben:
-
MaxResults— Beschränkt die maximale Anzahl von Ergebnissen, die in der Abfrageantwort zurückgegeben werden.
Sie können den AWS CLI oder den Amazon-Standort verwendenAPIs.
Geokodieren Sie in der Nähe einer Position
Bei der Geokodierung können Sie in der Nähe einer bestimmten Position mit dem folgenden optionalen Parameter geokodieren:
-
BiasPosition— Die Position, nach der Sie in der Nähe suchen möchten. Dies schränkt Ihre Suche ein, indem nach Ergebnissen gesucht wird, die der angegebenen Position am nächsten sind. Definiert als[longitude, latitude]
Das folgende Beispiel ist eine SearchPlaceIndexForText Anfrage zum Durchsuchen der Ortsindexressource nach einer Adresse, einem Namen, einer Stadt oder einer Region mit dem Namen Any
Town in der Nähe der Position [-123.4567,45.6789].
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [-123.4567,45.6789] }
Geocode innerhalb eines Begrenzungsrahmens
Mithilfe des folgenden optionalen Parameters können Sie innerhalb eines Begrenzungsrahmens geokodieren, um Ihre Ergebnisse auf Koordinaten innerhalb einer bestimmten Grenze einzugrenzen:
-
FilterBBox— Ein Begrenzungsrahmen, den Sie angeben, um Ihre Ergebnisse nach Koordinaten innerhalb der Grenzen des Rahmens zu filtern. Definiert als[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]Anmerkung
Eine Anfrage kann nicht sowohl die als auch die
FilterBBoxBiasPositionParameter enthalten. Wenn Sie beide Parameter in der Anfrage angeben, wird einValidationExceptionFehler zurückgegeben.
Das folgende Beispiel ist eine SearchPlaceIndexForText Anfrage zur Suche innerhalb eines Begrenzungsrahmens nach einer Adresse, einem Namen, einer Stadt oder einer Region namens Any Town. Die Begrenzungsbox folgt daraus:
-
Der Längengrad der südwestlichen Ecke ist
-124.1450. -
Der Breitengrad der südwestlichen Ecke ist
41.7045. -
Der Längengrad der nordöstlichen Ecke ist
-124.1387. -
Der Breitengrad der nordöstlichen Ecke ist
41.7096.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [-124.1450,41.7045,-124.1387,41.7096] }
Geocode innerhalb eines Landes
Sie können innerhalb eines oder mehrerer Länder, die Sie angeben, geokodieren, indem Sie den folgenden optionalen Parameter verwenden:
-
FilterCountries— Das Land oder die Region, in dem Sie geokodieren möchten. Sie können bis zu 100 Länder in einer Anfrage definieren, indem Sie einen aus drei Buchstaben bestehenden ISOLändercode 3166verwenden. Verwenden Sie dies beispielsweise AUSfür Australien.
Das folgende Beispiel ist eine SearchPlaceIndexForText Anfrage zur Suche nach einer Adresse, einem Namen, einer Stadt oder einer Region mit dem Namen Any Town in Deutschland und Frankreich.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["DEU","FRA"] }
Nach Kategorie filtern
Sie können die Kategorien filtern, die in Ihrer Geokodierungsanforderung zurückgegeben werden, indem Sie den folgenden optionalen Parameter verwenden:
-
FilterCategories— Die Kategorien von Ergebnissen, die in Ihrer Abfrage zurückgegeben werden sollen. Sie können bis zu 5 Kategorien in einer Anfrage angeben. Die Liste der Amazon Location Service Service-Kategorien finden Sie im Abschnitt Kategorien. Sie können beispielsweise angebenHotel, dass in Ihrer Anfrage nur Hotels mit wiederkehrenden Hotels angegeben werden sollen.
Das folgende Beispiel ist eine SearchPlaceIndexForText Anfrage zur Suche nach einem Café mit dem Namen Hometown Coffee in den Vereinigten Staaten.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
Weitere Informationen zum Filtern nach Kategorien finden Sie unter Platzieren Sie Kategorien und filtern Sie Ergebnisse mit Amazon Location
Geokodieren Sie in einer bevorzugten Sprache
Mithilfe des optionalen Language Parameters können Sie eine bevorzugte Sprache für die Ergebnisse Ihrer Suche festlegen. Beispielsweise 100 Main
St, Anytown, USA kann eine Suche nach 100 Main St, Any Town,
USA standardmäßig zurückgegeben werden. Wenn Sie jedoch fr als auswählenLanguage, werden die Ergebnisse möglicherweise 100 Rue
Principale, Any Town, États-Unis stattdessen zurückgegeben.
-
Language— Ein Sprachcode, der zum Rendern der Ergebnisse Ihrer Abfrage verwendet werden soll. Der Wert muss ein gültiger BCP47-Sprachcodesein. Zum Beispiel enfü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.
Das folgende Beispiel ist eine SearchPlaceIndexforText Anfrage zur Suche nach einem Ort Any Town mit der angegebenen bevorzugten Sprache alsde.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
Beispielantwort
Im Folgenden finden Sie ein Beispiel für eine Antwort, wenn Sie den SearchPlaceIndexForText Vorgang von Amazon Location Places aus aufrufenAPIs. Die Ergebnisse beinhalten relevante Orte und die Zusammenfassung der Anfrage. Je nachdem, ob Esri oder HERE als Partner ausgewählt wurde, werden zwei Antworten angezeigt.
