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 um número de endereço com um código postal
Em países onde os códigos postais são altamente específicos (vinculando apenas alguns endereços na mesma rua), um endereço pode ser encontrado apenas pelo número da casa e o código postal. Essa prática é comum na logística de transporte e entrega de encomendas. Esse atributo é aceito no Canadá, Reino Unido, Países Baixos, Estados Unidos (ZIP+4), Israel, Irlanda e Cingapura. Tanto na Irlanda quanto em Cingapura, os códigos postais fornecem detalhes exatos da localização até o número específico da casa.
Exemplos
- Sample request
-
Usar componente da consulta
{
"QueryComponents": {
"AddressNumber": "1368",
"PostalCode": "V5N 1T2"
}
}
Usar texto livre
{
"QueryText": "1368, V5N1T2"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointAddress",
"Title": "1368 E 8th Ave, Vancouver, BC V5N 1T2, Canada",
"Address": {
"Label": "1368 E 8th Ave, Vancouver, BC V5N 1T2, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Grandview-Woodland",
"PostalCode": "V5N 1T2",
"Street": "E 8th Ave",
"StreetComponents": [
{
"BaseName": "8th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "E",
"Language": "en"
}
],
"AddressNumber": "1368"
},
"Position": [
-123.07612,
49.26306
],
"MapView": [
-123.0775,
49.26216,
-123.07474,
49.26396
],
"AccessPoints": [
{
"Position": [
-123.07611,
49.26333
]
}
],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": {
"PostalCode": 1,
"AddressNumber": 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 '{
"QueryComponents": {
"AddressNumber": "1368",
"PostalCode": "V5N 1T2"
}
}'
- AWS CLI
-
aws geo-places geocode --key ${YourKey} --query-components '{"AddressNumber" : "1368", "PostalCode": "V5N 1T2"}'
Na Irlanda, o sistema Eircode atribui um código exclusivo a cada residência e empresa, enquanto em Cingapura, os códigos postais são igualmente específicos. Nos dois países, um código postal sozinho pode identificar um endereço exato: não há necessidade do nome da rua, da cidade ou do número da casa.
- Sample request
-
Usar componente da consulta
{
"QueryComponents": {
"PostalCode": "D02 X285"
}
}
Usar texto livre
{
"QueryText": "D02 X285"
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointAddress",
"Title": "29-31 Adelaide Road, Dublin, County Dublin, D02 X285, Ireland",
"Address": {
"Label": "29-31 Adelaide Road, Dublin, County Dublin, D02 X285, Ireland",
"Country": {
"Code2": "IE",
"Code3": "IRL",
"Name": "Ireland"
},
"SubRegion": {
"Code": "D",
"Name": "County Dublin"
},
"Locality": "Dublin",
"District": "Dublin 2",
"PostalCode": "D02 X285",
"Street": "Adelaide Road",
"StreetComponents": [
{
"BaseName": "Adelaide",
"Type": "Road",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "29-31"
},
"Position": [
-6.25549,
53.33207
],
"MapView": [
-6.257,
53.33117,
-6.25398,
53.33297
],
"AccessPoints": [
{
"Position": [
-6.25536,
53.33231
]
}
],
"MatchScores": {
"Overall": 1,
"Components": {
"Address": {
"PostalCode": 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 '{
"QueryComponents": {
"PostalCode": "D02 X285"
}
}'
- AWS CLI
-
aws geo-places geocode --key ${YourKey} --query-components '{"PostalCode": "V5N 1T2"}'
Dicas para o desenvolvedor
Saiba mais sobre ZIP+4 (Estados Unidos) e Eircode (Irlanda). Além disso, saiba mais sobre o sistema de código postal no Canadá, Reino Unido, Países Baixos, Cingapura e Israel.
