提供根据用户输入的关键词查询返回相匹配的POI信息或其他信息，减少用户的输入量。

根据用户输入的关键词查询返回相匹配的POI信息或其他信息

https://api.careland.com.cn/api/v2/suggest

post、get

请求参数

参数名称	是否必填	默认值	格式举例	说明
ak	是			用户key
xytype	否	0		坐标类型： 0为凯立德坐标系 2为国家加密坐标系
keyword	是		北京	查询关键词当keyword为非类型词时返回匹配的POI或地址、公交线路信息；当keyword为类型词时返回匹配的属于该类型的poi
adcode	否		110000	行政区划代码。通过用户位置或图面范围或其他场景指定的城市代码，默认全国
city	否			城市名，优先级高于图面（bounds），低于adcode
adcode_type	否	0	0 或 1	输入输出行政区编码类型 0 凯立德标准编码 1 国际标准编码
callback	否			回调函数 callback值是用户定义的函数名称，此参数只在output=jso n时有效

请求示例

https://api.careland.com.cn/api/v2/suggest?ak=<您的密钥>&adcode=440104&keyword=中石化加油站

返回结果示例

{
  "errorCode": 0,
  "errorMessage": "ok",
  
   "pois": [
	 {
	   "id": 1925060,
	   "name": "中国石化加油站",
	   "address": "",
	   
	   "pcd": {
	      "adcode": 440104,
	      "province": "广东省",
		  "province_code": 440000,
		  " city _code": 440300,
		  "city": "广州市",
		  "district": "越秀区"
	    },
	    "tel_num": [],
	    
	    "xy": {
			"name": 113.054538,
			"level": 22.954798
	    },
	    "type_code": 20050300,
	    "type_name": "中石化加油站",
	    "road_id": 0,
	    "distance": 0,
	    
	    "routingpointscount": 0,
	    "preferred": true
	  },
	  {
	    "id": 1924322,
	    "name": "中国石化加油站",
	    "address": "",
	    
	    "pcd": {
	      "adcode": 440104,
	      "province": "广东省",
	      "city": "广州市",
	      "district": "越秀区"
	    },
	    "tel_num": [],
	    
	    "xy": {
			"name": 113.038963,
			"level": 22.970757
	    },
	    "type_code": 20050300,
	    "type_name": "中石化加油站",
	    "road_id": 0,
	    "distance": 0,
	    "preferred": true,
		"routingpointscount": 0
	    
	},
	{
		"id": "1405433",
		"name": "中国石化加油站",
		"address": "",
		"pcd": {
			"adcode": 440104,
			"province": "广东省",
			"city": "广州市",
			"district": "越秀区"
		},
		"tel_num": [],
		"xy": {
			"name": 113.056434,
			"level": 22.939713
		},
		"type_code": 20050300,
		"type_name": "中石化加油站",
		"road_id": 0,
		"distance": 0,
		"preferred": true,
		"routingpointscount": 0
		}
	  }
    ]
}

返回参数说明

名称			类型	说明
errorCode			String	错误代码
errorMessage			String	错误描述
pois			Object[]	返回的POI信息（仅包含i d，名称，地址，PCD信息及坐标），或其他信息（包括公交线路信息、地址信息或其他信息），非P OI信息的判断标准为是否包含POIID
	id		String	选填 POI ID
	name		String	选填 POI名称
	pcd		Object	返回结果所在的省市区
		adcode	String	行政区划代码
		province	String	省、直辖市名称
		province_code	Int	省、直辖市代码
		city_code	Int	地市代码
		city	String	地市名称
		district	String	县区名称
	address		String	选填地址信息
	tel_num		String	重复电话信息
	xy		Object	选填 POI的经纬度坐标
		x	String	经度乘以1000000
		y	String	纬度乘以1000000
	type_code		String	POI 类型代码
	type_name		String	POI 类型名称
	road_id		String	选填道路ID
	distance		String	到指定点的距离
	preferred		boolean	是否推荐显示
	sub_pois		poi[]	重复该POI包含的子POI信息