SDK方法
方法列表
| 方法名 | 说明 |
|---|---|
| registerApp | 注册appid和secret |
| callDDApi | 调用滴滴API |
| showDDPage | 拉起打车页面 |
| showPage | 拉起滴滴对应页面 |
| isLogin | 判断当前用是否登录 |
| callPhone | 呼叫电话 |
| getTicket | 获取ticket |
1. registerApp
注册当前appid和secret
参数列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| appid | string | 申请的appid |
| secret | string | 申请的appid对应的秘钥 |
安卓调用
在入口Activity中调用
DiDiWebActivity.registerApp("appid", "secret");
IOS调用
[DIOpenSDK registerApp:@"yourappId" secret:@"yoursecret"];
2. callDDApi
调用滴滴开放平台API
参数列表
| 参数名 | 列表 | 说明 |
|---|---|---|
| api | string | 调用API的方法名 |
| params | HashMap | 调用API接口时传递的参数 |
备注：详情见API方法部分
3. showDDPage
拉起滴滴打车主页面
Android参数列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| Context | string | Context参数尽量传Activity |
| params | hashMap | 参数如params列表 |
IOS参数列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| parentController | UIViewController | 需要调起打车页面的controller |
| animated | BOOL | 展现滴滴页面时是否需要动画 |
| params | BOOL | 参数如params列表 |
| delegate | id | 扩展参数，后续用于SDK和app进行一些交互 |
params列表
| 名称 | 类型 | 说明 |
|---|---|---|
| phone | 手机号 | 设置登录默认用户 |
| maptype | 地图坐标系类型 | soso（默认值），支持地图类型见备注 |
| fromlat | 起点纬度 | 精确到小数点后2位以上 |
| fromlng | 起点经度 | 精确到小数点后2位以上 |
| fromname | 起点名 | |
| fromaddr | 起点地址 | |
| tolat | 终点纬度 | 精确到小数点后2位以上 |
| tolng | 终点经度 | 精确到小数点后2位以上 |
| toname | 终点名 | |
| toaddr | 终点地址 | |
| channel | 渠道号 | |
| bizid | 业务线id | 257 - 出租车；258 - 专车；260 - 快车；261 - 代驾；262 - 巴士 |
备注：
- 所有的参数都是可选参数。但如果您App本身已有定位功能，建议在拉起的时候传入经纬度
fromlat，fromlng，maptype，WebApp会直接使用传入的定位坐标，省去自身的定位等待，提高页面整体加载速度。 - SDK会对传入的经纬度做合法性校验（数字格式，精度大于4位小数）,只有经纬度同时合法时才会采用。如果传递经纬度请同时传递经纬度对应的坐标类型maptype以确保滴滴准确识别。
- addr 为地点的地址，name 为地点的名称。例如，天安门的 addr 地址为东长安街xxx号，而 name 名称为天安门。
- 如果只传入经纬度，则滴滴会根据传入的经纬度做地点名称反解操作。但如果同时传入了名称与地址，则滴滴会采用传入值。如果未传递经纬度，或者未同时传入地址与名称，则会忽略传递的地址名称，走滴滴自有反解动作。
- 如果起始地点未传递，则会使用当前定位地址。如果目的地未传递，则会等待用户填写。
- 如果您传入了经纬度，请搭配传入准确的maptype，以保证经纬度得到准确的识别与反解。
- biz 可选的取值为，1：出租车；2：专车；3：快车；4：代驾。
安卓调用
在入口Activity中调用
DiDiWebActivity.showDDPage(Context,HashMap<String, String>);
IOS调用
+ (void)showDDPage:(UIViewController *)parentController
+ animated:(BOOL)animated
+ params:(DIOpenSDKRegisterOptions *)optionParams
+ delegate:(id<DIOpenSDKDelegate>)delegate;
4. showPage
拉起滴滴指定页面
参数列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| page | string | 需要拉起页面的标识名 |
| params | HashMap | 拉起页面时传递的参数 |
备注：详情见showPage方法部分
5. isLogin
参数列表
无
返回
true/false，非登录状态可通过showPage方法拉起登录页面让用户重新登录
6. callPhone
呼叫电话，受限于安全要求，滴滴无法开放明文的司机号码，对于接驾的司机信息，对手机号码进行了加密
参数列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| phone | string | 司机信息接口返回的司机手机号加密串，对应如下说明中data.phone |
司机信息接口返回示例
{
"errno": 0,
"errmsg": "",
"data": {
"name": "王师傅",
"level": 4.8,
"cartype": "宝马5系",
"headimg": "xxxx",
"card": "京A**038",
"phone": "aadfiuaodifkadflkafd"
}
}
7. getTicket
获取供服务端API认证的ticket，ticket分为单次与长期有效，部分敏感的API接口需要单次有效的ticket才能调用。单次有效的ticket调用一次之后即失效，而长期有效的ticket在有效期（一般为2个小时）内可重复使用。 单次与长期有效的ticket之间可以共存，但至多同时存在一个单次有效及一个长期有效的ticket。