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 geocodificar mediante filtros
La API de Geocodificación le permite usar filtros para obtener los resultados deseados.
Posible uso
Utilice filtros para restringir los resultados en función de las necesidades de la empresa.
Ejemplos
Especifique un valor para IncludeCountries para que se devuelvan los valores de ese país en los resultados.
- Sample request
-
Sin IncludeCountries": ["USA"], la API de Geocodificación devolverá Vancouver, Columbia Británica (Canadá).
{
"QueryText": "Vancouver",
"Filter" : {
"IncludeCountries": ["USA"]
}
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "Locality",
"Title": "Vancouver, WA, United States",
"Address": {
"Label": "Vancouver, WA, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "Clark"
},
"Locality": "Vancouver",
"PostalCode": "98660"
},
"Position": [
-122.67156,
45.63248
],
"MapView": [
-122.77466,
45.57714,
-122.46451,
45.69803
],
"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",
"Filter" : {
"IncludeCountries": ["USA"]
}
}'
- AWS CLI
-
aws geo-places geocode --key ${YourKey} --query-text "Vancouver" --filter '{"IncludeCountries": ["USA"]}'
Especifique un valor para IncludePlaceTypes para que se devuelvan los valores de ese lugar en los resultados.
- Sample request
-
Sin IncludePlaceTypes": ["Street"], la API de Geocodificación devolverá Georgia, un país. Puede ajustar aún más los resultados agregando "IncludeCountries" con los valores de CAN y USA y comparándolos.
{
"QueryText": "Georgia",
"Filter" : {
"IncludePlaceTypes": ["Street"]
}
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "Street",
"Title": "Georgia, Benito Juárez, CDMX, México",
"Address": {
"Label": "Georgia, Benito Juárez, CDMX, México",
"Country": {
"Code2": "MX",
"Code3": "MEX",
"Name": "México"
},
"Region": {
"Code": "CDMX",
"Name": "Ciudad de México"
},
"SubRegion": {
"Name": "Ciudad de México"
},
"Locality": "Benito Juárez",
"Street": "Georgia",
"StreetComponents": [
{
"BaseName": "Georgia",
"Language": "es"
}
]
},
"Position": [
-99.17754,
19.38887
],
"MapView": [
-99.18133,
19.38755,
-99.17374,
19.39016
],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": {
"Intersection": [
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": "Georgia",
"Filter" : {
"IncludePlaceTypes": ["Street"]
}
}'
- AWS CLI
-
aws geo-places geocode --key ${YourKey} --query-text "Georgia" --filter '{"IncludePlaceTypes": ["Street"]}'
Consejos de desarrolladores
Para la geocodificación de direcciones, intente utilizar direcciones completas o un componente de consulta con una combinación de posiciones de sesgo, incluidos el país y el lugar. Para obtener más información, consulte Cómo geocodificar una dirección.
