本文介绍如何在 Azure Maps 的逆地理编码（Reverse Geocoding）响应中精准提取 county（郡/县）字段，而非返回完整地址，并提供可直接使用的代码修改方案与注意事项。
本文介绍如何在 azure maps 的逆地理编码（reverse geocoding）响应中精准提取 `county`（郡/县）字段，而非返回完整地址，并提供可直接使用的代码修改方案与注意事项。
Azure Maps 的逆地理编码 API 在返回地址结构化数据时，将地理行政层级细分为多个标准化字段。其中，countrySecondarySubdivision 字段通常对应美国等国家的“County”（郡/县），而非字面意义的“国家次级行政区”——这是 Azure Maps 官方文档中对美国县级行政单位的规范映射（参见 Azure Maps Address Model）。
在您当前的 mapClicked 函数中，原始逻辑通过 freeformAddress 获取整段文本地址。要仅提取郡县，需改用结构化地址对象中的精确字段。以下是优化后的关键代码段：
function mapClicked(e) {
searchURL.searchAddressReverse(atlas.service.Aborter.timeout(3000), e.position, {
view: 'Auto'
}).then(results => {
const data = results.geojson.getFeatures();
let content = '<div style="padding:10px">';
let county = '';
if (data.features.length > 0 &&
data.features[0].properties?.address?.countrySecondarySubdivision) {
county = data.features[0].properties.address.countrySecondarySubdivision;
content += `<strong>County:</strong> ${county}`;
theAddress += county; // 注意：此处建议统一使用 county 变量，避免拼接 HTML 字符串到 theAddress
} else {
content += 'County information unavailable for this location.';
}
content += '</div>';
popup.setOptions({
position: e.position,
content: content
});
popup.open(map);
}).catch(error => {
console.error('Reverse geocoding failed:', error);
popup.setOptions({
position: e.position,
content: '<div style="padding:10px"><strong>Error:</strong> Unable to retrieve county.</div>'
});
popup.open(map);
});
}✅ 关键改进说明：
- 使用可选链操作符（
?.）提升健壮性，避免因嵌套属性缺失导致运行时错误； - 明确区分展示内容（HTML）与业务变量（如
theAddress），推荐将theAddress赋值为纯文本county，而非含标签的content； - 增加
.catch()处理网络或服务异常，提升用户体验与调试能力。
⚠️ 注意事项：
-
countrySecondarySubdivision并非全球通用：在英国对应“county”，在美国为“county”，但在加拿大可能为空或映射为“census subdivision”，日本则无直接对应字段。建议结合countryCode和municipality等字段做区域性兜底； - 若需更高精度（如排除“City of London”等特殊郡级单位），可进一步检查
address.county（部分响应中存在）或调用searchAddressReverseGeocode的type参数限定为CountrySubdivision2； - 生产环境建议添加加载状态提示，防止用户重复点击触发多请求。
通过以上调整，您即可稳定、高效地从 Azure Maps 逆地理编码结果中提取目标郡县名称，满足精细化地理信息展示需求。
