常见问题与排查

1. 为什么拿不到距离？ 关键词/输入提示通常不返回 distance；周边搜索才有。
2. 坐标顺序搞反？ 请求是 "lng,lat"；路线点返回是 latitude/longitude（命名不同易误读）。
3. 路线为什么没有 dist/duration/geoList？ 这些字段位于 results[].routes[] 内，不是 results[] 直接子节点；需要先取 results[i].routes[0]。
4. 驾车没返回路径点？ 默认不下发，需要设 setNeedPolyline(true)。
5. setRouteplanType 写错？ 它是 String（"0"/"1"），请使用常量 RouteParams.TYPE_PICKUP / TYPE_DROPOFF。
6. 公交 type 是什么？ 值域由服务端定义；展示优先用 name，避免强绑定。
7. polyline 很长怎么处理？ 不建议整段展示；仅显示点数、首末点及少量样例，需要渲染时解析。
8. 排障顺序：先看 status==10000 → 否则读 msg/traceId；再检查坐标字符串格式、城市参数（公交）、routeplan_type（驾车）。

---

附：字段名映射速记

• trace_id → traceId
• address_all → addressAll
• geo_list → geoList（位于 results[].routes[]，元素含 latitude/longitude）
• walking_distance → walkingDistance
• routeplan_type / eta_strategy / need_polyline / waypoints / strategy(驾车) / show_fields / route_num → 通过 RouteParams.set* 设置

---