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 controlar variantes de nome de endereço
AddressNamesModeespecifica como os nomes dos endereços são retornados. Se não for definido, o serviço retornará nomes normalizados (oficiais) por padrão. Quando definido comoMatched, os nomes de endereço na resposta são baseados na consulta de entrada e não nos nomes oficiais. Quando definido comoAdministrative, o serviço retorna os nomes administrativos oficiais dos componentes do endereço. Administrativeatualmente se aplica somente a endereços nos Estados Unidos da América.
Casos de uso possíveis
-
Preenchimento do formulário de endereço: use Matched para retornar nomes consistentes com o que o usuário digitou, reduzindo a confusão nos fluxos de trabalho de preenchimento automático.
-
Padronização de endereços: use Administrative para normalizar os nomes das cidades de acordo com seu formulário administrativo oficial para qualidade e desduplicação de dados.
Exemplos
- Sample request
-
{
"QueryText": "100 Universal City Plaza, Hollywood, CA",
"AddressNamesMode": "Matched"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointAddress",
"Title": "100 Universal City Plz, Universal City, CA 91608, United States",
"Address": {
"Label": "100 Universal City Plz, Universal City, CA 91608, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "CA",
"Name": "California"
},
"Locality": "Universal City",
"PostalCode": "91608",
"Street": "Universal City Plz",
"AddressNumber": "100"
},
"Position": [
-118.36054,
34.13857
]
}
]
}
- 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": "100 Universal City Plaza, Hollywood, CA",
"AddressNamesMode": "Matched"
}'
- AWS CLI
-
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Matched
- Sample request
-
{
"QueryText": "100 Universal City Plaza, Hollywood, CA",
"AddressNamesMode": "Administrative"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointAddress",
"Title": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
"Address": {
"Label": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "CA",
"Name": "California"
},
"Locality": "Los Angeles",
"PostalCode": "91608",
"Street": "Universal Terrace Pkwy",
"AddressNumber": "100"
},
"Position": [
-118.36054,
34.13857
]
}
]
}
- 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": "100 Universal City Plaza, Hollywood, CA",
"AddressNamesMode": "Administrative"
}'
- AWS CLI
-
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Administrative
Dicas para o desenvolvedor
-
Se não for definido, o serviço retornará nomes normalizados (oficiais) por padrão.
-
Administrativeatualmente se aplica somente a endereços nos Estados Unidos da América.
