Here API自动提示接口缺失所需地址字段问题咨询

我在用Here API的autosuggest接口实现城市建议功能，按照官方文档说明，期望从响应中获取country、countryCode、city和cityCode字段，但实际返回的address对象仅包含label字段。

请求示例 #

https://autosuggest.search.hereapi.com/v1/autosuggest?apiKey=XXX&at=0,0&q=Eismieze Berlin&lang=en&resultTypes=locality

响应示例 #

"items": [
    {
        "title": "Berlin, Germany",
        "id": "here:cm:namedplace:20187403",
        "resultType": "locality",
        "localityType": "city",
        "address": {
            "label": "Berlin, Germany"
        },
        "position": {
            "lat": 52.51604,
            "lng": 13.37691
        },
        "distance": 5971050,
        "mapView": {
            "west": 13.08835,
            "south": 52.33812,
            "east": 13.761,
            "north": 52.6755
        },
        "highlights": {
            "title": [
                {
                    "start": 0,
                    "end": 6
                }
            ],
            "address": {
                "label": [
                    {
                        "start": 0,
                        "end": 6
                    }
                ]
            }
        }
    }
]

解决方案 #

• 添加show-address-details参数：在请求URL中追加show-address-details=true，该参数会触发接口返回完整的地址拆分字段，包含你需要的country、countryCode、city、cityCode。
  修改后的请求：

  https://autosuggest.search.hereapi.com/v1/autosuggest?apiKey=XXX&at=0,0&q=Eismieze Berlin&lang=en&resultTypes=locality&show-address-details=true
  

• 预期返回结构：添加参数后，address对象会包含细分字段，示例如下：

  "address": {
      "label": "Berlin, Germany",
      "city": "Berlin",
      "cityCode": "BER",
      "country": "Germany",
      "countryCode": "DE"
  }
  

• 参数说明：show-address-details是Geocoding & Search API v7的内置参数，无需额外权限，只要你的API密钥有效即可使用。

内容的提问来源于stack exchange，提问作者Hassan Golshani