As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Como geocodificar usando filtros
A API de Geocodificação permite usar filtros para obter os resultados desejados.
Uso possível
Use filtros para restringir os resultados com base nas necessidades da sua empresa.
Exemplos
Especifique um valor para IncludeCountries para retornar valores desse país nos resultados.
- Sample request
-
Sem IncludeCountries": ["USA"], a API de Geocodificação retornará Vancouver, BC, 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 um valor para IncludePlaceTypes para retornar valores desse local nos resultados.
- Sample request
-
Sem IncludePlaceTypes": ["Street"], a API de Geocodificação retornará Geórgia, um país. Para refinar ainda mais os resultados, adicione "IncludeCountries" com valores de CAN e USA e compare os resultados.
{
"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"]}'
Dicas para o desenvolvedor
Para geocodificação de endereços, tente usar endereços completos ou um componente de consulta com uma combinação de posição de desvio, incluindo país e local. Para saber mais, consulte Como geocodificar um endereço.
