北京汽车信息娱乐系统通信协议规范_TSP平台与DVD(12月份东软直接提供)behe

项目名称称: 北北京汽车车信息娱娱乐系统统通信协议议规范-TSPP平台与与DVDDVer11.1北京汽车车股份有有限公司司20111年07月4 / 56>目 录录1文档简简介11.1协协议说明明11.2数数据类型型11.3编编码说明明11.4注注释说明明11.5符符号说明明11.6加加密11.7度度量单位位12协议框框架22.1协协议概述述22.2协协议说明明22.2..1协议议请求头头22.2..2应答答请求头头33DVDD接口协协议说明明43.1消消息服务务43.1..1消息息分类获取取43.1..1.11应答结结果43.1..1.11.1数数据结构构43.1..1.11.2应应答示例例53.1..2消息息列表获获取53.1..2.11应答结结果63.1..2.11.1数数据结构构63.1..2.11.2应应答示例例73.1..3消息息详情获获取83.1..3.11消息详详情获取取获取83.1..3.11.1请请求参数数83.1..3.11.2应应答结果果93.1..3.11.2..1数据据结构993.1..3.11.2..2应答答示例1103.1..3.22下载附附件1443.1..3.22.1请请求参数数143.1..3.22.2应应答结果果153.1..3.22.2..1数据据结构1153.1..3.22.2..2应答答示例1153.2保保养服务务163.2..1保养养记录查查询1663.2..1.11请求参参数1663.2..1.22应答结结果1663.2..2查询询当次保保养状态态183.2..2.11请求参参数1883.2..2.22应答结结果1883.2..3取消消当次保保养提醒醒193.2..3.11请求参参数1993.2..3.22应答结结果1993.3一一键导航航203.3..1获取取设定位位置2003.3..1.11请求参参数2003.3..1.22应答结结果2113.4网网络检索索243.4..1关键键字检索索243.4..1.11请求参参数2443.4..1.22应答结结果2553.4..2POOI分类类检索2273.4..2.11请求参参数2773.4..2.22应答结结果2883.4..3交叉叉路检索索303.4..3.11请求参参数3003.4..3.22应答结结果3113.4..4周边边POII检索3223.4..4.11请求参参数3223.4..4.22应答结结果3333.5新新闻3553.5..1新闻闻分类查查询3553.5..1.11请求参参数3553.5..1.22应答结结果3553.5..2新闻闻订阅3363.5..2.11请求参参数3663.5..2.22应答结结果3773.5..3新闻闻取消订订阅3773.5..3.11请求参参数3773.5..3.22应答结结果3883.5..4新闻闻获取3383.5..4.11请求参参数3993.5..4.22应答结结果3993.6天天气预报报413.6..1行政政区划元元数据检检索4113.6..1.11请求参参数4113.6..1.22应答结结果4113.6..2天气气查询4423.6..2.11请求参参数4223.6..2.22应答结结果4333.7车车队组队队453.7..1车队队列表查查询4553.7..1.11请求参参数4553.7..1.22应答结结果4663.7..1.33数据结结构4663.7..1.44应答示示例4773.7..2车队队队员检检索4883.7..2.11请求参参数4883.7..2.22应答结结果4993.7..2.33数据结结构4993.7..2.44应答示示例4993.7..3位置置上报5513.7..3.11请求参参数5113.7..3.22应答结结果5113.7..3.33数据结结构5113.7..3.44应答示示例5223.7..4加入入/退出车车队申请请533.7..4.11请求参参数5333.7..4.22应答结结果5443.8消消息检测测543.8..1消息息检测请请求5443.8..2消息息应答结结果5554附录5564.1服服务类型型说明5564.2返返回码5564.3消消息分类类57前 言言本规范由由北京汽汽车股份份有限公公司提出出并归口口。
本规范起起草单位位:北京京汽车股股份有限限公司本规范解解释单位位:北京京汽车股股份有限限公司1 文档简介介1.1 协议说明明本文中内内容对北北京汽车车信息娱娱乐系统统平台(TTSP平平台)与与DVDD之间的的HTTTP通讯讯协议进进行定义义和说明明1.2 数据类型型本文中标标记[ C]显显示Chharaacteer型[C] 后面连接的数字显示Character数如:C44 表示示 Chharaacteer型,44 Chharaacteer1.3 编码说明明DVD与与TSPP平台间间请求、应应答协议议编码方方式默认认采用GGBK1.4 注释说明明本文采用用如下注注释关键键词:[注意]]——提提醒读者者关注此此处1.5 符号说明明1) ◎ 必填填项2) (空)非非必填项项1.6 加密本协议中中涉及到到的DIID需要要进行加加密,加加密算法法由DVVD供应应商和TSPP平台进行行共同商商定1.7 度量单位位本协议中中涉及到到的度量量单位信信息,如如无特殊殊说明,均均按照下下列处理理:编号名称长度单位说明1经度C101/10000秒秒10进制制2纬度C101/10000秒秒10进制制3方向C3度10进制制, 与与正北方方向夹角角:0 – 36604速度C50.1公公里每小小时10进制制2 协议框架架2.1 协议概述述本通讯协协议的承承载协议议为HTTTP//1.11(参见见RFCC26226)。
服务采用用HTTTP网络络传输协协议,客客户端以以GETT的形式式发送请请求数据据到服务务器端本公开协协议由一一个安全全协议规规范和业业务协议议规范构构成,安安全对协协议的结结构和控控制标识识进行约约定,业业务协议议对具体体的业务务功能进进行规范范安全全和业务务协议有有各自的的版本号号2.2 协议说明明2.2.1 协议请求求头序号参数说明长度示例必填1Deviice--id终端设备备DVDD的信息息C16Deviice--id== SDD20110077260000001◎2Deviice--vinn用于标识识车辆的的唯一码码C17◎3Prottocool-vverssionn协议的版版本号发起方请求时,必须标明使用的版本号,主要用于版本升级版本号的的组成::xxxxx 版本号号(主版版本号..次版本本号)C401000◎4Encoodinng用于标识识请求编编码方式式,支持持UTFF-8或或者GBBK,默默认是GGBKC55Testt-fllag该字段用用于终端端是否为为测试请请求TSSP处理理业务,00为非测测试,11为测试试,默认认为0C16BID厂商业务务标识类类型, 标识接接入的厂厂商业务务C3参见“厂厂商业务务标识类类型表”◎7SID终端请求求服务的的请求码码。
请求求码系统统统一定定义C4详细参见见附录44.1◎厂商业务务标识类类型(BBID))如下::标识含义100C60FF101C70GG DDVD 102C70GG CCD103C80KK104C50EE2.2.2 应答请求求头序号参数说明长度示例必填1Resuult__codde应答状态态C4Resuult__codde: 02000◎2SID终端请求求服务的的请求码C4参见附录录4.11◎应答状态态参见附附录4..2中定定义109 / 57>3 DVD接接口协议议说明DVD和和TSPP平台之之间的,请请求的UURL统统一为::/baiicTSSP/SSafeeDVDDSerrvleet请求方式式为/bbaiccTSPP/SaafeDDVDSServvlett?paaramm....3.1 消息服务务3.1.1 消息分类类获取车载终端端使用该该接口获获取消息息分类信息息示例:GET//baiicTSSP/SSafeeDVDDSerrvleet HHTTPP/1..1Hostt: iip:pporttDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 200023.1.1.1 应答结果果3.1.1.1.1 数据结构构序号元素名称称英文名称称相关解释释长度示例必填1符合条件件总记录录数sumnnumbber所有的记记录C3◎2消息mesggtyppes消息分类类体◎3分类IDDmesggtyppe_iid消息IDD最长C111◎4分类标题题mesggtyppe_ttitlle消息标题题最长C664◎5分类类型型mesggtyppe_typpe大分类::0小分类::为该小小分类的的父类型型ID最长C443.1.1.1.2 应答示例例HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 20002{"summnummberr":"2","messgtyypess":[{"messgtyype__id"": "100","messgtyype__tittle"": "终端端","messgtyype__typpe": "0",//表表示大分分类},{"messgtyype__id"": "10001"","messgtyype__tittle"": "广告告","messgtyype__typpe": "100"//非“00”即为为小分类类,值为为父类型型的“messgtyype__id”}]}3.1.2 消息列表表获取车载终端端使用该该接口获获取消息息列表信信息。
序号元素名称称英文名称称相关解释释长度示例必填1消息大类类别mesggTyppe参见附录录4.33C2◎2消息详细细类别typeeDettaill参见附录录4.33C43结果开始始位置pos取得检索索结果集集的开始始位置最长C444结果集的的件数cnt取得检索索结果集集的件数数最长C44示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?messgTyype==10&&typpeDeetaiil=10001&ppos==0&ccnt==10 HTTTP/11.1Hostt:ipp:poortDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 200033.1.2.1 应答结果果3.1.2.1.1 数据结构构序号元素名称称英文名称称相关解释释长度示例必填1符合条件件总记录录数sumnnumbber所有的记记录C3◎2消息messsagees消息体◎3消息IDDmesssagee_idd消息IDD最长C111◎4消息标题题messsagee_tiitlee消息标题题最长C664◎5消息大类类型messsagee_tyype消息大类类型C4◎6消息详细细类型messsagee_tyype__dettaill消息详细细类型C4◎7消息来源源messsagee_frrom消息来源源最长C3328消息发布布时间publlishh_tiime格式:yyyyyy-mmm-ddd hhh:mmm:sssC19◎3.1.2.1.2 应答示例例HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 20003{"summnummberr":"2","messsagges"":[{"messsagge_iid":: "113899813388772","messsagge_ttitlle":: "终端端版本需需要升级级","messsagge_ttypee": "111","messsagge_ttypee_deetiaal":"11001""messsagge_ffromm": "系统统","pubblissh_ttimee":"20110-003-225 114:339:001"},{"messsagge_iid":: "113899813388773",,"messsagge_ttitlle":: "送您您洗车大大礼包"","messsagge_ttypee": "144","messsagge_ttypee_deetiaal":"14002""messsagge_ffromm": "系统统","pubblissh_ttimee":"20110-003-225 114:339:001"}]}3.1.3 消息详情情获取终端使用用该接口口获取消消息详情情,支持持同时获获取多条条消息详详情。
3.1.3.1 消息详情情获取获获取3.1.3.1.1 请求参数数序号元素名称称英文名称称相关解释释长度示例必填1消息的IIDmsgIId如果想要要获取即即时消息息的IDD,并且且想要同同时获取取多条消消息的IID,则则使用”,,”分割割最长C111msgIId=110011, 110022◎2获取方式式obtaainTTypee1:BAASE664方式式,一次次性获取取全部消消息2:URRL方式式,先获获取文字字部分,在在逐个获获取附件件C1obtaainTTypee=1obtaainTTypee=2◎示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?mmsgIId=110011,10002&obbtaiinTyype==1 HHTTPP/1..1Hostt:ipp:poortDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001 Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 200043.1.3.1.2 应答结果果3.1.3.1.2.1 数据结构构序号元素名称称英文名称称相关解释释长度示例必填1符合条件件总记录录数sumnnumbber符合条件件总记录录数最长C33◎2消息messsagees消息体◎3消息IDDmesssagee_idd消息IDD最长C111◎4消息标题题messsagee_tiitlee消息标题题最长C1100◎5消息来源源messsagee_frrom消息来源源最长C220◎6消息发布布时间publlishh_tiime格式:yyyyyy-mmm-ddd hhh:mmm:sssC19◎7消息大类类型messsagee_tyype消息大类类型C4◎8消息详细细类型messsagee_tyype__dettiall消息详细细类型C4◎9消息体messsagee_boody消息体最长C2200◎10获取方式式obtaainTTypee1:BAASE664方式式,一次次性获取取全部消消息。
2:URRL方式式,先获获取文字字部分,在在逐个获获取附件件◎11附件体messsagee_ mmulttimeediaa_boddy附件体12附件编号号messsagee_ mmulttimeediaa_idd附件编号号C1◎13附件类型型messsagee_multtimeediaa_tyype1:图片片;2:声音音C1◎14附件大小小messsagee_multtimeediaa_leengtth附件大小小C8◎15附件messsagee_multtimeediaa附件◎3.1.3.1.2.2 应答示例例说明1::用BAASE664方式式获取全全部消息息HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 20004{"summnummberr":"2","messsagges"":[{"messsagge_iid":: "10001"","messsagge_ttitlle":: "送您您洗车大大礼包"","messsagge_ffromm": "系统统","pubblissh_ttimee":”20110-003-225 114:339:001”,,"messsagge_ttypee": "144","messsagge_ttypee_deetiaal":”14402"","messsagge_bbodyy":"从即日日起至110月11日,到到中街44S店洗洗车享受受半价优优惠,快快快行动动吧","obttainnTyppe":"1","messsagge_ mulltimmediia __boddy": [[{"meessaage__ mulltimmediia_iid"::"1"","messsagge_ multtimeediaa_typpe"::"1", "messsagge_ multtimeediaa_leengtth"::"1220",, "messsagge_ multtimeediaa":""asddfaddfassdfaasdffasddf”},{"meessaage__ mulltimmediia_iid"::"2"","messsagge_ multtimeediaa_typpe"::"2", "messsagge_ multtimeediaa_leengtth"::"1550",, "messsagge_ multtimeediaa":""asddfaddfassdfaasdffasddf”}]},{"messsagge_iid":: "10002"","messsagge_ttitlle":: "分享享信息"","messsagge_ffromm": "好好友(113899813393223)"","pubblissh_ttimee":”20110-003-225 114:339:001”,"messsagge_ttypee": "133","messsagge_ttypee_deetiaal":”13303”,"messsagge_bbodyy":"东大门门口有活活动","obttainnTyppe":"1","messsagge_ mulltimmediia __boddy": [{"meessaage__ mulltimmediia_iid"::"2"","messsagge_ multtimeediaa_typpe"::"2", "messsagge_ multtimeediaa_leengtth"::"1880",, "messsagge_ multtimeediaa":""asddfaddfassdfaasdffasddf”}]}]}说明2::以URRL方式式获取文文字信息息,再用用BASSE644方式逐逐个获取取附件。
HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 20004{"summnummberr":"2","gettnummberr":"2","messsagges"":[{"messsagge_iid":: "10001"","messsagge_ttitlle":: "送您您洗车大大礼包"","messsagge_ffromm": "系统统","pubblissh_ttimee":”20110-003-225 114:339:001”,,"messsagge_ttypee": "144","messsagge_ttypee_deetiaal":”14402"","messsagge_bbodyy":"从即日日起至110月11日,到到中街44S店洗洗车享受受半价优优惠,快快快行动动吧","obttainnTyppe":"2","messsagge_ mulltimmediia __boddy": [{"meessaage__ mulltimmediia_iid"::"1"","messsagge_ multtimeediaa_typpe"::"",, "messsagge_ multtimeediaa_leengtth"::"",, "messsagge_ multtimeediaa":""" }]"messsagge_ mulltimmediia __boddy": [{"meessaage__ mulltimmediia_iid"::"2"","messsagge_ multtimeediaa_typpe"::"",, "messsagge_ multtimeediaa_leengtth"::"",, "messsagge_ multtimeediaa":""" }]},{"messsagge_iid":: "10002"","messsagge_ttitlle":: "分享享信息"","messsagge_ffromm": "好好友(113899813393223)"","pubblissh_ttimee":”20110-003-225 114:339:001”,"messsagge_ttypee": "133","messsagge_ttypee_deetiaal":”13303”"messsagge_bbodyy":"东大门门口有活活动","obttainnTyppe":"1","messsagge_ mulltimmediia __boddy": [{"meessaage__ mulltimmediia_iid"::"2"","messsagge_ multtimeediaa_typpe"::"",, "messsagge_ multtimeediaa_leengtth"::"",, "messsagge_ multtimeediaa":""" }]}]}说明3 :无附件件信息的的消息。
HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 20004{"summnummberr":"1","gettnummberr":"1","messsagges"":[{"messsagge_iid":: "10001"","messsagge_ttitlle":: "送您您洗车大大礼包"","messsagge_ffromm": "系统统","pubblissh_ttimee":"20110-003-225 114:339:001","messsagge_ttypee": "144","messsagge_ttypee_deetiaal":”14402"","messsagge_bbodyy":"从即日日起至110月11日,到到中街44S店洗洗车享受受半价优优惠,快快快行动动吧","obttainnTyppe":"2","messsagge_ mulltimmediia_boddy": """}]}3.1.3.2 下载附件件3.1.3.2.1 请求参数数序号元素名称称英文名称称相关解释释长度示例必填1消息IDDmesssageeId消息IDD最长C111◎2附件编号号messsagee_ mmulttimeediaa_idd附件编号号C11◎示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?messsaggeId=10001&mmesssagee_ mmulttimeediaa_idd=1 HTTTP/11.1Hostt: iip:pporttDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001 Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 200053.1.3.2.2 应答结果果3.1.3.2.2.1 数据结构构序号元素名称称英文名称称相关解释释长度示例必填1消息IDDmesssagee_idd消息IDD最长C111◎2附件体messsagee_ mmulttimeediaa_boddy附件体3附件编号号messsagee_ mmulttimeediaa_idd附件编号号C11◎4附件类型型messsagee_multtimeediaa_typpe1:图片片;2:声音音C1◎5附件大小小messsagee_multtimeediaa_leengtth附件大小小C8◎6附件messsagee_multtimeediaa附件◎3.1.3.2.2.2 应答示例例HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 20005{"messsagge_iid":: "113899813388774","messsagge_ mulltimmediia_boddy": [[{"meessaage__ mulltimmediia_iid"::"1"","messsagge_mmulttimeediaa_typpe"::"1", "messsagge_mmulttimeediaa_leengtth"::"1220",, "messsagge_mmulttimeediaa":""asddfaddfassdfaasdffasddf”}]}3.2 保养服务务3.2.1 保养记录录查询3.2.1.1 请求参数数序号元素名称称英文名称称相关解释释长度示例必填1结果开始始位置pos取得检索索结果集集的开始始位置最长C442结果集的的件数cnt取得检索索结果集集的件数数最长C44示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?poss=0&&cntt=100 HTTTP//1.11Hostt:ipp:poortDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 700013.2.1.2 应答结果果序号元素名称称英文名称称相关解释释长度示例必填1符合条件件总记录录数sumnnumbber总记录数数最长C44◎2记录体mainntaiinReecorrds◎3主键标识识id主键标识识最长C111◎4保养日期期mainntaiin_ddatee保养日期期C20◎5保养公里里数mainntaiin_kkm保养公里里数最长C55◎7保养4ss店dealler__namme保养4ss店最长C664◎8保养费用用checck_ccostt保养费用用最长C88◎9保养状态态checck_sstattus保养状态态最长C88◎10保养内容容checck_cconttentt◎11保养项conttentt_keey保养项最长C220◎12保养操作作conttentt_vaaluee保养操作作最长C220◎13保养费用用conttentt_coost保养费用用最长C88示例:HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 70001{"suumnuumbeer":"2","maiintaainRRecoordss": [[{"idd":""10001",,"maiintaain__datte"::"20011005055", "maiintaain__km"":"1120"", "deaalerr_naame"":"北北京4ss店”"cheeck__cosst"::"40000”"cheeck__staatuss":""已完成成”,"cheeck__conntennt"::[{"conntennt_kkey"":"发发动机"","conntennt_vvaluue"::"换机机油""conntennt_ccostt":""2300.999"},{"conntennt_kkey"":"轮轮胎",,"conntennt __vallue"":"补补齐""conntennt_ccostt":""0"}]}]}3.2.2 查询当次次保养状态态3.2.2.1 请求参数数示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?typpe=11 HTTTP//1.11Hostt: iip:pporttConttentt-Leengtth: 91Deviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 70002注意:请请求URRL中ttypee是查询的类类型,包包含保养养提醒、车车辆信息息、4SS店服务务、广告告等,暂暂定只有有查询当当次保养养状态,即即typpe=11。
3.2.2.2 应答结果果序号元素名称称英文名称称相关解释释长度示例必填1保养状态态结果resuult保养状态态结果0:保养养状态已已取消1:保养养状态未未取消最长C11◎HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID::70002{"reesullt":"1"} //00:保养养状态已已取消 1:保保养状态态未取消消3.2.3 取消当次次保养提醒醒3.2.3.1 请求参数数示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?typpe=11 HTTTP//1.11Hostt: iip:pporttDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 70003注意:请请求URRL中ttypee是取消消的类型型,包含含保养提提醒、车车辆信息息、4SS店服务务、广告告等,暂暂定只有有取消当次次保养提提醒,即即typpe=11。
3.2.3.2 应答结果果示例(取取消成功功):HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID::70003示例(取取消失败败):HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde:004011SID::700033.3 一键导航航3.3.1 获取设定定位置一键导航航是把用户户要求的的位置,,发送给给TSPP平台,,DVDD从TSSP平台台下载位位置信息息3.3.1.1 请求参数数序号元素名称称英文名称称相关解释释长度示例必填1包含历史史记录has__hisstorry是否包含含历史记记录,默默认为00最长C11has__hisstorry=00,haas_hhisttoryy=1注:haas_hhisttoryy为0 就是不不包含历历史记录录,如果果没有最最新的导导航记录录,返回回无导航航记录;;hass_hiistoory为为1就是是包含历历史记录录,如果果没有最最新的导导航记录录,返回回最后一一次的导导航记录录。
示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?hass_hiistoory==0 HTTTP//1.11Hostt:ipp:poortDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001 Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID::1000SID:: 300013.3.1.2 应答结果果序号元素名称称英文名称称相关解释释长度示例必填1结果Resuult◎2导航条件件naviiconndittionn0:推荐荐优先;;1:高速速优先;;2:距离离优先;;3:时间间优先;;4:采用用导航本本地的设设置默认值为为4C13目的地desttinaatioon目的地4位置名pnamme位置名最长C550◎5经度lon经度C10◎6纬度lat纬度C10◎7电话tel电话C158地址addrresss地址最长C11289途经地viass最多3个个途径地地10途经地序序号viaiid途径地的的顺序号号C111途经地信信息poiiinfoo途径地信信息12位置名pnamme位置名最长C66413经度lon经度C1014纬度lat纬度C1015电话tel电话最长C11516地址addrresss地址最长C1100示例(单单一目的的地成功功):HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 30001{"Reesullt"::{"naaviccondditiion"":"1","desstinnatiion ": [{"pnaame"":"万万豪酒店店","lonn":""222222222222","latt":""1111111111111",,"tell":""6544789915"","adddresss"::"北京京市朝阳阳区劲松松南路1145号号","viaas": [[{"viaaid"":"11","poiiinffo":{"pnaame"":"万万豪酒店店",“lonn”: "222222222222",,“latt":""1111111111111",“tell":""6544789915"","adddresss"::"北京京市朝阳阳区劲松松南路1145号号"}},{"viaaid"":"22","poiiinffo":{"lonn "::"222222222222",,"latt "::"1111111111111"","tell":""6544789915"","adddresss"::"北京京市朝阳阳区劲松松南路1145号号"}}]}]}}示例(多多目的地地成功)):HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 02000SID:: 30001{"Reesullt"::{ “ddesttinaatioon "": [[{"pnaame"":"万万豪酒店店","lonn":""222222222222","latt":""1111111111111","tell":""6544789915"","adddresss"::"北京京市朝阳阳区劲松松南路1145号号"},{"pnaame"":"大大厦1"","lonn":""222222222222","latt":""1111111111111","tell":""6544789915"","adddresss"::"北京京市朝阳阳区劲松松南路1145号号"}]}}示例(失失败)::HTTPP/1..1 2200 OKConttentt-Leengtth: 72Datee: MMon,, 144 Maar 220111 077:500:377 GMMTResuult__codde: 04003SID:: 300013.4 网络检索索3.4.1 关键字检检索3.4.1.1 请求参数数序号元素名称称英文名称称相关解释释长度示例必填1省名称provv_naame省级行政政区域的的中文名名称最长C440provv_naame==辽宁省省◎2市名称cityy_naame市级行政政区域的的中文名名称最长C440cityy_naame==沈阳市市◎高德GIS必须且只要城市代码3县名称counnty__namme县、区级级行政区区域的中中文名称称最长C440counnty__namme ==沈河区区4关键字keywwordd检索关键键字最长C1100keywwordd=万豪豪酒店◎关键字与首字母二选一5首字母firsst_leetteers关键字拼拼音首字字母最长C550firsst_lettterrs=wwhjdd◎6排序字段段sortt_crri排序字段段:设定定是否使使用分类类排序字字段。
最长C220sortt_crri=kkeyoowrdd7结果集的的开始位位置pos取得结果果集的开开始位置置最长C44pos==208结果集件件数cnt取得结果果集的件件数最长C44cnt==30 【注注】1) pos 值为正正整数,cntt值为正正整数2) 请求参数数中的省省市信息息都为国国标码3) 关键字和和首字母母字段,不不能同时时为空4) 排序字段段,默认认值为 keyyworrd ,示例:GET//baiicTSSP/SSafeeDVDDSerrvleet?proov_nnamee=辽宁宁省&ccityy_naame==沈阳市市&coountty_nnamee=沈河河区&kkeywwordd=万豪豪酒店&&sorrt_ccri==keyyworrd&ppos==20&&cntt=300HTTTP/11.1或GET//baiicTSSP/SSafeeDVDDSerrvleet?proov_nnamee=辽宁宁省&ccityy_naame==沈阳市市&coountty_nnamee=沈河河区&ffirsst_lettterrs=wwhjdd&soort__crii=keeywoord&&poss=200&cnnt=330HTTTP//1.11Hostt: iip:pporttDeviice--vinn:20011007055-BJJ@1002344Deviice--id:: SDD20110077260000001 Prottocool-vverssionn: 11.0Encoodinng: gbkkTestt-fllag:: 0BID:: 1000SID:: 400013.4.1.2 应答结果果序号元素名称称英文名称称相关解释释长度必填1符合条件件总记录录数sumnnumbber总记录数数最长C44◎2结果resuult3主键id主键最长C220◎4POI名名称keywworddPOI名名称最长C1100◎5电话tel电话最长C1156地址addrresss地址最长C1100◎7经度lon经度C10◎8纬度lat纬度C1。