地址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)}
);

搜索矩形范围内符合条件的地址实例展示:

小伙伴们,如果你们也热衷于基于地图应用的开发,那就快来试试我们的API吧!