Country filter

The /geocode endpoint allows limiting results by one or several countries. This is useful to avoid ambiguity and unexpected results when you know that all the addresses are located in a specific country.

For example, for the query 20 Victoria St, London the /geocode would return two results - one in England and one in Canada.

If your application only works with addresses in the USA and Canada, you can limit the result by these two countries with parameter in=countryCode:CAN,USA

The query can be formulated with the following:


Authorization: Bearer [your token]

The response to the above request contains a single result in Canada and looks like the following:

  "items": [
      "title": "20 Victoria St, London, ON N6A, Canada",
      "id": "here:af:streetsection:YOrVG8JgXxLvp3Qomjb.SB:EAIaAjIwKGQ",
      "resultType": "houseNumber",
      "houseNumberType": "interpolated",
      "address": {
        "label": "20 Victoria St, London, ON N6A, Canada",
        "countryCode": "CAN",
        "countryName": "Canada",
        "stateCode": "ON",
        "state": "Ontario",
        "county": "Middlesex",
        "city": "London",
        "district": "North London",
        "street": "Victoria St",
        "postalCode": "N6A",
        "houseNumber": "20"
      "position": {
        "lat": 43.0009,
        "lng": -81.2681
      "access": [
          "lat": 43.00078,
          "lng": -81.26803
      "mapView": {
        "west": -81.26933,
        "south": 43,
        "east": -81.26687,
        "north": 43.0018
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "streets": [
          "houseNumber": 1

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

results matching ""

    No results matching ""