地理编码服务将结构化地址数据,（如：深圳市福田区深南大道6023号）转换为对应经纬度

注意：如地址描述过于简单，如前进大街6号，因全国会有很多匹配结果，服务无法判断用户请求的是哪一个，则服务返回无结果。如果有可通过匹配度区分的唯一返回值或者通过限定参数得到唯一返回值，则返回该值。

即地址解析，通过对请求的描述性地址进行分拆解析，将描述性地址转换为经纬度坐标。解析的坐标精度越高。

http://api.careland.com.cn/api/v2/geo

post、get

请求参数

参数名称	是否必填	默认值	格式举例	说明
ak	是			用户key
xytype	否	0		坐标类型： 0为凯立德坐标系 2为国家加密坐标系
address	是			需要解析的描述性地址，通常包括省、地市、区县等
city	否		如：北京	再由多条返回且同等匹 配度的情况下，优先返 回指定城市的结果
app	否	webapi		应用名称及版本（基础服务统计说明）
restricted	否	boolean	true或false	是否限定在请求的城市范围内搜索。如设为true，则仅在指定城市解析。 如设为false或不传，则在其他城市有匹配度更高的地址，则返回其他城市的结果。
adcode_type	否	0	0或1	输入输出行政区编码类型 0凯立德标准编码 1凯立德标准码 当输入adcode_type=1时，输入的行政区编码会优先检查是否是国标标准， 不是国标标准会再次检查是否是凯立德编码，当adcode_type=0时，只会检查凯立德编码。
callback	否			回调函数 callback值是用户定义的函数名称，此参数只在output=json时有效

请求示例

http://api.careland.com.cn/api/v2/geo?ak=<您的密钥>&address=深圳市福田区车公庙创建大厦27楼&city=深圳&restricted=true

返回结果示例

{
	"errorCode": "0",
	"errorMessage": "ok",
	"results": [
		"p": {
			"x": 113.782168,
			"y": 22.363634
		},
		"range": 300,
		"precise": true,
		"pcd": {
			"adcode": 440304,
			"province": "广东省",
			"province_code":440000, 
			"city_code":440300,
			"city": "深圳市",
			"district": "福田区"
		},
		"matched": [
			{
				"name": "深圳市",
				"level": "GEO_CITY",
				"xy": {
					"x": -0.3337,
					"y": -0.2373
				}
			},
			{
				"name": "福田区",
				"level": "GEO_COUNTY",
				"xy": {
					"x": 0,
					"y": 0
				}
			},
			{
				"name": "车公庙",
				"level": "GEO_AREA",
				"xy": {
					"x": 0,
					"y": 0
				}
			},
			{
				"name": "创建大厦",
				"level": "GEO_POI",
				"xy": {
					"x": 0,
					"y":0
				}
			},
			{
				"name": "26",
				"level": "GEO_NUMBER",
				"xy": {
					"x": 0,
					"y": 0
				}
			}
		],
		"confidence": 1
	}
	]
}
		

返回参数说明

名称				类型	说明
errorCode				String	错误代码
errorMessage				String	错误代码
results				Object[]	返回的地理编码结果
	p			Object	解析描述性地址返回的坐标结果
		x		String	经度
		y		String	纬度
	range			String	坐标精度误差估算
	precise			Boolean	是否精确匹配到结果
	pcd			Object	返回结果所在的省市区
		adcode		String	行政区划代码
		province		String	省、直辖市名称
		province_code		int	省、直辖市代码
		city_code		int	地市代码
		city		String	地市名称
		district		String	县区名称
	matched			Object[]
		name		String	当前层级的名称，例如 广东省
		level		String	对应GeoLevel的地址分级等级，例如GEO_PROVINCE
		xy		Object	当前层级的中心点坐标
			x	String	经度
			y	String	纬度
	shapes			Object	后匹配到结果的点线面形状数据集合
		base		Object	基准点经纬度坐标
			x_diff	String	较上一个坐标点的经度差值
			y_diff	String	较上一个坐标点的纬度差值
	confidence			String	匹配度结果，用于筛选、排序