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.
So geokodieren Sie einen Verwaltungs- und Postbereich
Die Geocode-API ermöglicht Ihnen die Geokodierung für ein geografisches Gebiet mithilfe einer Abfragetexteingabe, z. B. des Namens eines Landes, einer Region (Bundesstaat oder Provinz) oder einer Stadt. Die API-Antwort umfasst Standortdetails wie geografische Koordinaten, Begrenzungsrahmen für Kartenvisualisierungen und Spielergebnisse, die die Relevanz des Ergebnisses für die Abfrage angeben.
Mögliche Anwendungsfälle
-
Koordinaten für einen Verwaltungsbereich ermitteln: Verwenden Sie Koordinaten als Schrägstellung oder Mittelpunkt an anderen Orten APIs.
-
Informationen auf einer Karte visualisieren: Geokodierte Koordinaten können verwendet werden, um Daten visuell auf einer Karte darzustellen.
Beispiele
- Sample request
-
{
"QueryText": "Canada"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId":"<Redacted>",
"PlaceType": "Country",
"Title": "Canada",
"Address": {
"Label": "Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
}
},
"Position": [-75.69122, 45.42177],
"MapView": [-141.00271, 41.67659, -52.61901, 83.11062],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "Country": 1 }
}
}
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "Canada"
}'
- AWS CLI
-
aws geo-places geocode --key ${YourAPIKey} --query-text "Canada"
- Sample request
-
{
"QueryText": "BC"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "Region",
"Title": "BC, Canada",
"Address": {
"Label": "BC, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
}
},
"Position": [-123.36445, 48.42854],
"MapView": [-139.04941, 48.22478, -114.05201, 60.00043],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "Region": 1 }
}
}
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "BC"
}'
- AWS CLI
-
aws geo-places geocode --key ${YourAPIKey} --query-text "BC"
- Sample request
-
{
"QueryText": "Vancouver"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "Locality",
"Title": "Vancouver, BC, Canada",
"Address": {
"Label": "Vancouver, BC, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"PostalCode": "V5Y"
},
"Position": [-123.11336, 49.26038],
"MapView": [-123.26754, 49.19891, -123.02301, 49.33557],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "Locality": 1 }
}
}
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "Vancouver"
}'
- AWS CLI
-
aws geo-places geocode --key ${YourAPIKey} --query-text "Vancouver"
Sie können eine Postleitzahl geokodieren. Verwenden Sie IncludePlaceTypes with ["PostalCode"] für genauere Ergebnisse.
- Sample request
-
{
"QueryText": "800006",
"Filter": { "IncludePlaceTypes": ["PostalCode"] }
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PostalCodeArea",
"Title": "800006, Patna, Bihar, India",
"Address": {
"Label": "800006, Patna, Bihar, India",
"Country": {
"Code2": "IN",
"Code3": "IND",
"Name": "India"
},
"Region": {
"Code": "BR",
"Name": "Bihar"
},
"SubRegion": { "Name": "Patna" },
"Locality": "Patna",
"PostalCode": "800006"
},
"Position": [85.18048, 25.61532],
"MapView": [85.16599, 25.60054, 85.19103, 25.6221],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": { "PostalCode": 1 }
}
}
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "800006",
"Filter": { "IncludePlaceTypes": ["PostalCode"] }
}'
- AWS CLI
-
aws geo-places geocode --key ${YourAPIKey} --query-text "800006" --filter '{"IncludePlaceTypes": ["PostalCode"]}'
Tipps für Entwickler
Verwenden Sie Filter wie IncludeCountries und IncludePlaceTypes für gezieltere Ergebnisse. Um beispielsweise Ergebnisse aus Vancouver in den USA sicherzustellen, legen Sie fest"IncludeCountries": ["USA"]. Weitere Details finden Sie unter .
{
"QueryText": "Vancouver",
"Filter": { "IncludeCountries": ["USA"] }
}
