China

There is an independent Geocoding and Search deployment in China which is leveraging on the rich map and place content for China mainland, Hong Kong and Macau (excluding Taiwan). The coordinate system is GCJ-02.

So far, Discover, Geocode, Autosuggest and Lookup endpoints are supported in China deployment.

Getting Credentials

Use of Geocoding and Search China requires credentials. For more information, see Get Credentials.

Discover

For more information, see Discover.

To discover the 天安门 at the geo-position (39.9090003, 116.3975865) use the following request:

GET https://discover.search.hereapi.cn/v1/
    discover
    ?at=39.9090003,116.3975865
    &q=天安门
    &limit=2

Authorization: Bearer [your token]

The response to the above request is the following:

{
  "items": [
    {
      "title": "天安门城楼",
      "id": "here:cm:place:28066",
      "resultType": "place",
      "address": {
        "label": "中国北京市东城区东长安街天安门城楼, 邮编: 100006",
        "countryCode": "CHN",
        "countryName": "中国",
        "state": "北京市",
        "city": "北京市",
        "district": "东城区",
        "street": "东长安街",
        "postalCode": "100006"
      },
      "position": {
        "lat": 39.90887,
        "lng": 116.3974
      },
      "access": [
        {
          "lat": 39.90869,
          "lng": 116.39752
        }
      ],
      "distance": 22,
      "categories": [
        {
          "id": "300-3000-0023"
        }
      ]
    },
    {
      "title": "天安门广场",
      "id": "here:cm:place:1354864",
      "resultType": "place",
      "address": {
        "label": "中国北京市东城区长安街天安门广场",
        "countryCode": "CHN",
        "countryName": "中国",
        "state": "北京市",
        "city": "北京市",
        "district": "东城区",
        "street": "长安街"
      },
      "position": {
        "lat": 39.90639,
        "lng": 116.39764
      },
      "access": [
        {
          "lat": 39.90521,
          "lng": 116.39949
        }
      ],
      "distance": 290,
      "categories": [
        {
          "id": "300-3000-0023"
        }
      ]
    }
  ]
}

Geocode

For more information, see Geocode.

A free-form text query for address in Beijing, 北京市朝阳区建国门外大街1号 is the following:

GET https://geocode.search.hereapi.cn/v1/
    geocode
    ?q=北京市朝阳区建国门外大街1号

Authorization: Bearer [your token]

The response to the above request is the following:

{
  "items": [
    {
      "title": "中国北京市朝阳区建国门外大街1号",
      "id": "here:af:streetsection:rQA.ueJXaObRchI4UdNO3C:CgcIBCDdqZkDEAEaATEiEuWbvei0uOWVhuWfjuS4ieacnyhk",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "中国北京市朝阳区建国门外大街1号",
        "countryCode": "CHN",
        "countryName": "中国",
        "state": "北京市",
        "city": "北京市",
        "district": "朝阳区",
        "subdistrict": "国贸",
        "street": "建国门外大街",
        "houseNumber": "1"
      },
      "position": {
        "lat": 39.91244,
        "lng": 116.45971
      },
      "access": [
        {
          "lat": 39.91238,
          "lng": 116.45969
        }
      ],
      "mapView": {
        "west": 116.45854,
        "south": 39.91154,
        "east": 116.46088,
        "north": 39.91334
      }
    }
  ]
}

Autosuggest

For more information, see Autosuggest.

For 酒店 suggestions intending to have somewhere in Shanghai, a query would be the following:

GET https://autosuggest.search.hereapi.cn/v1/
    autosuggest
    ?at= 31.2373203, 121.4999525
    &q=酒店
    &limit=2

Authorization: Bearer [your token]

And the response is the following:

{
  "items": [
    {
      "title": "东方滨江大酒店",
      "id": "here:cm:place:1287479",
      "resultType": "place",
      "address": {
        "label": "中国上海市浦东新区滨江大道2727号东方滨江大酒店, 邮编: 200120",
        "countryCode": "CHN",
        "countryName": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "浦东新区",
        "street": "滨江大道",
        "postalCode": "200120",
        "houseNumber": "2727"
      },
      "distance": 363,
      "categories": [
        {
          "id": "500-5000-0053"
        }
      ],
      "highlights": {
        "title": [
          {
            "start": 5,
            "end": 7
          }
        ],
        "address": {
          "label": [
            {
              "start": 23,
              "end": 25
            }
          ]
        }
      }
    },
    {
      "title": "船长酒店",
      "id": "here:cm:place:77352",
      "resultType": "place",
      "address": {
        "label": "中国上海市黄浦区福州路37号船长酒店, 邮编: 200002",
        "countryCode": "CHN",
        "countryName": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "黄浦区",
        "street": "福州路",
        "postalCode": "200002",
        "houseNumber": "37"
      },
      "distance": 1023,
      "categories": [
        {
          "id": "500-5000-0053"
        }
      ],
      "highlights": {
        "title": [
          {
            "start": 2,
            "end": 4
          }
        ],
        "address": {
          "label": [
            {
              "start": 16,
              "end": 18
            }
          ]
        }
      }
    }
  ]
}

Lookup by ID

For more information, see Lookup.

The HERE ID for 广州站 is here:cm:place:120985. To retrieve details for such a place, send the following request:

GET https://lookup.search.hereapi.cn/v1/
    lookup
    ?id=here:cm:place:120985

Authorization: Bearer [your token]

The response to the above query is the following:

{
  "title": "广州站",
  "id": "here:cm:place:120985",
  "resultType": "place",
  "address": {
    "label": "中国广东省广州市越秀区环市西路159号广州站, 邮编: 510160",
    "countryCode": "CHN",
    "countryName": "中国",
    "state": "广东省",
    "city": "广州市",
    "district": "越秀区",
    "street": "环市西路",
    "postalCode": "510160",
    "houseNumber": "159"
  },
  "position": {
    "lat": 23.14874,
    "lng": 113.25776
  },
  "access": [
    {
      "lat": 23.14723,
      "lng": 113.25728
    }
  ],
  "categories": [
    {
      "id": "400-4100-0035"
    }
  ]
}

results matching ""

    No results matching ""