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 usando apenas o número da casa e o código postal. Essa prática é comum na logística de transporte e entrega de encomendas. Esse recurso é suportado no Canadá, Reino Unido, Países Baixos, Estados Unidos da América (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
-
Use o componente de consulta
{
"QueryComponents": {
"AddressNumber": "1368",
"PostalCode": "V5N 1T2"
}
}
Use 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. Em ambos os 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
-
Use o componente de consulta
{
"QueryComponents": {
"PostalCode": "D02 X285"
}
}
Use 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 desenvolvedores
Saiba mais sobre ZIP+4 (Estados Unidos da América) 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.
