调用HERE Places API搜索地点时如何获取场所真实细分分类

问题根因 #

• 调用v1版本搜索接口时，传入q=parking-facility作为查询参数，接口会默认将所有命中结果归为parking-facility通用大类，不会自动返回点位对应的细分停车子分类标签
• 调用单点位详情接口时，未配置分类返回的强制规则，接口默认仅回传大类聚合的categories字段，不会展开二级、三级的细分分类结构

可落地实现路径 #

调整搜索接口入参规则 #

• 替换原有的纯关键词查询逻辑，直接通过细分类目的标准category id做范围圈定，替代纯关键词匹配：
  • 露天停车场对应类目值为parking-lot
  • 室内停车楼/车库对应类目值为parking-garage
  • 专属停车区域对应类目值为only-parking
• 新增请求参数show=cat，强制接口在返回的点位条目内附带完整分类字段，替代默认的大类聚合返回逻辑
• 新增请求参数cat_scope=hierarchy，强制接口返回分类的完整层级树结构，避免仅返回最顶层的父分类标签

优化单点位详情接口调用逻辑 #

• 调用点位详情接口时，同样在请求参数中追加show=cat、cat_scope=hierarchy两个配置项，避免详情接口仅返回顶级聚合分类
• 不直接采信搜索接口返回的点位关联分类值，需通过详情接口拉取的分层category树，筛选匹配停车大类下的二级、三级细分标签

本地规则兜底机制 #

• 针对接口返回分类缺失的异常点位，基于点位的名称、附属描述做规则匹配补充分类：
  • 名称包含“地下/室内/停车楼”关键词的点位，标记为parking-garage
  • 名称包含“地面/露天/路边”关键词的点位，标记为parking-lot
• 将规则识别的分类值作为兜底项，补入点位清单的分类字段

注：以上方案无需切换接口服务版本，可直接在现有v1接口的调用流程内完成调整适配

内容的提问来源于stack exchange，提问作者WizoneDE