地址API详解与实例
利用地图作为信息载体做过应用的小伙伴们,对于地址解析和坐标转换应该都不陌生吧。前面的博文介绍了部分地图API的使用,如导航API的使用,也利用这些API做了一些小例子。本文主要介绍下我们地址API的使用,并结合我们的==JavaScript SDK==做了实例demo,让我们一起来看看吧。
地址API知识点与核心方法
地址API模块主要分为四个部分:行政区划查询、地址解析、搜索一个坐标附近符合条件的地址、搜索一个矩形范围内符合条件的地址,下面主要介绍下每个部分的方法详情。
-
行政区划查询之admin方法参数详情
-
地址解析之geocode方法参数详情
-
搜索一个坐标附近符合条件的地址之searchNear方法参数详情
-
搜索一个矩形范围内符合条件的地址之searchRect方法参数详情
地址API的使用与实例展示
在使用API之前,需要获取API使用权限,具体方法详见博文==导航API使用简介之出行时间规划==。各方法的实例以北京地区为例子,其中也用‘北京大学’作为周边查询的例子,主要也是因为smile_yun童鞋马上也要进入北京大学读研啦,嘿嘿,希望读研的这段时光能够学有所成、不负青春!不好意思,扯远了,下面我们一起来看看各个核心方法的使用以及实例展示吧。
- 行政区划查询(admin方法)
GAPI.geocoding.admin(
'朝阳', //待查询的行政区,如‘朝阳’、‘海淀’
{
parent:'北京' //查询行政区划的父级行政区划,如‘北京’
},
function(data){console.log(data)}, //成功后获取的数据
function(error){console.error(error)} //查询失败
);
行政区划查询实例展示:
- 地址解析(geocode方法)
GAPI.geocoding.geocode(
'北京大学', //需要解析的地址,如‘北京大学’
{
admin:'北京', //帮助限定地址范围的行政区名称,如"北京"
limit:10, //最多返回的结果数目,取值范围为1到100
minSimilarity:50 //返回结果至少满足的相似度,取值范围为0到100
},
function(data){console.log(data)},
function(error){console.error(error)}
);
地址解析实例展示:
- 搜索一个坐标附近符合条件的地址(searchNear方法)
GAPI.geocoding.searchNear(
116.310015, //坐标经度,(中国带偏移)
39.991967, //坐标纬度,(中国带偏移)
'大学', //查询条件,如‘大学’、‘医院’
{
radius:200, //搜索半径
limit:10, //最多返回的结果数目
minSimilarity:50 //返回结果至少满足的相似度
},
function(data){console.log(data)},
function(error){console.error(error)}
);
搜索坐标附近符合条件的地址实例展示:
- 搜索一个矩形范围内符合条件的地址(searchRect方法)
GAPI.geocoding.searchRect(
116.310001, //最小经度坐标(中国带偏移)
39.991950, //最小纬度坐标(中国带偏移)
116.321632, //最大经度坐标(中国带偏移)
39.996899, //最大纬度坐标(中国带偏移)
'大学', //查询条件关键字,如"大学"
{
limit:10, //最多返回的结果数目,取值范围为1到100
minSimilarity:50 //返回结果至少满足的相似度
},
function(data){console.log(data)},
function(error){console.error(error)}
);
搜索矩形范围内符合条件的地址实例展示: