Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cómo geocodificar un número de dirección con un código postal
En los países donde los códigos postales son muy específicos (enlazan solo unas pocas direcciones de la misma calle), se puede encontrar una dirección solo mediante el número de casa y el código postal. Esta práctica es común en la logística de transporte y entrega de paquetes. Esta característica está admitida en Canadá, Reino Unido, Países Bajos, Estados Unidos (ZIP+4), Israel, Irlanda y Singapur. En Irlanda y en Singapur, los códigos postales proporcionan detalles de ubicación exactos hasta el número de casa específico.
Ejemplos
- Sample request
-
Uso de componente de consulta
{
"QueryComponents": {
"AddressNumber": "1368",
"PostalCode": "V5N 1T2"
}
}
Uso de texto libre
{
"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"}'
En Irlanda, el sistema Eircode asigna un código único a cada hogar y empresa, mientras que en Singapur, los códigos postales son igualmente específicos. En ambos países, un código postal por sí solo puede identificar una dirección exacta: no es necesario indicar el nombre de la calle, la ciudad o el número de casa.
- Sample request
-
Uso de componente de consulta
{
"QueryComponents": {
"PostalCode": "D02 X285"
}
}
Uso de texto libre
{
"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"}'
Consejos de desarrolladores
Obtenga más información sobre ZIP+4 (Estados Unidos) y Eircode (Irlanda). Además, obtenga información sobre el sistema de códigos postales en Canadá, Reino Unido, Países Bajos, Singapur e Israel.
