地理编码

使用服务 下载SDK: php

高德地图地理编码服务指从已知的结构化地址描述到对应的经纬度坐标的转换，同时支持地理编码的逆过程即逆地理编码。

地理编码又称地址匹配，指的是从已知的结构化地址描述（如：朝阳区阜通东大街6号）到对应的经纬度坐标（如：116.482268,39.990161）的转换，即根据结构化的地址信息，查询所对应的点坐标的过程。高德地图地理编码接口通过HTTP请求直接访问。同时支持地理编码的逆过程，即：逆地理编码。
示例代码：
define("SAE_ACCESSKEY", "");
define("SAE_SECRETKEY", "");
//载入方法一
$Geocoding = apibus::init("Geocoding");

error_reporting(E_ALL);
ini_set('display_errors','On');

/*
//载入方法二
$api = new apibus();
$Geocoding = $api->load("Geocoding");
*/
//amapgeo($key,$address,$city=null,$output='json',$callback=null)
//var_dump($Geocoding);
print_r(json_decode($Geocoding->amapgeo('28506cee0cec0e1a3746932b1e00a190','中关村','北京'),true));

//amapregeo($key,$location,$radius='1000',$output='json',$callback=null,$extensions='base')
//var_dump($Geocoding);
echo '';
                   
print_r(json_decode($Geocoding->amapregeo('28506cee0cec0e1a3746932b1e00a190','114.265216,36.893469'),true));

Methods

amapgeo(GET)

参数

keyString

用户唯一标识，在高德地图官网申请，申请地址：http://api.amap.com/key/register

addressString

详细地址描述

cityString

查询城市，可选值：cityname（中文或中文全拼）、citycode、adcode

outputString

返回数据格式类型，可选值：json,xml

callbackString

回调函数，callback值是用户定义的函数名称，此参数只在output=json时有效

srcString

新浪云sdk标识，默认值：SAE

返回

返回示例

返回值及说明如下：
status	返回结果状态值，值为0或1,0表示请求失败；1表示请求成功
count	返回结果数目。通常返回一个结果，但是在进行模糊地址查询时，可能会返回多个结果。
info	返回状态说明，status为0时，info返回错误原因，否则返回“OK”。详情参阅info状态表

geocodes	地理编码信息列表
	formatted_address结构化地址信息
	province	地址所在的省份名
	city	        地址所在的城市名
	citycode	城市编码
	district	地址所在的区
	township	地址所在的乡镇
	street	街道
	number	门牌
	neighborhood	社区信息列表，保留字段，此版本不返回数据
		name	社区名
		type	社区类型
	building	楼信息列表，保留字段，此版本不返回数据
		name	楼名
		type	楼的类型
	adcode	        区域编码
	location	坐标点，经度在前，纬度在后，经纬度间以“，”分隔
	level	        匹配级别。
举例：["status value","count value","info value","[some array value]","formatted_address value","addressComponent value","province value","city value","district value","township value","street value","number value","[some array value]","name value","type value","[some array value]","location value","id value","distance value","direction value","[some array value]","first_id value","first_name value","second_id value","second_name value","[some array value]","tel value"]

错误返回示例

INVALID_USER_KEY	用户key非法或过期
SERVICE_NOT_EXIST	请求服务不存在
SERVICE_RESPONSE_ERROR	请求服务响应错误
INSUFFICIENT_PRIVILEGES	无权限访问此服务
OVER_QUOTA	        请求超出配额
INVALID_PARAMS	        请求参数非法
UNKNOWN_ERROR	        未知错误
举例["info value"]

amapregeo(GET)

参数

keyString

用户唯一标识，在高德地图官网申请，申请地址：http://api.amap.com/key/register

locationString

经纬度坐标。经度在前，纬度在后，经纬度间以“，”分割，经纬度小数点后不得超过6位

radiusString

搜索半径。取值范围：0~3000，默认值：1000，单位：米，

outputString

返回数据格式类型。可选值：json,xml

callbackString

回调函数。callback值是用户定义的函数名称，此参数只在output=json时有效

extensionsString

返回结果控制，此项默认取值：base返回基本地址信息；取值为all返回地址信息、附近POI、道路以及道路交叉口信息。

srcString

新浪云sdk标识，默认值：SAE

返回

返回示例

返回结果及说明如下：
status	返回结果状态值，值为0或1,0表示false；1表示true
info	返回状态说明，status为0时，info返回错误原因，否则返回“OK”

regeocode	数组，包含以下字段
	formatted_address	结构化地址信息
	addressComponent	地址元素列表
		province	坐标点所在省名称
		city	        坐标点所在城市名称
		district	坐标点所在区
		township	坐标点所在乡镇
		neighborhood	社区信息列表
			name	社区名称
			type	类型
		building	楼信息列表
			name	建筑名称
			type	类型
		streetNumber	门牌信息列表
			street	街道名称
			number	门牌号
			location坐标点
			direction方向
			distance门牌地址到请求坐标的距离
	roads	道路信息列表，请求参数extensions=all时返回；extensions=base时不返回
		id	道路id
		name	道路名称
		distance道路到请求坐标的距离
		direction方位
		location坐标点
	roadinters	道路交叉口列表，请求参数extensions=all时返回；extensions=base时不返回
		distance	交叉路口到请求坐标的距离
		direction	方位
		location	路口经纬度
		first_id	第一条道路id
		first_name	第一条道路名称
		second_id	第二条道路id
		second_name	第二条道路名称
	pois	poi信息列表，请求参数extensions=all时返回；extensions=base时不返回
		id	兴趣点id
		name	兴趣点名称
		type	兴趣点类型
		tel	电话
		distance该POI到请求坐标的距离
		direction方向
		location坐标点
举例：["status value","count value","info value","[some array value]","formatted_address value","addressComponent value","province value","city value","district value","township value","street value","number value","[some array value]","name value","type value","[some array value]","location value","id value","distance value","direction value","[some array value]","first_id value","first_name value","second_id value","second_name value","[some array value]","tel value"]

错误返回示例

INVALID_USER_KEY	用户key非法或过期
SERVICE_NOT_EXIST	请求服务不存在
SERVICE_RESPONSE_ERROR	请求服务响应错误
INSUFFICIENT_PRIVILEGES	无权限访问此服务
OVER_QUOTA	        请求超出配额
INVALID_PARAMS	        请求参数非法
UNKNOWN_ERROR	        未知错误
举例{"info":"info value"}