Address lookup by postal code and house number (NLD, USA)

In the Netherlands and the United States, people are used to use only house numbers and postal codes to find addresses - without street names, cities or neighborhoods. It is heavily used in transport and parcel logistics. To support this use case, the /geocode endpoint supports qualified queries, which consist of house numbers and postal codes only. This feature is available for these two countries only.

The postal codes should have the following precisions:

  • for the USA: "zip+4"
  • for the Netherlands: four digits, followed by two letters

For example, an address "425 W Randolph St, Chicago, IL 60606-1506, United States" can be also found by specifying only house number and postal code:

  • houseNumber=425
  • postalCode=60606-1506

The query can be formulated with the following:

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        houseNumber=425;
        postalCode=60606-1506

Authorization: Bearer [your token]

The response to the above request has only two matched fields: house number and postal code, but the result type is the complete address:

{
  "items": [
    {
      "title": "425 W Randolph St, Chicago, IL 60606-1506, United States",
      "id": "here:af:streetsection:hdZ6xBRUraY46IQZCqZidD:CgcIBCDMlOElEAEaAzQyNShk",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "425 W Randolph St, Chicago, IL 60606-1506, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "state": "Illinois",
        "county": "Cook",
        "city": "Chicago",
        "district": "West Loop",
        "street": "W Randolph St",
        "postalCode": "60606-1506",
        "houseNumber": "425"
      },
      "position": {
        "lat": 41.88432,
        "lng": -87.63877
      },
      "access": [
        {
          "lat": 41.88449,
          "lng": -87.63877
        }
      ],
      "mapView": {
        "west": -87.63998,
        "south": 41.88342,
        "east": -87.63756,
        "north": 41.88522
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "houseNumber": 1,
          "postalCode": 1
        }
      }
    }
  ]
}

More details about /geocode parameters can be found in the API Reference.

results matching ""

    No results matching ""