feat: poi id required

docs/frontend_api.md

@@ -111,7 +111,8 @@ Content-Type: application/json
   - 当前固定为 `driving`
 - `need_deep_link`
   - 可选
-  - 是否需要生成 deep link
+  - 当前必须为 `true`
+  - 该服务的成功结果必须包含 deep link
 - `deep_link_mode`
   - 可选
   - 可选值：`personal_map`、`route_plan`、`auto`
@@ -260,6 +261,7 @@ Content-Type: application/json
 - `deep_links`
   - 给前端做按钮跳转使用
   - 这是唯一应被前端当作链接处理的字段
+  - 当前成功结果至少会包含 `personal_map`
 - `summary`
   - 可直接展示给用户的简要说明
   - 这是纯展示文案，不是结构化链接字段，也不应被前端解析为跳转地址
@@ -324,6 +326,7 @@ Content-Type: application/json
 补充说明：
 
 - `deep_links` 中可能同时存在多个字段，也可能只有其中一个字段有值
+- 当前实现中，成功结果会强制生成 `personal_map`
 - 前端应只根据 `deep_links` 的字段值控制按钮展示，不要依赖 `summary` 推断应展示哪个按钮
 - `summary` 里可能会提到“个人地图链接”或“导航链接”，但这里只是说明文字，不保证包含真实 URL
 - 如果 `personal_map` 存在，表示当前更适合导入点位方案
@@ -343,8 +346,11 @@ Content-Type: application/json
 
 - 请求结构不合法
 - `stops` 为空
+- `need_deep_link=false`
 - 固定起点缺少 `origin_address`
 - 终点同时出现在 `stops`
+- 任意点未能解析到足够精确的 POI
+- 任意点缺少 `poi_id`
 - 请求候选上限超过服务上限
 - 实际排列数超过上限