如何从 Azure Maps 逆地理编码结果中提取县（County）信息-html教程-PHP中文网

如何从 Azure Maps 逆地理编码结果中提取县（County）信息

本文介绍如何在 Azure Maps 的逆地理编码（Reverse Geocoding）响应中精准提取 county 字段，替代默认的完整地址，通过访问 countrySecondarySubdivision 属性实现简洁、可靠的行政区划定位。

本文介绍如何在 azure maps 的逆地理编码（reverse geocoding）响应中精准提取 county 字段，替代默认的完整地址，通过访问 `countrysecondarysubdivision` 属性实现简洁、可靠的行政区划定位。

Azure Maps 的逆地理编码 API 在返回地址详情时，会结构化地提供多级地理行政信息（如国家、州/省、县、城市、街道等），而非仅依赖 freeformAddress 这一字符串字段。其中，countrySecondarySubdivision 是官方推荐用于表示“县”（County）或二级行政区（如美国的 County、英国的 District、加拿大的 Regional Municipality）的标准属性——它语义明确、结构稳定，且在多数地理区域具备良好覆盖。

在您当前的 mapClicked 函数中，只需将原用于拼接完整地址的 freeformAddress 替换为 countrySecondarySubdivision，并增加对应字段存在性校验即可。以下是优化后的关键代码段：

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 countyName = '';

        if (data.features.length > 0 && 
            data.features[0].properties?.address?.countrySecondarySubdivision) {

            countyName = data.features[0].properties.address.countrySecondarySubdivision;
            content += `<strong>County:</strong> ${countyName}`;
            theAddress = countyName; // 建议用语义化变量名替代模糊的 theAddress
        } else {
            content += '<em>County information unavailable</em>';
            theAddress = '';
        }

        content += '</div>';

        popup.setOptions({
            position: e.position,
            content: content
        });
        popup.open(map);
    }).catch(err => {
        console.error('Reverse geocoding failed:', err);
        popup.setOptions({
            position: e.position,
            content: '<div style="padding:10px"><em>Failed to retrieve location data.</em></div>'
        });
        popup.open(map);
    });
}

⚠️ 注意事项：

字段命名易混淆：countrySecondarySubdivision 并非“国家二级区划”的字面直译，而是 Azure Maps 对“县/郡/区”级行政单元的统一抽象命名（与 countrySubdivision 表示州/省对应）。请勿误用 county 或 administrativeArea2 等非标准字段。
地域兼容性：该字段在北美、西欧、澳大利亚等主流地区支持良好；但在部分国家（如中国、日本），因行政体系差异，可能返回空值或映射为“地级市”“都道府县”等上一级单位，建议结合 countrySubdivision 和 municipality 做兜底判断。
健壮性增强：示例中已采用可选链操作符（?.）并补充 .catch() 错误处理，避免因网络异常或无结果导致页面崩溃。