要展示附近加油站或按城市分页列站点，可接入极速车服加油站查询 API：附近查询用经纬度，城市查询用城市名，返回位置、电话、油价更新时间和发票服务标记。

适合哪些业务

导航、车队调度、加油优惠聚合、救援小程序和车主服务页，通常需要两类数据：以当前位置为中心找站点，或按城市浏览站点目录。极速车服官网将两类能力分别列为 nearby 和 city 接口。本文依据官网当前文档整理，示例只使用占位参数，未在本文中实际发起请求。

接口与输入

附近查询：GET/POST https://api.jisuepc.com/oilstation/nearby。必填 lat、lng、pagenum，可选 distance；距离默认 1000 米，最大 10000 米，单页 10 条。城市列表：GET/POST https://api.jisuepc.com/oilstation/city，必填 city、pagenum，单页 20 条。两者都需要 appkey，建议放在服务端配置中，不要下发到浏览器或小程序前端。

https://api.jisuepc.com/oilstation/nearby?lat=YOUR_LAT&lng=YOUR_LNG&distance=5000&pagenum=1&appkey=YOUR_APPKEY

经纬度应来自用户授权或设备定位；不要把地址文本直接当作经纬度，也不要在未授权时持续采集位置。城市查询中的城市名应由业务侧标准化，分页参数要做正整数校验。

返回结果如何使用

附近接口返回数组，常见字段包括 name、address、province、city、area、tel、distance、lat、lng 和 price。城市接口返回 total 与 list，站点项还可能包含 company、issalecard、iseinvoice、isvatinvoice。price 是油价信息对象，官网示例包含 oil89、oil92、oil95、oil98、oil0 和 updatetime。

展示时建议：距离按数值排序但保留原始值；电话为空时隐藏拨号按钮；服务标记按 0/1 转换为“未知或不支持/支持”，不要把空值推断成不支持；油价必须带上 updatetime，并在界面注明数据更新时间，不能当作当地实时挂牌价的无条件保证。

错误处理与重试

统一先判断 JSON 中的 status，成功通常为 0，再读取 result。鉴权失败、次数超限、IP 限制、维护或停用等系统错误应记录请求追踪号并停止盲目重试；网络超时可采用有限次数、指数退避。附近无结果时可以提示扩大距离，但不能把 10000 米以上的值直接提交。城市无结果时保留原查询条件，允许用户修正城市名。

安全与数据边界

appkey 不进日志、不写入客户端源码；经纬度属于位置数据，建议最小化保存并设置留存期限。缓存站点和油价时要同时缓存更新时间，过期后重新请求。该接口提供站点查询，不等于导航路线、库存、支付、会员权益或油品质量认证；若业务需要这些能力，应另行接入并展示来源。

上线前检查清单

  1. 核对官网当前接口路径、分页上限和套餐权限。
  2. 用脱敏定位测试空结果、重复站点、电话为空和油价缺失场景。
  3. 记录 status、耗时和接口版本，不记录 appkey 与精确位置原文。
  4. 在产品页标明“站点与油价信息以接口返回及更新时间为准”。

参考

关于极速车服

极速车服（JisuEPC）提供汽车后市场数据与接口服务。本文聚焦加油站查询 API 的附近定位、城市列表、站点字段与油价更新时间处理，不延伸为导航、支付、库存或油品质量服务；具体能力以官方文档为准。

标签：