Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cómo realizar la geocodificación inversa de una posición
La API de Geocodificación inversa le permite convertir una geocodificación en un área geográfica en función de una consulta de posición. La respuesta de la API incluye detalles del lugar y proporciona información sobre la ubicación asociada con coordenadas específicas.
Casos de uso potenciales
-
Almacene información sobre el lugar: agregue detalles del lugar a un almacén de datos que contenga coordenadas geográficas.
-
Visualización de mapas: utilice la información del lugar para mostrar los datos en un mapa.
-
Detección de la ubicación del usuario: identifique la ubicación del usuario en función de la posición del dispositivo.
- Sample request
-
{
"QueryPosition": [
-123.11694,
49.28126
]
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": {
"Label": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" },
"Region": { "Code": "BC", "Name": "British Columbia" },
"SubRegion": { "Name": "Metro Vancouver" },
"Locality": "Vancouver",
"District": "Downtown Vancouver",
"PostalCode": "V6B 0M3",
"Street": "W Georgia St",
"StreetComponents": [
{ "BaseName": "Georgia", "Type": "St", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Prefix": "W", "Language": "en" }
],
"AddressNumber": "510"
},
"Position": [-123.11694, 49.28126],
"Distance": 0,
"MapView": [-123.11813, 49.27786, -123.11076, 49.28246],
"AccessPoints": [
{ "Position": [-123.11656, 49.28151] }
]
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/reverse-geocode?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
-123.11694,
49.28126
]
}'
- AWS CLI
-
aws geo-places reverse-geocode --key ${YourKey} --query-position "-123.11694,49.28126"
- Sample request
-
{
"QueryPosition": [
-123.11694,
49.28126
],
"MaxResults": "3"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": { /* Address details */ },
"Position": [-123.11694, 49.28126],
"Distance": 0,
"MapView": [/* Map view details */],
"AccessPoints": [/* Access point details */]
},
{
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Title": "ChargePoint",
"Address": { /* Address details */ },
"Position": [-123.11663, 49.28116],
"Distance": 25,
"Categories": [/* Category details */],
"AccessPoints": [/* Access point details */]
},
{
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Title": "Zipcar",
"Address": { /* Address details */ },
"Position": [-123.11715, 49.28094],
"Distance": 29,
"Categories": [/* Category details */],
"AccessPoints": [/* Access point details */]
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/reverse-geocode?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryPosition": [
-123.11694,
49.28126
],
"MaxResults": "3"
}'
- AWS CLI
-
aws geo-places reverse-geocode --key ${YourKey} --query-position "-123.11694,49.28126" --max-results "3"
Consejos de desarrolladores
Para obtener resultados específicos, use IncludePlaceTypes en el filtro.
{
"QueryPosition": [
-123.11694,
49.28126
],
"Filter": { "IncludePlaceTypes": ["PointAddress"] }
}
