直接调用百度/高德Web API无需SDK，只需HttpClient发HTTPS请求，注意AK/Key配置、坐标系匹配、配额限制及服务器网络环境。
直接调用百度/高德 Web API 不需要安装 SDK
你不需要在 C# 项目里引用任何“地图 SDK”或“GIS 组件”，只要能发 HTTP 请求，就能调用百度、高德的地理编码（地址转坐标）和逆地理编码（坐标转地址）接口。它们全是标准 RESTful 接口，返回 JSON，HttpClient 足够应付。
关键点是：必须注册开发者账号、创建应用、获取 ak（百度）或 key（高德），且注意配额和 HTTPS 强制要求。
- 百度 API 必须带
ak参数，且域名需在控制台白名单（本地开发可填localhost） - 高德 API 要求
key放 query string，部分接口还校验referer（浏览器端）或ip（服务端） - 所有请求必须走 HTTPS，HTTP 会直接返回 400 或重定向失败
用 HttpClient 发起地理编码请求（C# 示例）
比如把“北京市海淀区中关村大街27号”转成经纬度，用百度 API：
https://api.map.baidu.com/geocoding/v3/?address=北京市海淀区中关村大街27号&output=json&ak=YOUR_AK
对应 C# 实现要点：
- 用
HttpClient发 GET 请求，别用WebClient（已过时，不支持 async/await） - 对地址做 URL 编码，用
Uri.EscapeDataString("...")，不是HttpUtility.UrlEncode（后者依赖 System.Web） - 检查响应状态码 + 解析 JSON 里的
status字段，百度返回0才成功，高德是status=1 - 别硬写
ak在代码里，放配置文件或环境变量，避免泄露
示例片段：
var address = Uri.EscapeDataString("北京市海淀区中关村大街27号");
var url = $"https://api.map.baidu.com/geocoding/v3/?address={address}&output=json&ak={ak}";
var response = await client.GetAsync(url);
var json = await response.Content.ReadAsStringAsync();
// 然后用 System.Text.Json.JsonSerializer.Deserialize<BaiduGeoResponse>(json)定位标注不是前端的事，C# 只管算坐标
C# 本身不负责“在地图上画标记”，它只做两件事：拿到地址 → 拿到经纬度（地理编码），或拿到 GPS 坐标 → 拿到结构化地址（逆地理编码）。标注动作一定发生在前端（HTML + JS 调用百度/高德 JS API），或者移动端原生 SDK。
常见误解是想让 C# “直接渲染地图”，这不可行。你的服务层只需提供干净的坐标数据（如 { "lat": 39.9834, "lng": 116.3212 }），前端再传给 BMap.Map 或 AMap.Map 的 addMarker 方法。
- 如果前后端分离，API 返回字段建议统一用
latitude/longitude，别用lat/lng（易歧义） - 高德坐标系是 GCJ-02，百度是 BD-09，二者不互通；若前端用百度地图，后端解析必须用百度 API，否则标注偏移几百米
- 移动端采集的 GPS 坐标（WGS-84）要转百度/高德坐标系才能准确定位，C# 可调用百度提供的坐标转换接口
/geoconv/v1/，但有调用量限制
跨域、限流、HTTPS 证书是线上最容易崩的点
本地调试通了，一上服务器就 403 或空响应？大概率是这几个地方卡住：
- 服务器时间不准，导致百度签名过期（虽然 Web API 不签名校验，但某些企业版接口会）
- 公司防火墙或代理拦截了
api.map.baidu.com，表现为超时或 DNS 解析失败，用curl -v或telnet api.map.baidu.com 443先确认连通性 - 高德对单 IP 每日调用量有限制（免费版 1 万次/日），超限返回
{"status":"0","info":"QUOTA_OVER"}，得加缓存或降级逻辑 - .NET Core 默认不信任某些国产 CA（如百度云 SSL 证书），遇到
HttpRequestException: The SSL connection could not be established，需手动添加证书或禁用验证（仅测试）
真正难的不是怎么写那几行 HTTP 请求，而是把网络链路、配额策略、坐标系一致性这些隐性约束理清楚——它们不出现在代码里，但出问题时最费时间。
