Cómo geocodificar mediante filtros

La API de Geocode le permite usar filtros para obtener los resultados deseados.

Uso potencial

Utilice filtros para restringir los resultados en función de las necesidades de su empresa.

Ejemplos

Limite los resultados dentro de un país

Especifique un valor IncludeCountries para que se devuelvan los valores de ese país en los resultados.

Sample request

Sin IncludeCountries": ["USA"] ella, la API de Geocode 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"]}'

Refina los resultados con filtros de tipo de lugar

Especifique un valor IncludePlaceTypes para que se devuelvan los valores de ese lugar en los resultados.

Sample request

Sin IncludePlaceTypes": ["Street"] ella, la API de Geocode devolverá Georgia, un país. Puede refinar aún más los resultados sumando "IncludeCountries" 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 para 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.