动态加油站专题服务

1 产品介绍

动态加油站专题服务API是一套以HTTP形式提供的信息服务，包括根据位置搜索周边加油站服务，和获取加油站详细信息（包括动态油价）服务。 本套API免费对外开放，使用前您需先申请密钥（ak）。

2 功能介绍

• 周边加油站搜索：根据车辆位置查找周边加油站，返回离自己最近的加油站列表，主要为终端提供。

• 加油站详情：根据加油站编号获取加油站的详情信息，包括加油站动态油价、油品信息和基础信息。

3 周边加油站搜索

接口地址

http://wedrive.mapbar.com/opentsp/cms/api/gas/searchGasStation?parameters

请求参数

Name	Type	Required	Default	Description
ak	string	YES		访问授权秘钥
lon	double	YES		经度
lat	double	YES		纬度
cata	string	NO	XML	输出类型XML，Json，Jsonp
varname	string	NO		函数名，Jsonp格式时使用

返回值描述

Name	Type	Description	Remark
code	Integer	返回信息状态码
id	Long	加油站ID
pid	String	四维POI永久ID，加油站数据唯一标识
name	String	加油站名称
address	String	加油站地址
lon	Double	导航坐标的经度
lat	Double	导航坐标的纬度
displayLon	Double	显示坐标的经度
displayLat	Double	显示坐标的纬度
is24H	Int	是否24小时营业，0未调查，1是
openningTime	String	营业时间范围
tel	String	加油站电话

DEMO示例

http://wedrive.mapbar.com/opentsp/cms/api/gas/searchGasStation

参数	值	备注	必选
lon		经度	是
lat		纬度	是
cata		输出类型XML，Json，Jsonp	否
varname		函数名，Jsonp格式时使用	否

运行

5 加油站详情

接口地址

http://wedrive.mapbar.com/opentsp/cms/api/gas/searchGasStationById?parameters

请求参数

Name	Type	Required	Default	Description
ak	string	YES		访问授权秘钥
ids	string	YES		加油站编号，支持多id查询，用“,”分割
cata	string	NO	XML	输出类型XML，Json，Jsonp
varname	string	NO		函数名，Jsonp格式时使用

返回值描述

Name	Type	Description	Remark
code	Integer	返回信息状态码
id	Long	加油站ID
pid	String	四维POI永久ID，加油站数据唯一标识
name	String	加油站名称
address	String	加油站地址
lon	Double	导航坐标的经度
lat	Double	导航坐标的纬度
displayLon	Double	显示坐标的经度
displayLat	Double	显示坐标的纬度
is24H	Int	是否24小时营业，0未调查，1是
openningTime	String	营业时间范围
tel	String	加油站电话
oiltype	String	油品号类型，见油号对照表。多个油号用半角"｜"间隔
price	String	油品价格，价格对应油号，来源第三方数据。
brand	String	提供品牌有：中国石化；中国石油；加德士；埃克森美孚和東方；蜆殼Shell；南光石油Nkoil；易高Towngas；其他	可空
paymentType	String	付款方式：0 未知；6银联unionpay；7加油卡oilCard；13 现金；15储值(会员)卡；2信用卡；5借记卡；10八达通；	多种付款方式间使用半角 "｜" 分隔
bizState	Int	当前营业状态. 0-->未知； 1-->营业；2-->停业； 3-->撤销
bizStateDetails	String	营业状态具体说明. 例如: 停业原因，时间范围，加油站撤销等
discountDetails	String	包含：针对对象、优惠时段、优惠具体内容
hasStore	Int	是否有便利店 0-->未知； 1-->有； 2-->无
hasToilet	Int	是否有卫生间： 0-->未知； 1-->有； 2-->无
hasCarwash	Int	是否有洗车 0-->未知； 1-->有； 2-->无
hasMaintainence	Int	是否有是否有维修 0-->未知； 1-->有； 2-->无
hasRestaurant	Int	是否有餐饮：0-->未知； 1-->有； 2-->无
hasHotel	Int	是否有住宿 0-->未知； 1-->有； 2-->无
hasLubeChange	Int	是否有换油服务 0-->未知； 1-->有； 2-->无
hasRefuelDiy	Int	是否可以自助加油 0-->未知； 1-->有； 2-->无
facilityOthers	String	所能提供的其他服务设施描述

DEMO示例

http://wedrive.mapbar.com/opentsp/cms/api/gas/searchGasStationById

参数	值	备注	必选
ids		加油站编号，支持多id查询，用“,”分割	是
cata		输出类型XML，Json，Jsonp	否
varname		函数名，Jsonp格式时使用	否

运行