查询司机位置接口

更新时间： 2022-10-17 在中国大陆提供服务的供应商必须接入，在中国港澳台地区及境外地区提供服务的供应商建议接入，在线调试（沙箱环境）

接口概述

1、该接口用来查询接单司机的实时位置，提升用车体验；同时平台会对行程数据进行追溯，需要定期查询司机的位置。
2、接送场景下，携程会从用车前一小时开始请求；打车场景下，携程会在司机出发接乘客后开始请求（特别地，立即打车场景下，司机接单即视为出发接乘客）；供应商需要在300ms内返回位置信息。
3、如：需要司机位置的订单是1000单，每一批至少查询20单；供应商能支持在300ms内返回位置信息的单批次查询量越大越好。
4、服务完成后请及时推送订单完成状态，携程即停止查询，否则携程会在行程开始时间12小时后停止查询；如果出现司机掉线等异常情况，需要给出最后一次获取经纬度的数据。
5、建议供应商每隔5秒更新一次司机位置，最长10秒更新一次

请求地址

地址格式: {Domain}/{Channel}/querydriverlocation/2.0/{timeStamp}/{sign}

请求内容

QueryDriverLocationRequest

参数	类型	必传	描述	示例	备注
orderInfo	List<OrderInfoDTO>	是	订单信息
serviceProviderId	String	否	服务商ID	1000000	用于多服务商接入场景，需要的供应商请联系我方技术添加

OrderInfoDTO

参数	类型	必传	描述	示例	备注
ctripPurchaseOrderId	Long	是	携程采购单号	881823967638342968	18位
vendorOrderId	string	是	供应商订单号
startTime	string	否	上次收集时间		点位收集时间 yyyy-MM-dd HH:mm:ss，返回上次收集时间之后的位置，不传则返回最新位置

返回内容

QueryDriverLocationResponse

参数	类型	必传	描述	示例	备注
orderDriverLocationInfo	List<OrderDriverLocationDTO>	是	订单司机位置信息
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码

OrderDriverLocationDTO

参数	类型	必传	描述	示例	备注
driverLocationInfo	List<DriverLocationDTO>	是	司机位置信息
ctripPurchaseOrderId	long	是	携程采购单号	881823967638342968	18位
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码

DriverLocationDTO

参数	类型	必传	描述	示例	备注
longitude	BigDecimal	是	经度	119.192474	精确到小数点后6位，不足6位补0
latitude	BigDecimal	是	纬度	26.051053	精确到小数点后6位，不足6位补0
coordinate	String	是	坐标系类型	GCJ02	GCJ02; WGS84
locationTime	String	是	获取到司机位置的时间		yyyy-MM-dd HH:mm:ss
speed	BigDecimal	是	司机速度		单位：km/h，如果无法提供则传255
direction	BigDecimal	是	司机当前车头朝向		正北方向为0度，如果无法提供则传511
locationType	Integer	否	定位方式	1	1:基站定位;2:缓存定位;3:GPS定位;4:Wifi定位
height	BigDecimal	否	高度		单位：米小数点后2位精度
accuracy	BigDecimal	否	定位精度		单位：米小数点后2位精度

请求示例

{
    "orderInfo": [{

        "ctripPurchaseOrderId": 881824123456949513,
        "vendorOrderId": "11259022228429",
        "startTime": "2020-10-20 22:22:22"
    }]
}

响应示例

{
    "msgCode":"OK",
    "massage":"SUCCESS",
    "orderDriverLocationInfo":[
        {
            "ctripPurchaseOrderId":881824250534949513,
            "msgCode":"OK",
            "message":"成功",
            "driverLocationInfo":[
                {
                    "longitude":119.192474,
                    "latitude":26.051053,
                    "coordinate":"GCJ02",
                    "locationTime":"2020-10-20 22:22:12",
                    "speed":12,
                    "direction":10,
                    "locationType":1
                }
            ]
        },
        {

            "ctripPurchaseOrderId":88123234955611233,
            "msgCode":"OK",
            "message":"成功",
            "driverLocationInfo":[
                {
                    "longitude":120.302474,
                    "latitude":30.012123,
                    "coordinate":"GCJ02",
                    "locationTime":"2020-10-20 22:22:12",
                    "speed":40,
                    "direction":20,
                    "locationType":1
                }
            ]
        }
    ]
}

异常示例

{
    "msgCode":"OK",
    "massage":"SUCCESS",
    "driverLocationInfo":[
        {
            "ctripPurchaseOrderId":881824250534949513,
            "msgCode":"OK",
            "message":"成功",
            "driverLocationInfo":[
                {
                    "longitude":119.192474,
                    "latitude":26.051053,
                    "coordinate":"GCJ02",
                    "locationTime":"2020-10-20 22:22:12",
                    "speed":12,
                    "direction":10,
                    "locationType":1
                }
            ]
        },
        {
            "ctripPurchaseOrderId":88123266666611233,
            "msgCode":"ERROR_NO_DRIVER_LOCATION",
            "message":"",
            "driverLocationInfo":[
            ]
        }
    ]
}

results matching ""

No results matching ""