symfony 6.4 集成百度地图需前端调用 js api 渲染地图，后端仅提供坐标、地理编码等接口；ak 必须通过服务配置注入、禁止硬编码，sk 须严格保密并用 symfony secrets 管理，同时配置 csp 和 referer 白名单确保安全。
要在 Symfony 6.4 项目中集成百度地图 API 实现地图功能，必须明确：Symfony 本身不提供地图渲染能力，需通过前端 JavaScript 调用百度地图 JS API，后端仅负责提供坐标数据、地址解析接口或安全签名逻辑。直接在 PHP 层“创建地图”是概念错误——地图渲染完全发生在浏览器中。
前端页面嵌入百度地图 JS API
第一步：前往 https://lbsyun.baidu.com/ 注册账号，进入控制台 → 应用管理 → 创建应用，获取 AK（Access Key）。注意勾选“Web服务API”和“JavaScript API”两个服务类型，否则加载地图时会报错 Illegal Request: Referer not allowed。
第二步：在 Symfony 模板文件（如 templates/map/index.html.twig）中引入百度地图 JS SDK：
<script src="https://api.map.baidu.com/api?v=3.0&ak=%E4%BD%A0%E7%9A%84AK"></script>
第三步：添加一个 DOM 容器，并初始化地图实例：
<div id="map" style="width:100%;height:500px;"></div><br><script><br> const map = new BMapGL.Map("map");<br> const point = new BMapGL.Point(116.404, 39.915); // 北京天安门坐标<br> map.centerAndZoom(point, 15);<br></script>
这一步操作起来很简单，直接把 script 标签贴进 Twig 模板 body 尾部即可。但注意：若使用 Symfony 的 Webpack Encore 构建流程，不应将 <script src="..."></script> 写死在模板里，而应通过 import 方式动态加载，避免 CSP 策略拦截。
后端提供地理编码与逆编码接口
百度地图前端 SDK 不允许直接调用其地理编码（地址→坐标）或逆编码（坐标→地址）接口，因涉及 AK 鉴权且需 Referer 白名单校验；这些请求必须由后端代理，否则浏览器会触发跨域拒绝或签名失败。
方法一：用 Symfony HttpClient 调用百度地图 Web 服务 API
在控制器中注入 Symfony\Contracts\HttpClient\HttpClientInterface，构造带签名的请求 URL：
百度要求对请求参数按字典序拼接后 + SK（Server Key）再做 MD5，例如：address=北京市海淀区中关村&output=json&ak=YOUR_AK → 拼上 &callback=1234567890（可选）→ 加密前字符串末尾追加 sk=YOUR_SK → md5(拼接串) → 得到 sn 参数。
关键点：【SK 必须严格保密，绝不可暴露在前端或 .env.local 中明文写入】。建议将 SK 存于服务器环境变量（如 Linux 的 /etc/environment），PHP 进程启动时读取，或通过 Symfony Secrets 管理（php bin/console secrets:set BAIDU_MAP_SK）。
方法二：封装为独立服务类（推荐）
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
创建 src/Service/BaiduMapService.php，封装地理编码逻辑：
public function geocode(string $address): array<br>{<br> $params = ['address' => $address, 'output' => 'json', 'ak' => $this->ak];<br> $sn = $this->generateSn($params);<br> $url = 'https://api.map.baidu.com/geocoding/v3/?' . http_build_query($params) . '&sn=' . $sn;<br> $response = $this->client->request('GET', $url);<br> return $response->toArray();<br>}
其中 generateSn() 必须严格按百度文档实现：参数键名升序排列 → 拼接 key=value 对（无空格、无编码）→ 追加 sk=xxx → UTF-8 编码后 MD5 → 小写十六进制字符串。
安全加载地图并防止 AK 泄露
第一步：禁用模板中硬编码 AK
不要在 Twig 中写 ak=xxxxx。改用 Symfony 的资产系统注入运行时参数：
在控制器中传入 'baidu_ak' => $this->getParameter('baidu.map.ak')，该参数从 config/services.yaml 的 parameters: 下定义，且 【不得写入 .env 文件】 —— 因为 .env 可能被意外提交至 Git 或被 Web 服务器错误暴露。
第二步：配置 Nginx/Apache 限制百度 API 域名 Referer
若使用反向代理，应在 Web 服务器层设置 add_header Referer "https://yourdomain.com"; 并在百度控制台白名单中填入 https://yourdomain.com/*，否则前端 JS 初始化地图时会返回 AK非法 错误。
第三步：启用 CSP 头防止外链脚本注入
在 config/packages/security.yaml 中配置：
csp:<br> default-src 'self';<br> script-src 'self' 'unsafe-inline' https://api.map.baidu.com;<br> img-src 'self' data: https:;<br> connect-src 'self' https://api.map.baidu.com;
这一步必须做，否则现代浏览器会拦截百度地图 JS 脚本加载。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
