MapABC查询服务接口-用户手册.doc

MapABC查询服务接口-用户手册 MapABC查询服务接口用户手册、文件状态： 草稿 正式发布 正在修改文件标识：MapABC-API Server-UM当前版本：1.07作 者：创建日期：最后更新：20100607密 级：秘密版权说明：版权 2009归北京图盟科技有限公司所有版 本 管 理【修改记录】版本/状态作者起止日期备注【审 阅】版本/状态审阅时间审阅人职务备注目录MAPABC查询服务接口1用户手册11POI查询接口使用说明11.1关键字查询11.1.1接口功能介绍11.1.1接口参数说明11.1.3接口URL示例21.1.4返回结果说明21.1.5其他需要说明的部分21.2周边查询31.2.1 根据中心点的坐标（x，y）查询周边POI31.2.2 根据中心点关键字查询周边POI61.2.3 根据中心点gridcode查询周边POI81.2.4根据两条线的交叉点坐标查询周边POI111.2.5根据两条道路交叉点查询131.3 PGUID查询171.3.1接口功能介绍171.3.2接口参数说明171.3.3接口URL示例171.3.4返回结果说明171.3.5其他需要说明的部分181.4拉框查询181.4.1在基础库和地标库中查询181.4.2 在编辑器库中查询211.5缓冲区查询241.5.1接口功能介绍241.5.2接口参数说明241.5.3接口URL示例251.5.4返回结果说明251.5.5其他需要说明的部分271.6关键字提示接口服务请求271.6.1接口功能介绍271.6.2接口参数说明271.6.3接口URL示例281.6.4返回结果说明281.6.5其他需要说明的部分281.7行政区域内查询281.7.1接口功能介绍281.7.2接口参数说明281.7.3接口URL示例291.7.4返回结果说明291.7.5其他需要说明的部分302导航服务接口使用说明302.1路径导航服务请求接口302.1.1接口功能介绍302.1.2接口参数说明302.1.3接口URL示例312.1.4返回结果说明322.1.5其他需要说明的部分322.2导航距离计算服务请求接口362.2.1接口功能介绍362.2.2接口参数说明362.2.3接口URL示例362.2.4返回结果说明372.2.5其他需要说明的部分373公交查询接口使用说明373.1公交路径导航请求接口373.1.1接口功能373.1.2接口参数说明373.1.3接口URL示例383.1.4返回结果说明383.1.5其他需要说明的部分393.2 公交线路服务请求接口393.2.1 根据道路ID查询公交路线393.2.2根据公交名称查询公交路线423.2.3根据公交车站名称查询公交路线454地址匹配接口使用说明474.1接口功能474.2接口参数说明474.3接口URL示例474.4返回结果说明474.5其他需要说明的部分485位置描述接口使用说明495.1单点位置描述495.1.1接口功能介绍495.1.2接口参数说明495.1.3接口URL示例495.1.4返回结果说明505.1.5其他需要说明的部分515.2多点位置描述525.2.1接口功能介绍525.2.2接口参数说明525.2.3接口URL示例525.2.4返回结果说明525.2.5其他需要说明的部分545.3简化版位置描述545.3.1接口功能介绍545.3.2接口参数说明555.3.3接口URL示例555.3.4返回结果说明555.3.5其他需要说明的部分556道路查询接口使用说明556.1根据道路名称查询道路信息556.1.1接口功能介绍556.1.2接口参数说明556.1.3接口URL示例566.1.4返回结果说明566.1.5其他需要说明的部分576.2查询两条道路的交叉口位置576.2.1接口功能介绍576.2.2接口参数说明576.2.3接口URL示例576.2.4返回结果说明586.2.5其他需要说明的部分586.3查询一条道路上的所有交叉路口位置596.3.1接口功能介绍596.3.2接口参数说明596.3.3接口URL示例596.3.4返回结果说明596.3.5其他需要说明的部分607空间计算接口使用说明607.1位置判断接口607.1.1接口功能介绍607.1.2接口参数说明607.1.3接口URL示例627.1.4返回结果说明637.1.5其他需要说明的部分637.2距离计算接口637.2.1接口功能介绍637.2.2接口参数说明647.2.3接口URL示例647.2.4返回结果说明657.2.5其他需要说明的部分667.3 计算路径缓冲区范围667.3.1接口功能介绍667.3.2接口参数说明667.3.3接口URL示例667.3.4返回结果说明677.3.5其他需要说明部分698坐标处理接口使用说明698.1真实GPS坐标转换为偏移坐标698.1.1接口功能698.1.2接口参数说明698.1.3接口URL示例698.1.4返回结果说明708.1.5其他需要说明的部分718.2 道路纠偏718.2.1接口功能718.2.2接口参数说明718.2.3接口URL示例718.2.4返回结果说明718.2.5其他需要说明的部分728.3经纬度与屏幕像素坐标转换728.3.1接口功能728.3.2接口参数说明728.3.3接口URL示例738.3.4返回结果说明738.3.5其他需要说明的部分749实时交通信息接口使用说明749.1根据道路名称及城市ID服务请求格式749.1.1接口功能介绍749.1.2接口参数说明749.1.3接口URL示例749.1.4返回结果说明759.1.5其他需要说明部分759.2根据道路名称、起始点、结束点及城市ID服务请求格式769.2.1接口功能介绍769.2.2接口参数说明769.2.3接口URL示例769.2.4返回结果说明769.2.5其他需要说明部分779.3根据中心点、半径及城市ID服务请求格式779.3.1接口功能介绍779.3.2接口参数说明779.3.3接口URL示例779.3.4返回结果说明789.3.5其他需要说明部分789.4根据左上角坐标、右下角坐标及城市ID服务请求格式789.4.1接口功能介绍789.4.2接口参数说明789.4.3接口URL示例799.4.4返回结果说明799.4.5其他需要说明部分8010地图渲染接口使用说明8010.1WMAP取图8010.1.1接口功能介绍8010.1.2接口参数说明8010.1.3接口URL示例8710.1.4返回结果说明8710.1.5其他需要说明的部分8910.2海量加点请求接口8910.2.1接口功能介绍8910.2.2接口参数说明8910.2.3接口URL示例8910.2.4返回结果说明8910.2.5其他需要说明的部分9011辅助功能接口使用说明9011.1天气预报查询服务接口9011.1.1接口功能9011.1.2接口参数说明9011.1.3接口URL示例9111.1.4返回结果说明9111.1.5其他需要说明的部分9511.2 IP地址查询服务接口9511.2.1接口功能9511.2.2接口参数说明9511.2.3接口URL示例9511.2.4返回结果说明9511.2.5其他需要说明的部分9711.3 城市代码查询接口9711.3.1接口功能9711.3.2接口参数说明9711.3.3接口URL示例9711.3.4返回结果说明9711.3.5其他需要说明的部分9811.4区域查询9811.4.1接口功能9811.4.2接口参数说明9811.4.3接口URL示例9911.4.4返回结果说明9911.4.5其他需要说明的部分9912动态渲染9912.1根据poi的id查询poi信息9912.1.1接口功能9912.1.2接口参数说明9912.1.3接口URL示例10012.1.4返回结果说明10012.1.5其他需要说明的部分10112.2根据中心点坐标查周边10112.2.1接口功能10112.2.2接口参数说明10112.2.3接口URL示例10112.2.4返回结果说明10112.2.5其他需要说明的部分10212.3区域查询10212.3.1接口功能10212.3.2参数接口说明10212.3.3接口URL示例10212.3.4返回结果说明10312.3.5其他需要说明的部分10312.4动态渲染取图10312.4.1接口功能10312.4.2参数接口说明10412.4.3接口URL示例10412.4.4返回结果说明10412.4.5其他需要说明的部分10513切片取图10513.1maptile切片取图10513.1.1接口功能10513.1.2参数接口说明10513.1.3接口URL示例10513.1.4返回结果说明10513.1.5其他需要说明的部分10613.2动态切片取图10613.2.1接口功能10613.2.2参数接口说明10613.2.3接口URL示例10613.2.4返回结果说明10613.2.5其他需要说明的部分10714基站定位10714.1接口功能10714.2参数接口说明10714.3接口URL示例10714.4返回结果说明10714.4.1正确返回结果10714.4.2错误返回结果10814.4.3错误代码描述10814.5其他需要说明的部分108北京图盟科技有限公司1POI查询接口使用说明1.1关键字查询1.1.1接口功能介绍输入关键字查询POI。1.1.1接口参数说明参数名称参数格式参数含义备注configconfig= BESN关键字查询服务必填参数cityCodecityCode=城市编码城市编码:支持编码和名称形式，如010或者北京，需要进行urlencode编码，编码格式参照enc参数指定，全国为total必填参数searchNamesearchName=查询名称为查询名称:默认匹配名称,地址,类型,需要进行urlencode编码，编码格式参照enc参数指定必填参数searchTypesearchType=查询类型查询类型:POI分类类型,需要进行urlencode编码，编码格式参照enc参数指定可选参数numbernumber=返回的POI结果个数每页记录数必填参数batchbatch=POI结果显示的页数分页号必填参数resTyperesType=xml/json返回格式可选参数，支持xml和json格式默认xmlencenc=gb2312/utf-8编码设定，如果设定utf-8，那么必填参数可选参数，默认gb2312srctypesrctype=数据源类型数据源类型:基础库 POI 企业地标 DIBIAO公交站台 BUS通用编辑器 USERPOI上述数据源可以混合查询，例如公交数据+基础库数据查询srctype=BUS:1000%2bPOI,代表前1000条数据为公交数据，后面为基础库数据可选参数，默认 ENPOI:3%2bPOI代表前三条返回地标数据，后面返回基础库数据。a_ka_k=api key用户申请的key必填参数1.1.3接口URL示例检索基础库数据：/sisserver?&config=BESN&resType=xml&cityCode=010&searchName=%BE%C6%B5%EA&number=10&batch=1&a_k= 用户key检索公交数据：/sisserver?&config=BESN&resType=xml&cityCode=010&searchName=%BE%C6%B5%EA&number=10&batch=1&srctype=BUS&a_k= 用户key 检索编辑器数据：/sisserver?&config=BESN&resType=xml&cityCode=010&searchName=%BE%C6%B5%EA&number=10&batch=1&srctype=USERPOI&a_k= 用户key检索基础库+编辑器数据,其中前1000条编辑器数据优先显示/sisserver?&config=BESN&resType=xml&cityCode=010&searchName=%BE%C6%B5%EA&number=10&batch=1&srctype=USERPOI：1000%2BPOI&a_k= 用户key注：此URL仅为示例使用，不是最终服务提供URL 1.1.4返回结果说明此接口返回的结果集数量（默认最大结果集为400，可通过key权限修改，需要联系管理员）此数据是否从缓存读取引擎返回的结果集总数量此页返回的结果集数量（最大结果集为20）查询时间bounds值，当前返回的POI点统一个矩形框内，bounds为矩形框的左上右下坐标对 1.1.5其他需要说明的部分公交类型POI扩展字段说明：包含多个STATION元素。station为站点信息，包含字段如下表：参数名称参数格式参数含义备注NAME站点名称XY_COORDS站点坐标，以;分隔。如：116.332433;39.745734SPELL站点名称拼音Code站点所在城市行政区划码STATION_NUM站序示例：1.2周边查询1.2.1 根据中心点的坐标（x，y）查询周边POI接口功能介绍在基础库库和地标库中，根据中心点的坐标（x，y）, 查询周边POI。接口参数说明参数名称参数格式参数含义备注configconfig= BELSBXY服务参数名称必填参数cityCodecityCode=城市编码城市编码:支持编码和名称形式，如010或者北京，需要进行urlencode编码，编码格式参照enc参数指定，全国为total必填参数searchNamesearchName=查询名称为查询名称:默认匹配名称,地址,类型,需要进行urlencode编码，编码格式参照enc参数指定必填参数searchTypesearchType=查询类型查询类型:POI分类类型,需要进行urlencode编码，编码格式参照enc参数指定可选参数cenXcenX=中心点x中心点x坐标必填参数cenYcenX=中心点y中心点y坐标必填参数range周边查询范围周边查询时，圆型区域的必填参数，默认3000numbernumber=返回的POI结果个数每页记录数必填参数batchbatch=POI结果显示的页数分页号必填参数resTyperesType=xml/json返回格式可选参数，支持xml和json格式默认xmlencenc=gb2312/utf-8编码设定，如果设定utf-8，那么必填参数可选参数，默认gb2312srctypesrctype=数据源类型数据源类型:基础库 POI 企业地标 DIBIAO公交站台 BUS通用编辑器 USERPOI上述数据源可以混合查询，例如公交数据+基础库数据查询srctype=BUS:1000%2bPOI,代表前1000条数据为公交数据，后面为基础库数据可选参数，默认 ENPOI:3%2bPOI代表前三条返回地标数据，后面返回基础库数据。naviflagnaviflag=0/1导航距离排序标识可选参数默认为0，不按照导航距离排序，如果为1将按照导航距离排序，但性能比直线距离排序差srsr=排序参数sr=排序参数编辑器周边查询中查询中，sr=1代表按照距离排序a_ka_k=api key用户申请的key必填参数接口URL示例/sisserver?&config=BELSBXY&resType=xml&cityCode=010&cenX=116.4&cenY=39.9&searchName=大学&number=10&batch=1&range=3000&a_k=用户key注：此URL仅为示例使用，不是最终服务提供URL 返回结果说明此接口返回的结果集数量（默认最大结果集为400，可通过key权限修改，需要联系管理员）此数据是否从缓存读取引擎返回的结果集总数量此页返回的结果集数量（最大结果集为20）查询时间bounds值，当前返回的POI点统一个矩形框内，bounds为矩形框的左上右下坐标对地址POI名称POI类型数据时间戳匹配度url连接周边查询时，距离中心点距离x坐标y坐标城市号索引ID，可以根据此ID查询POI数据源5916728612电话图片ID扩展查询字段，编辑器或者公交数据中，可能存在该字段，扩展字段的含义和具体行业有关，该部分内容由应用自己去解析周边查询按照导航距离排序时，距中心点的导航距离 其他需要说明的部分1.2.2 根据中心点关键字查询周边POI接口功能介绍以给定一点的xy坐标为中心点进行周边查询。接口参数说明参数名称参数格式参数含义备注configconfig= BELSBN服务参数名称必填参数cityCodecityCode=城市编码城市编码:支持编码和名称形式，如010或者北京，需要进行urlencode编码，编码格式参照enc参数指定，全国为total必填参数searchNamesearchName=查询名称为查询名称:默认匹配名称,地址,类型,需要进行urlencode编码，编码格式参照enc参数指定searchTypesearchType=查询类型查询类型:POI分类类型,需要进行urlencode编码，编码格式参照enc参数指定必填参数cenNamecenName=中心点名称中心点x坐标range周边查询范围周边查询时，圆型区域的必填参数numbernumber=返回的POI结果个数每页记录数必填参数，默认3000batchbatch=POI结果显示的页数分页号必填参数resTyperesType=xml/json返回格式可选参数，支持xml和json格式默认xmlencenc=gb2312/utf-8编码设定，如果设定utf-8，那么必填参数可选参数，默认gb2312srctypesrctype=数据源类型数据源类型:基础库 POI 企业地标 DIBIAO公交站台 BUS通用编辑器 USERPOI上述数据源可以混合查询，例如公交数据+基础库数据查询srctype=BUS:1000%2bPOI,代表前1000条数据为公交数据，后面为基础库数据可选参数，默认 ENPOI:3%2bPOI代表前三条返回地标数据，后面返回基础库数据。naviflagnaviflag=0/1导航距离排序标识可选参数默认为0，不按照导航距离排序，如果为1将按照导航距离排序，但性能比直线距离排序差srsr=排序参数sr=排序参数编辑器周边查询中查询中，sr=1代表按照距离排序a_ka_k=api key用户申请的key必填参数接口URL示例/sisserver?range=100&config=BELSBN&resType=xml&cityCode=010&cenName=%D2%F8%B9%C8%B4%F3%CF%C3&searchName=%BE%C6%B5%EA&number=10&batch=1 &a_k=用户key注：此URL仅为示例使用，不是最终服务提供URL 返回结果说明此接口返回的结果集数量（默认最大结果集为400，可通过key权限修改，需要联系管理员）此数据是否从缓存读取引擎返回的结果集总数量此页返回的结果集数量（最大结果集为20）查询时间bounds值，当前返回的POI点统一个矩形框内，bounds为矩形框的左上右下坐标对地址POI名称POI类型数据时间戳匹配度url连接周边查询时，距离中心点距离x坐标y坐标城市号索引ID，可以根据此ID查询POI数据源5916728612电话图片ID扩展查询字段，编辑器或者公交数据中，可能存在该字段，扩展字段的含义和具体行业有关，该部分内容由应用自己去解析周边查询按照导航距离排序时，距中心点的导航距离 其他需要说明的部分1.2.3 根据中心点gridcode查询周边POI接口功能介绍给定一点的gridcode进行周边查询。接口参数说明参数名称参数格式参数含义备注configconfig= BELSBGC服务参数名称必填参数cenGridCodecenGridCode=中心点GridCode中心点GridCode，不输入查询将无结果。必填参数cityCodecityCode=城市编码城市编码:支持编码和名称形式，如010或者北京，需要进行urlencode编码，编码格式参照enc参数指定，全国为total必填参数searchNamesearchName=查询名称为查询名称:默认匹配名称,地址,类型,需要进行urlencode编码，编码格式参照enc参数指定searchTypesearchType=查询类型查询类型:POI分类类型,需要进行urlencode编码，编码格式参照enc参数指定必填参数cenNamecenName=中心点名称中心点x坐标range周边查询范围周边查询时，圆型区域的必填参数numbernumber=返回的POI结果个数每页记录数必填参数，默认3000batchbatch=POI结果显示的页数分页号必填参数resTyperesType=xml/json返回格式可选参数，支持xml和json格式默认xmlencenc=gb2312/utf-8编码设定，如果设定utf-8，那么必填参数可选参数，默认gb2312srctypesrctype=数据源类型数据源类型:基础库 POI 企业地标 DIBIAO公交站台 BUS通用编辑器 USERPOI上述数据源可以混合查询，例如公交数据+基础库数据查询srctype=BUS:1000%2bPOI,代表前1000条数据为公交数据，后面为基础库数据可选参数，默认 ENPOI:3%2bPOI代表前三条返回地标数据，后面返回基础库数据。naviflagnaviflag=0/1导航距离排序标识可选参数默认为0，不按照导航距离排序，如果为1将按照导航距离排序，但性能比直线距离排序差srsr=排序参数sr=排序参数编辑器周边查询中查询中，sr=1代表按照距离排序a_ka_k=api key用户申请的key必填参数接口URL示例/sisserver?&config=BELSBGC&cityCode=010&cenGridCode=5916727421&searchName=%BE%C6%B5%EA&number=10&batch=1&range=3000&a_k=用户key注：此URL仅为示例使用，不是最终服务提供URL 返回结果说明此接口返回的结果集数量（默认最大结果集为400，可通过key权限修改，需要联系管理员）此数据是否从缓存读取引擎返回的结果集总数量此页返回的结果集数量（最大结果集为20）查询时间bounds值，当前返回的POI点统一个矩形框内，bounds为矩形框的左上右下坐标对地址POI名称POI类型数据时间戳匹配度url连接周边查询时，距离中心点距离x坐标y坐标城市号索引ID，可以根据此ID查询POI数据源5916728612电话图片ID扩展查询字段，编辑器或者公交数据中，可能存在该字段，扩展字段的含义和具体行业有关，该部分内容由应用自己去解析周边查询按照导航距离排序时，距中心点的导航距离 其他需要说明的部分1.2.4根据两条线的交叉点坐标查询周边POI接口功能介绍根据两点线的交叉点坐标查询周边POI。接口参数说明参数名称参数格式参数含义备注configconfig=SPAS服务参数名称必填参数encenc=GB2312编码规则必填参数spatialXMLspatialXml=为上层传入的参数，sis端需要对其解析。spatialXml参数为一个标准的xml格式经过urldecode进行utf-8编码后的结果必填参数a_ka_k=api key用户申请的key必填参数未编码前的spatialXml：医院医院1015001JPQMNTWRLIOOGKG,LXIXNNWWTMOKOO 0fjtelkknrvNOKM,iilghmqmstNGKE, 0接口URL示例/sisserver?&config=SPAS&enc=GB2312&spatialXml=%3C%3Fxml+version%3D%221.0%22+encoding%3D%22GB2312%22%3F%3E%0D%0A%3Cspatial_request+method%3D%22localSearchByLineIntersection%22%3E%0D%0A+%3CsearchName%3E%D2%BD%D4%BA%3C%2FsearchName%3E%0D%0A+%3CsearchType%3E%D2%BD%D4%BA%3C%2FsearchType%3E%0D%0A+%3CpageNum%3E10%3C%2FpageNum%3E%0D%0A+%3CpageSum%3E1%3C%2FpageSum%3E%0D%0A+%3Cbatch%3E1%3C%2Fbatch%3E%0D%0A+%3Crange%3E500%3C%2Frange%3E%0D%0A+%3CsortRule%3E1%3C%2FsortRule%3E%0D%0A+%3Cspatial_geos%3E%0D%0A+%3Cspatial_geo+type%3D%22Line%22%3E%0D%0A+%3Ccoor%3EJPQMNTWRLIOOGKG%2CLXIXNNWWTMOKOO%2CJPQMQTTUQGSKKOK%2CLXIXOQXYQPKKGO%2CJPQMQTTUQGSOOKG%2CLXIXOQXYQPKOKK%2CJPQMNTWRLIOKKKO%2CLXIXNNWWTMKKKO%3C%2Fcoor%3E%0D%0A+%3Cbuffer%3E0%3C%2Fbuffer%3E%0D%0A+%3C%2Fspatial_geo%3E%0D%0A+%3Cspatial_geo+type%3D%22Line%22%3E%0D%0A+%3Ccoor%3EJPQMNTWRLIOOGKG%2CLXIXNNWWTMOKOO%2CJPQMQTTUQGSKKOK%2ChrlokjklruNOGI%2CfjteljpgttjNGGM%2ChrlokjsitqFKGM%2CfjtelkknrvJKOM%2CiilghmqmstFOGE%3C%2Fcoor%3E%0D%0A+%3Cbuffer%3E0%3C%2Fbuffer%3E%0D%0A+%3C%2Fspatial_geo%3E%0D%0A+%3C%2Fspatial_geos%3E%0D%0A%3C%2Fspatial_request%3E&a_k=用户key注：此URL仅为示例使用，不是最终服务提供URL 返回结果说明60011医疗保健服务;综合医院;三级甲等医院010B000A82VAR2009-04-19304医院basepoi5916720420海淀区阜成路51号010-668673111441 moohhnlqpntKJDH owgsgrlrloOJHH . moohgupwlkKJHL;owgsfslnqgOFLL;moohhoonsjuKFDD;owgsiqkooKJHD 其他需要说明的部分1.2.5根据两条道路交叉点查询接口功能介绍根据两条道路交叉点查询周边。接口参数说明1、通过道路ID查询两条道路的交叉路口参数名称参数格式参数含义备注configconfig=SPAS服务参数名称必填参数encenc=GB2312编码规则必填参数spatialXMLspatialXml=为上层传入的参数，sis端需要对其解析。spatialX