Japan

To reflect the Japanese administrative system and to support Japan use cases, we provide a response that includes block and subblock as additional hierarchical structures to support the country-specific scheme like chiban, aza, etc.

Getting Credentials

Use of Geocoding and Search Japan requires a premium credential. For more information, see Get Credentials.

Discover

For more information, see Discover.

To discover the nearest station at the geo-position (35.6899274, 139.8268034) use the following request:

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=35.6899274%2C139.8268034
    &q=駅
    &limit=2

Authorization: Bearer [your token]

The response to the above request is the following:

{
   "items": [
      {
         "title": "飯田橋駅",
         "id": "here:xs1:place:55410615",
         "resultType": "place",
         "address": {
            "label": "東京都千代田区飯田橋駅",
            ...
         }
         ...
      }
      {
         "title": "東京地下鉄(株)/定期券うりば飯田橋駅定期券うりば",
         "id": "here:xs1:place:66464836",
         "resultType": "place",
         "address": {
            "label": "東京都千代田区東京地下鉄(株)/定期券うりば飯田橋駅定期券うりば",
            ...
         }
         ...
      }
   ]
}

Geocode

For more information, see Geocode.

A free-form text query for address in Tokyo, 港区六本木6-10-1 is the following:

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=港区六本木6-10-1

Authorization: Bearer [your token]

The response to the above request is the following:

{
   "items": [
      {
         "title": "〒106-0032 東京都港区六本木6丁目10-1",
         "id": "here:xs1:pointaddress:912923:CgcIBCDou8cNEAEaA--8kShk",
         "resultType": "houseNumber",
         "houseNumberType": "PA",
         "address": {
            "label": "〒106-0032 東京都港区六本木6丁目10-1",
            "countryCode": "JPN",
            "countryName": "日本",
            "state": "東京都",
            "city": "港区",
            "subdistrict": "六本木",
            "block": "6丁目",
            "subblock": "10",
            "postalCode": "106-0032",
            "houseNumber": "1"
         },
         "position": {
            "lat": 35.66045,
            "lng": 139.72923
         },
         "access": [
            {
               "lat": 35.66045,
               "lng": 139.72923
            }
         ],
         "mapView": {
            "west": 139.72812,
            "south": 35.65955,
            "east": 139.73034,
            "north": 35.66135
         },
         "scoring": {
            "queryScore": 1,
            "fieldScore": {
               "city": 1,
               "subdistrict": 1,
               "block": 1,
               "subblock": 1,
               "houseNumber": 1
            }
         }
      }
   ]
}

A free-form text query for address in Kumamoto Prefecture, 熊本県菊池郡大津町引水18-3 is the following:

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=熊本県菊池郡大津町引水18-3

Authorization: Bearer [your token]

The response to the above request is the following:

{
   "title": "〒869-1234 熊本県菊池郡大津町引水18-3",
   "id": "here:xs1:pointaddress:502437120:CgcIBCCC0foXEAEaA--8kyhk",
   "resultType": "houseNumber",
   "houseNumberType": "PA",
   "address": {
      "label": "〒869-1234 熊本県菊池郡大津町引水18-3",
      "countryCode": "JPN",
      "countryName": "日本",
      "state": "熊本県",
      "county": "菊池郡",
      "city": "大津町",
      "subdistrict": "引水",
      "subblock": "18",
      "postalCode": "869-1234",
      "houseNumber": "3"
   },
   "position": {
      "lat": 32.87821,
      "lng": 130.87493
   },
   "access": [
      {
         "lat": 32.87821,
         "lng": 130.87493
      }
   ],
   "mapView": {
      "west": 130.87386,
      "south": 32.87731,
      "east": 130.876,
      "north": 32.87911
   }
}

Autosuggest

For more information, see Autosuggest.

For 大学 suggestions intending to have 大学病院 somewhere in Tokyo, a query would be the following:

GET https://autosuggest.search.hereapi.com/v1/
    autosuggest
    ?at=35.6990575,139.7623009
    &q=大学
    &limit=2

Authorization: Bearer [your token]

And the response is the following:

{
  "items": [
    {
      "title": "大学進学センター",
      "id": "here:xs1:place:67023767",
      "resultType": "place",
      "address": {
        "label": "東京都千代田区大学進学センター",
        "countryCode": "JPN",
        "countryName": "日本",
        "state": "東京都",
        "city": "千代田区"
      },
      "distance": 797,
      "categories": [
        {
          "id": "800-8200-0000",
          "name": "教育施設"
        }
      ],
      "highlights": {
        "title": [
          {
            "start": 0,
            "end": 2
          }
        ],
        "address": {
          "label": [
            {
              "start": 7,
              "end": 9
            }
          ]
        }
      }
    },
    {
      "title": "大学図書",
      "id": "here:xs1:place:66761453",
      "resultType": "place",
      "address": {
        "label": "東京都千代田区大学図書",
        "countryCode": "JPN",
        "countryName": "日本",
        "state": "東京都",
        "city": "千代田区"
      },
      "distance": 346,
      "categories": [
        {
          "id": "600-6700-0000",
          "name": "ブックショップ"
        }
      ],
      "highlights": {
        "title": [
          {
            "start": 0,
            "end": 2
          }
        ],
        "address": {
          "label": [
            {
              "start": 7,
              "end": 9
            }
          ]
        }
      }
    }
  ],
  "queryTerms": []
}

Browse

For more information, see Browse.

For example, a customer application wants to expose an icon representing a convenience store, and use the category id 600-6000-0061 as the value for the categories parameter of a /browse query:

GET https://browse.search.hereapi.com/v1/
    browse
    ?at=35.7064554,139.7398739
    &categories=600-6000-0061
    &limit=2

Authorization: Bearer [your token]
{
   "items": [
      {
         "title": "ファミリーマート東五軒町店",
         "id": "here:xs1:place:66741668",
         "resultType": "place",
         "address": {
            "label": "東京都新宿区ファミリーマート東五軒町店",
            "countryCode": "JPN",
            "countryName": "日本",
            "state": "東京都",
            "city": "新宿区"
         },
         "distance": 41,
         "categories": [
            {
               "id": "600-6000-0061"
            }
         ]
      },
      {
         "title": "セブン-イレブン新宿東五軒町店",
         "id": "here:xs1:place:66468563",
         "resultType": "place",
         "address": {
            "label": "東京都新宿区セブン-イレブン新宿東五軒町店",
            "countryCode": "JPN",
            "countryName": "日本",
            "state": "東京都",
            "city": "新宿区"
         },
         "distance": 142,
         "categories": [
            {
               "id": "600-6000-0061"
            }
         ]
      }
   ]
}

Lookup by ID

For more information, see Lookup.

The HERE ID for 札幌站(Sapporo Station) is here:xs1:place:55409089. To retrieve details for such a place, send the following request:

GET https://lookup.search.hereapi.com/v1/
    lookup
    ?id=here:xs1:place:55409089

Authorization: Bearer [your token]

The response to the above query is the following:

{
   "title": "札幌站",
   "id": "here:xs1:place:55409089",
   "resultType": "place",
   "address": {
      "label": "日本北海道札幌市北区札幌站",
      "countryCode": "JPN",
      "countryName": "日本",
      "state": "北海道",
      "city": "札幌市",
      "district": "北区"
   },
   "position": {
      "lat": 43.06859,
      "lng": 141.35075
   },
   "access": [
      {
         "lat": 43.06859,
         "lng": 141.35075
      }
   ],
   "categories": [
      {
         "id": "400-4100-0035"
      }
   ]
}

Reverse Geocode

For more information, see Reverse Geocode.

For example, a user selects a point on a map in Yokohama, and submits the map geocoordinates in a request to the revgeocode endpoint as the following:

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=35.4548435%2C139.6304529
    &lang=ja-JP

Authorization: Bearer [your token]

The response shows the nearest address available.

{
   "items": [
      {
         "title": "神奈川県横浜市西区みなとみらい2丁目2-1",
         "id": "here:xs1:pointaddress:1050762:Ch0SFmhlcmU6eHMxOnBvaW50YWRkcmVzczogqvPkDhABGgPvvJE",
         "resultType": "houseNumber",
         "houseNumberType": "PA",
         "address": {
            "label": "神奈川県横浜市西区みなとみらい2丁目2-1",
            "countryCode": "JPN",
            "countryName": "日本",
            "state": "神奈川県",
            "city": "横浜市",
            "district": "西区",
            "subdistrict": "みなとみらい",
            "block": "2丁目",
            "subblock": "2",
            "houseNumber": "1"
         },
         "position": {
            "lat": 35.4548,
            "lng": 139.63087
         },
         "access": [
            {
               "lat": 35.4548,
               "lng": 139.63087
            }
         ],
         "distance": 39,
         "mapView": {
            "west": 139.62987,
            "south": 35.45365,
            "east": 139.63282,
            "north": 35.45636
         }
      }
   ]
}

results matching ""

    No results matching ""