文档中心 > API类目 > 斑马充电中台开放API

yunos.charge.map.station.range.search (充电地图范围站点搜索)

充电地图范围站点搜索

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_range_station_map_search_qry RangeStationMapSearchQry 可选 请求参数
  • └ car_model
  • String
  • 可选
  • 300107
  • carMode
  • └ classify_data
  • String
  • 可选
  • spList=313744932,395815801,-1;parkFee=1,2
  • 筛选条件
  • └ enable_aggregation
  • Boolean
  • 可选
  • true
  • 是否启用聚合
  • └ lat
  • String
  • 可选
  • 39.91436513
  • 纬度
  • └ lng
  • String
  • 可选
  • 116.3943381
  • 经度
  • └ map_scale
  • Number
  • 可选
  • 500
  • 缩放比例
  • └ need_classify
  • Boolean
  • 可选
  • true
  • 是否需要筛选项
  • └ need_dynamic
  • Boolean
  • 可选
  • true
  • 是否需要动态数据
  • └ page_index
  • Number
  • 可选
  • 1
  • 页号
  • └ page_size
  • Number
  • 可选
  • 10
  • 页大小
  • └ range
  • Number
  • 可选
  • 3000
  • 搜索范围
  • └ range_expand
  • Number
  • 可选
  • 1
  • 是否扩大范围搜1标识需要扩大
  • └ search_type
  • String
  • 可选
  • near
  • near或者keywords
  • └ sort
  • Number
  • 可选
  • 1
  • 排序方式参考返回的sortConfig的定义
  • └ source
  • String
  • 可选
  • car
  • 请求来源
  • └ trace_id
  • String
  • 可选
  • xxxxxx-test-trace
  • traceId
  • └ user_loc
  • String
  • 可选
  • 116.3943381,39.91436513
  • 经纬度
  • └ vin
  • String
  • 可选
  • roewe11111
  • 车架号
  • └ zid
  • String
  • 可选
  • 10000000063263
  • 斑马用户账号
  • └ ext
  • String
  • 可选
  • {"version":"venus-2.0"}
  • 车机基础信息

响应参数

名称 类型 示例值 描述
result MapResponse 返回数据
  • data
  • StationMapSearchResp
  • 返回数据实际内容
  • └ classify
  • Json
  • []
  • 筛选项
  • └ code
  • Number
  • -1
  • 错误码
  • └ comb_content
  • String
  • []
  • 聚合结果
  • └ cost_time
  • Number
  • 11200
  • 累计耗时
  • └ data
  • Json
  • []
  • 离散结果
  • └ icon_url
  • String
  • http://123.png
  • 图标扎点地址
  • └ info
  • String
  • 参数错误
  • 执行信息
  • └ more
  • Json
  • []
  • 额外信息
  • └ msg
  • String
  • 参数错误
  • 额外消息
  • └ page_index
  • Number
  • 1
  • 页号
  • └ page_size
  • Number
  • 10
  • 页大小
  • └ sort_config
  • Json
  • []
  • 排序配置
  • └ success
  • Boolean
  • true
  • true
  • └ total
  • Number
  • 20
  • 总记录数
  • └ err_code
  • String
  • -1004
  • 错误码
  • └ err_message
  • String
  • 参数错误
  • 错误信息
  • └ success
  • String
  • false
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
YunosChargeMapStationRangeSearchRequest req = new YunosChargeMapStationRangeSearchRequest();
YunosChargeMapStationRangeSearchRequest.RangeStationMapSearchQry obj1 = new YunosChargeMapStationRangeSearchRequest.RangeStationMapSearchQry();
obj1.setCarModel("300107");
obj1.setClassifyData("spList=313744932,395815801,-1;parkFee=1,2");
obj1.setEnableAggregation(true);
obj1.setLat("39.91436513");
obj1.setLng("116.3943381");
obj1.setMapScale(500L);
obj1.setNeedClassify(true);
obj1.setNeedDynamic(true);
obj1.setPageIndex(1L);
obj1.setPageSize(10L);
obj1.setRange(3000L);
obj1.setRangeExpand(1L);
obj1.setSearchType("near");
obj1.setSort(1L);
obj1.setSource("car");
obj1.setTraceId("xxxxxx-test-trace");
obj1.setUserLoc("116.3943381,39.91436513");
obj1.setVin("roewe11111");
obj1.setZid("10000000063263");
obj1.setExt("{\"version\":\"venus-2.0\"}");
req.setParamRangeStationMapSearchQry(obj1);
YunosChargeMapStationRangeSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<yunos_charge_map_station_range_search_response>
    <result>
        <data>
            <classify>[]</classify>
            <code>-1</code>
            <comb_content>[]</comb_content>
            <cost_time>11200</cost_time>
            <data>[]</data>
            <icon_url>http://123.png</icon_url>
            <info>参数错误</info>
            <more>[]</more>
            <msg>参数错误</msg>
            <page_index>1</page_index>
            <page_size>10</page_size>
            <sort_config>[]</sort_config>
            <success>true</success>
            <total>20</total>
        </data>
        <err_code>-1004</err_code>
        <err_message>参数错误</err_message>
        <success>false</success>
    </result>
</yunos_charge_map_station_range_search_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部