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 utilizando únicamente 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 función es compatible con Canadá, el Reino Unido, los Países Bajos, los Estados Unidos (ZIP+4), Israel, Irlanda y Singapur. Tanto en Irlanda como en Singapur, los códigos postales proporcionan detalles de ubicación exactos hasta el número de casa específico.

Ejemplos

Geocodifica una dirección con un código postal

Sample request

Utilice el componente de consulta

{
  "QueryComponents": {
    "AddressNumber": "1368",
    "PostalCode": "V5N 1T2"
  }
}

Usa 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"}'

Geocodificar una dirección con código postal en Singapur e Irlanda

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.

• Singapur: código postal de 6 dígitos

• Irlanda: código postal de 7 caracteres

Sample request

Utilice el componente de consulta

{
  "QueryComponents": {
    "PostalCode": "D02 X285"
  }
}

Usa 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 para desarrolladores

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á, el Reino Unido, los Países Bajos, Singapur e Israel.