地图搜索服务

1 服务介绍

地名搜索服务是一类简单的HTTP/HTTPS接口，包括普通搜索、视野内搜索、周边搜索、多边形搜索、行政区域搜索、分类搜索、统计搜索。

2 普通搜索服务

2.1 输入参数说明

参数值	参数说明	参数类型	是否必备	备注（值域）
keyWord	搜索的关键字	String	必填	无
mapBound	查询的地图范围(“minx,miny,maxx,maxy”)	String	必填	-180,-90至180,90。
level	目前查询的级别	String	必填	1-18级
specify	指定行政区的国标码（行政区划编码表）严格按照行政区划编码表中的（名称，gb码）。如指定的行政区划编码是省以上级别则返回是统计数据（不包括直辖市）	String	可选	下载行政区划编码表。9位国标码，如：北京：156110000或北京。
queryType	搜索类型	String	必填	1:普通搜索（含地铁公交） 7：地名搜索
start	返回结果起始位（用于分页和缓存）默认0	String	必填	0-300，表示返回结果的起始位置。
count	返回的结果数量（用于分页和缓存）	String	必填	1-300，返回结果的条数。
dataTypes	数据分类（分类编码表）	String	可选	下载分类编码表，参数可以分类名称或分类编码。多个分类用","隔开(英文逗号)。
show	返回poi结果信息类别	String	可选	取值为1，则返回基本poi信息； 取值为2，则返回详细poi信息

2.2 返回参数说明

响应的数据格式为Json格式。

参数值			参数说明	参数类型	返回条件	备注（值域）
resultType			返回结果类型	Int	必返回	取值1-5，对应不同的响应类型： 1（普通POI），2（统计），3（行政区)，4（建议词搜索），5（线路结果）
count			返回总条数	Int	必返回
keyword			搜索关键词	String	必返回	搜索的关键字。
pois			针对点（类型1）集合返回	Pois Json数组		resultType=1
	name		Poi点名称	String	必返回
	phone		电话	String
	address		地址	String
	lonlat		坐标	String	必返回	坐标 x，y
	poiType		poi类型	Int	必返回	101:POI数据 102:公交站点
	eaddress		英文地址	String
	ename		poi点英文名称	String
	hotPointID		poi热点ID	String	必返回	热点id
	province		所属省名称	String
	provinceCode		省行政区编码	String
	city		所属城市名称	String
	cityCode		市行政区编码	String
	county		所属区县名称	String
	countyCode		区县行政区编码	String
	source		数据信息来源	String	必返回
	typeCode		分类编码	String
	typeName		分类名称	String
	stationData		车站信息结构体 数据	Json 数组		poiType=102
		lineName	线路名称	String	必返回
		uuid	线路的id	String	必返回
		stationUuid	公交站uuid	String	必返回
prompt			提示信息，如“您是否在XXX，搜索XXX”，其中包含提示文字及对应的行政区码	Json	需要提示时返回
	type		提示类型	Int	必返回	1：是否在where搜what，2：在where无搜索what的结果，3：多个可跳转的行政区提示，4：城市
	admins			Json数组	必返回
		adminName	行政区名称	String	必返回
		adminCode	行政区划编码	String	必返回
statistics			针对统计（类型2）集合返回	Json 数组		resultType=2
	count		返回搜索POI总数量	Int	必返回
	adminCount		行政区数量	Int	必返回
	priorityCitys		推荐行政区名称	Json数组	必返回
		name	行政区名称	String	必返回
		count	城市数量	Int	必返回
		lonlat	行政区中心点经纬度	String	必返回	坐标 x，y
		ename	英文行政名称	String	必返回
		adminCode	城市国标码	Int	必返回	9位国标码。
	allAdmins		各省包含信息集合	Json数组	必返回
		name	行政区名称	String	必返回
		count	包含数量	Int	必返回
		lonlat	行政区中心点经纬度	String	必返回	坐标x,y
		adminCode	省国标码	String	必返回
		ename	英文行政名称	String	必返回
		isleaf	有无下一级行政区	boolean	必返回	有则false，无则true
area			针对行政区省（类型3）集合点	Json 数组		resultType=3
	name		名称	String	必返回
	bound		定位范围(“minx,miny,maxx,maxy”)	String	必返回
	lonlat		定位中心点坐标	String	必返回
	adminCode		行政区编码	Int	必返回
	level		显示级别	Int	必返回	1-18级
lineData			线路结果	Json 数组		resultType=5
	stationNum		站数量	String	必返回
	poiType		类型为“103”	String	必返回	poiType=102
	name		线路名称	String	必返回
	uuid		线路id	String	必返回
status			返回状态信息	Json 数组	必返回	结果提示信息
	infocode		信息码	Int	必返回	服务状态码表
	cndesc		返回中文描述	String	必返回	服务状态码表

2.3 普通搜索示例

请求实例
http://ip:port/v2/search?postStr={"keyWord":"北京大学","level":12,"mapBound":"116.02524,39.83833,116.65592,39.99185","queryType":1,"start":0,"count":10}&type=query

3 视野内搜索服务

3.1 输入参数说明

参数值	参数说明	参数类型	是否必备	备注（值域）
keyWord	搜索的关键字	String	必填	无
mapBound	地图视野范围(“minx,miny,maxx,maxy”)	String	必填	-180,-90至180,90。
level	目前查询的级别	String	必填	1-18级
queryType	服务查询类型参数	String	必填	2：视野内搜索
start	返回结果起始位（用于分页和缓存）默认0	String	必填	0-300，表示返回结果的起始位置。
count	返回的结果数量（用于分页和缓存）	String	必填	1-300，返回结果的条数。
dataTypes	数据分类（分类编码表）	String	可选	下载分类编码表，参数可以分类名称或分类编码。多个分类用","隔开(英文逗号)。
show	返回poi结果信息类别	String	可选	取值为1，则返回基本poi信息； 取值为2，则返回详细poi信息

3.2 返回参数说明

响应的数据格式为Json格式。

参数值			参数说明	参数类型	返回条件	备注（值域）
resultType			返回结果类型	Int	必返回	取值1-5，对应不同的响应类型： 1（普通POI），2（统计），3（行政区)，4（建议词搜索），5（线路结果）
count			返回总条数	Int	必返回
keyword			搜索关键词	String	必返回	搜索的关键字。
pois			针对点（类型1）集合返回	Pois Json数组		resultType=1
	name		Poi点名称	String	必返回
	phone		电话	String
	address		地址	String
	lonlat		坐标	String	必返回	坐标 x，y
	poiType		poi类型	Int	必返回	101:POI数据 102:公交站点
	eaddress		英文地址	String
	ename		poi点英文名称	String
	hotPointID		poi热点ID	String	必返回	热点id
	province		所属省名称	String
	provinceCode		省行政区编码	String
	city		所属城市名称	String
	cityCode		市行政区编码	String
	county		所属区县名称	String
	countyCode		区县行政区编码	String
	source		数据信息来源	String	必返回
	typeCode		分类编码	String
	typeName		分类名称	String
	stationData		车站信息结构体 数据	Json 数组		poiType=102
		lineName	线路名称	String	必返回
		uuid	线路的id	String	必返回
		stationUuid	公交站uuid	String	必返回
prompt			提示信息，如“您是否在XXX，搜索XXX”，其中包含提示文字及对应的行政区码	Json	需要提示时返回
	type		提示类型	Int	必返回	提示类型： 1：是否在where搜what，2：在where无搜索what的结果，3：多个可跳转的行政区提示，4：城市
	admins			Json数组	必返回
		adminName	行政区名称	String	必返回
		adminCode	行政区划编码	String	必返回
	keyword		关键字	String	必返回
statistics			针对统计（类型2）集合返回	Json 数组		resultType=2
	count		搜索结果总条数	Int	必返回
	adminCount		行政区数量	Int	必返回
	priorityCitys		推荐行政区名称	Json数组	必返回
		name	行政区名称	String	必返回
		count	城市数量	Int	必返回
		lonlat	行政区中心点经纬度	String	必返回	坐标 x，y
		ename	英文行政名称	String	必返回
		adminCode	城市国标码	Int	必返回	9位国标码。
	allAdmins		各省包含信息集合	Json数组	必返回
		name	行政名称	String	必返回
		count	包含数量	Int	必返回
		lonlat	行政区中心点经纬度	String	必返回	坐标x,y
		adminCode	省国标码	String	必返回
		ename	英文行政名称	String	必返回
		isleaf	有无下一级行政区	boolean	必返回	有则false，无则true
area			针对行政区省（类型3）集合点	Json 数组		resultType=3
	name		名称	String	必返回
	bound		定位范围(“minx,miny,maxx,maxy”)	String	返回
	lonlat		定位中心点坐标	String	必返回
	adminCode		行政区编码	Int	必返回
	level		显示级别	Int	必返回	1-18级
lineData			线路结果	Json 数组		resultType=5
	stationNum		站数量	String	必返回
	poiType		类型为“103”	String	必返回	poiType=102
	name		线路名称	String	必返回
	uuid		线路id	String	必返回
status			返回状态信息	Json 数组	必返回	结果提示信息
	infocode		信息码	Int	必返回	服务状态码表
	cndesc		返回中文描述	String	必返回	服务状态码表

3.3 视野内搜索示例

请求实例
http://ip:port/v2/search?postStr={"keyWord":"医院","level":12,"mapBound":"116.02524,39.83833,116.65592,39.99185","queryType":2,"start":0,"count":10}&type=query

4 周边搜索服务

4.1 输入参数说明

参数值	参数说明	参数类型	是否必备	备注（值域）
keyWord	搜索的关键字	String	必填	无
queryRadius	查询半径	String	必填	单位:米 （10公里内）
pointLonlat	点坐标	String	必填	中心点，经纬度坐标
queryType	服务查询类型参数	String	必填	3：周边搜索服务。
start	返回结果起始位（用于分页和缓存）默认0	String	必填	0-300，表示返回结果的起始位置。
count	返回的结果数量（用于分页和缓存）	String	必填	1-300，返回结果的条数。
dataTypes	数据分类（分类编码表）	String	可选	下载分类编码表，参数可以分类名称或分类编码。多个分类用","隔开(英文逗号)。
show	返回poi结果信息类别	String	可选	取值为1，则返回基本poi信息；取值为2，则返回详细poi信息

4.2 返回参数说明

参数值			参数说明	参数类型	返回条件	备注（值域）
resultType			返回结果类型	Int	必返回	取值1-5，对应不同的响应类型： 1（普通POI），2（统计），3（行政区)，4（建议词搜索），5（线路结果）
count			返回总条数	Int	必返回
keyword			搜索关键词	String	必返回	搜索的关键字。
pois			针对点（类型1）集合返回	Pois Json数组		resultType=1
	name		Poi点名称	String	必返回
	phone		电话	String
	address		地址	String
	lonlat		坐标	String	必返回	坐标 x，y
	poiType		poi类型	Int	必返回	101:POI数据 102:公交站点
	eaddress		英文地址	String
	ename		poi点英文名称	String
	hotPointID		poi热点ID	String	必返回	热点id
	province		所属省名称	String
	provinceCode		省行政区编码	String
	city		所属城市名称	String
	cityCode		市行政区编码	String
	county		所属区县名称	String
	countyCode		区县行政区编码	String
	source		数据信息来源	String	必返回
	distance		距离（单位 m,km）	String	必返回	1千米以下单位为米（m），1千米以上单位为千米（km）
	typeCode		分类编码	String
	typeName		分类名称	String
	stationData		车站信息结构体 数据	Json 数组		poiType=102
		lineName	线路名称	String	必返回
		uuid	线路的id	String	必返回
		stationUuid	公交站uuid	String	必返回
prompt			提示信息，如“您是否在XXX，搜索XXX”，其中包含提示文字及对应的行政区码	Json	需要提示时返回
	type		提示类型	Int	必返回	提示类型： 1：是否在where搜what，2：在where无搜索what的结果，3：多个可跳转的行政区提示，4：城市
	admins			Json数组	必返回
		adminName	行政区名称	String	必返回
		adminCode	行政区划编码	String	必返回
	keyword		关键字	String	必返回
status			返回状态信息	Json 数组	必返回	结果提示信息
	infocode		信息码	Int	必返回	服务状态码表
	cndesc		返回中文描述	String	必返回	服务状态码表

4.2 周边搜索示例

请求实例
http://ip:port/v2/search?postStr={"keyWord":"公园","level":12,"queryRadius":5000,"pointLonlat":"116.48016,39.93136","queryType":3,"start":0,"count":10}&type=query

5 多边形搜索服务

5.1 输入参数说明

参数值	参数说明	参数类型	是否必备	备注（值域）
keyWord	搜索的关键字	String	必填	无
polygon	多边形范围数据(经纬度坐标对)	String	必填	经度和纬度用","分割，首尾坐标对需相同。实例(x1,y1,x2,y2,x3,y3,x4,y4,x5,y5,x1,y1)
queryType	服务查询类型参数	String	必填	10：多边形搜索服务。
start	返回结果起始位（用于分页和缓存）默认0	String	必填	0-300，表示返回结果的起始位置。
count	返回的结果数量（用于分页和缓存）	String	必填	1-300，返回结果的条数。
dataTypes	数据分类（分类编码表）	String	可选	下载分类编码表，参数可以分类名称或分类编码。多个分类用","隔开(英文逗号)。
show	返回poi结果信息类别	String	可选	取值为1，则返回基本poi信息； 取值为2，则返回详细poi信息

5.2 返回参数说明

参数值			参数说明	参数类型	返回条件	备注（值域）
resultType			返回结果类型	Int	必返回	取值1-5，对应不同的响应类型： 1（普通POI），2（统计），3（行政区)，4（建议词搜索），5（线路结果）
count			返回总条数	Int	必返回
keyword			搜索关键词	String	必返回	搜索的关键字。
pois			针对点（类型1）集合返回	Pois Json数组		resultType=1
	name		Poi点名称	String	必返回
	phone		电话	String
	address		地址	String
	lonlat		坐标	String	必返回	坐标 x，y
	poiType		poi类型	Int	必返回	101:POI数据 102:公交站点
	eaddress		英文地址	String
	ename		poi点英文名称	String
	hotPointID		poi热点ID	String	必返回	热点id
	province		所属省名称	String		新加
	provinceCode		省行政区编码	String		新加
	city		所属城市名称	String		新加
	cityCode		市行政区编码	String		新加
	county		所属区县名称	String		新加
	countyCode		区县行政区编码	String		新加
	source		数据信息来源	String	必返回
	typeCode		分类编码	String		新加
	typeName		分类名称	String		新加
	stationData		车站信息结构体 数据	Json 数组		poiType=102
		lineName	线路名称	String	必返回
		uuid	线路的id	String	必返回
		stationUuid	公交站uuid	String	必返回
prompt			提示信息，如“您是否在XXX，搜索XXX”，其中包含提示文字及对应的行政区码	Json	需要提示时返回
	type		提示类型	Int	必返回	提示类型： 1：是否在where搜what，2：在where无搜索what的结果，3：多个可跳转的行政区提示，4：城市
	admins			Json数组	必返回
		adminName	行政区名称	String	必返回
		adminCode	行政区划编码	String	必返回
	keyword		关键字	String	必返回
status			返回状态信息	Json 数组	必返回	结果提示信息
	infocode		信息码	Int	必返回	服务状态码表
	cndesc		返回中文描述	String	必返回	服务状态码表

5.3 多边形搜索示例

请求实例
http://ip:port/v2/search?postStr={"keyWord":"学校","polygon":"118.93232636500011,27.423305726000024,118.93146426300007,27.30976105800005,118.80356153600007,27.311829507000027,118.80469010700006,27.311829508000073,118.8046900920001,27.32381604300008,118.77984777400002,27.32381601800006,118.77984779100007,27.312213007000025,118.76792266100006,27.31240586100006,118.76680145600005,27.429347074000077,118.93232636500011,27.423305726000024","queryType":10,"start":0,"count":10}&type=query

6 行政区划区域搜索服务

6.1 输入参数说明

参数值	参数说明	参数类型	是否必备	备注（值域）
keyWord	搜索的关键字	String	必填	无
specify	指定行政区的国标码（行政区划编码表）严格按照行政区划编码表中的（名称，gb码）	String	必填	下载行政区划编码表。9位国标码，如：北京：156110000或北京。
queryType	服务查询类型参数	String	必填	12：行政区划区域搜索服务。
start	返回结果起始位（用于分页和缓存）默认0	String	必填	0-300，表示返回结果的起始位置。
count	返回的结果数量（用于分页和缓存）	String	必填	1-300，返回结果的条数。
dataTypes	数据分类（分类编码表）	String	可选	下载分类编码表，参数可以分类名称或分类编码。多个分类用","隔开(英文逗号)。
show	返回poi结果信息类别	String	可选	取值为1，则返回基本poi信息； 取值为2，则返回详细poi信息

6.2 返回参数说明

参数值			参数说明	参数类型	返回条件	备注（值域）
resultType			返回结果类型	Int	必返回	取值1-5，对应不同的响应类型： 1（普通POI），2（统计），3（行政区)，4（建议词搜索），5（线路结果）
count			返回总条数	Int	必返回
keyword			搜索关键词	String	必返回	搜索的关键字。
pois			针对点（类型1）集合返回	Pois Json数组		resultType=1
	name		Poi点名称	String	必返回
	phone		电话	String
	address		地址	String
	lonlat		坐标	String	必返回	坐标 x，y
	poiType		poi类型	Int	必返回	101:POI数据 102:公交站点
	eaddress		英文地址	String
	ename		poi点英文名称	String
	hotPointID		poi热点ID	String	必返回	热点id
	province		所属省名称	String
	provinceCode		省行政区编码	String
	city		所属城市名称	String
	cityCode		市行政区编码	String
	county		所属区县名称	String
	countyCode		区县行政区编码	String
	source		数据信息来源	String	必返回
	typeCode		分类编码	String
	typeName		分类名称	String
	stationData		车站信息结构体 数据	Json 数组		poiType=102
		lineName	线路名称	String	必返回
		uuid	线路的id	String	必返回
		stationUuid	公交站uuid	String	必返回
statistics			针对统计（类型2）集合返回	Json 数组		resultType=2
	count		本次统计POI总数量	Int	必返回
	adminCount		行政区数量	Int	必返回
	priorityCitys		推荐行政区名称	Json数组	必返回
		name	行政区名称	String	必返回
		count	城市数量	Int	必返回
		lonlat	行政区经纬度	String	必返回	坐标 x，y
		ename	英文行政名称	String	必返回
		adminCode	城市国标码	Int	必返回	9位国标码。
	allAdmins		各省包含信息集合	Json数组	必返回
		name	行政名称	String	必返回
		count	包含数量	Int	必返回
		lonlat	行政区经纬度	String	必返回	坐标x,y
		adminCode	省国标码	String	必返回
		ename	英文行政名称	String	必返回
		isleaf	有无下一级行政区	boolean	必返回	有则false，无则true
area			针对行政区省（类型3）集合点	Json 数组		resultType=3
	name		名称	String	必返回
	bound		定位范围(“minx,miny,maxx,maxy”)	String	返回
	lonlat		定位中心点坐标	String	必返回
	adminCode		行政区编码	Int	必返回
	level		显示级别	Int	必返回	1-18级
lineData			线路结果	Json 数组		resultType=5
	stationNum		站数量	String	必返回
	poiType		类型为“103”	String	必返回
	name		线路名称	String	必返回
	uuid		线路id	String	必返回
status			返回状态信息	Json 数组	必返回	结果提示信息
	infocode		信息码	Int	必返回	服务状态码表
	cndesc		返回中文描述	String	必返回	服务状态码表

6.3 行政区划区域搜索示例

请求实例
http://ip:port/v2/search?postStr={"keyWord":"商厦","queryType":12,"start":0,"count":10,"specify":"156110108"}&type=query