一、功能介绍
地址解析接口可以根据地址描述查询到具体位置，如果查询成功，则返回的结果是唯一的，主要是通过解析精度级别（共11级）来确定坐标是否准确。
二、密钥申请
1. 用户登录
打开腾讯位置服务主页 点击右上角的登录按钮：
2. 验证信息
点击控制台，进入个人中心 -> 我的信息完成验证。
3. 申请密钥
点击左侧应用管理下的我的应用：
点击创建应用，填写应用名称，选择应用类型：
创建成功后，可以在管理界面查看到密钥信息：
4. 密钥配置
密钥申请通过后，可以点击编辑按钮添加描述，并可以选择启用的产品，以及对调用规则进行限制：
同时，可以在配额管理 -> 我的额度查看各接口的用量情况：
三、操作步骤
1. 开发文档入口
滑动到上方菜单的开发文档 -> 选择服务端下的WebService API：
点击左侧的地址解析（地址转坐标）：
2. 接口测试
可以直接使用Postman工具来测试，或者使用Postwomen（Postman他女朋友，唉，连工具都成双入对了，写个代码都要被虐，罢了，好好打工）。
由文档可知，接口的请求类型为GET，默认的数据返回格式为JSON。必填参除了开发者密钥还有address字段，并且文档中建议地址包含城市名称。
3. 返回结果
本接口适合有具体，并较为完整的名称信息时使用。因为返回的结果唯一，如果只提供了部分关键信息可能导致返回的结果与预期偏差较大。
{ "status": 0, "message": "query ok", "result": { "title": "ECO中科爱克大厦", "location": { "lng": 116.331284, "lat": 39.980824 }, "ad_info": { "adcode": "110108" }, "address_components": { "province": "北京市", "city": "北京市", "district": "海淀区", "street": "", "street_number": "" }, "similarity": 0.8, "deviation": 1000, "reliability": 7, "level": 10 } }
字段含义可见下表（可在接口文档中找到）：
level解析级别表：
四、使用案例
在使用地址解析接口时，主要是为了能够在地图中较为精确的标记位置，一般是将现有的具体地址转换为坐标时使用。如果结合用户操作，同时保证结果的准确性，可以结合使用关键词提示接口，帮助补全地址信息，可参考如下文章：
1. 功能整合
首先构建一个基本的地图，同时整合关键词提示功能，定义一个功能按钮：
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title></title> <style type="text/css"> #container { /*地图(容器)显示大小*/ width: 800px; height: 400px; } </style> <!--引入css样式文件--> <link rel="stylesheet" type="text/css" href="css/jquery-ui.min.css" /> <!--引入所需的jquery库文件--> <script src="js/jquery-1.7.1.min.js" type="text/javascript" charset="utf-8"></script> <!--引入jquery-ui文件--> <script src="js/jquery-ui.min.js" type="text/javascript" charset="utf-8"></script> <script type="text/javascript"> $(function() { $("#search").autocomplete({ //为文本框完成绑定 source: function(request, response) { //从request对象中获得文本框内容 var keyword = request.term; //定义数组，封装最终结果 var obj = []; $.ajax({ url: "https://apis.map.qq.com/ws/place/v1/suggestion", type: "get", dataType: "json", async: false, //关闭异步 data: { "key": "替换为自己的key", "keyword": keyword, "region": "北京" }, success: function(resp) { for (i in resp.data) { //此处可以根据需要自定义要显示的内容以及封装的数据 obj.push({ "label": resp.data[i].title + "[" + resp.data[i].province + "-" + resp.data[i].city + "-" + resp.data[ i].district + "]", //此处补全城市信息 "value": resp.data[i].city + resp.data[i].title }); //label为提示显示的内容 //value为选中后补全出现在文本框中的内容 } } }); //将obj最为结果返回 response(obj); } }); }); </script> <!--引入Javascript API GL，参数说明参见下文--> <script src="https://map.qq.com/api/gljs?v=1.exp&key=替换为自己的key"></script> <script> //定义初始中心点坐标 var center = new TMap.LatLng(40.046394,116.285335); //定义全局变量map var map; //定义全局变量markerLayer var markerLayer; //地图初始化函数 function initMap() { //调用 TMap.Map() 构造函数创建地图 map = new TMap.Map(document.getElementById('container'), { center: center,//设置地图中心点坐标 zoom: 18, //设置地图缩放级别 pitch: 43.5, //设置俯仰角 rotation: 45 //设置地图旋转角度 }); //初始化MultiMarker markerLayer = new TMap.MultiMarker({ map: map//指定地图容器 }); } // 页面加载完成后执行 $(function(){ //初始化显示地图 initMap(); //解析按钮点击事件绑定 $("#coder").click(function(){ //获取信息，在地图上进行标记(同时挪动中心点) }); }); </script> </head> <body> <div class="ui-widget"> <label for="search">搜索框: </label> <input type="text" id="search" style="width: 300px;"> <input type="button" id="coder" value="解析" /> </div> <br /> <!-- 定义地图显示容器 --> <div id="container"></div> </body> </html>
效果如下：
2. 地图回显
在搜索框中输入内容，根据提示补全，点击解析按钮后，挪动中心点，同时在地图上显示标记。
$("#coder").click(function(){ //获取信息，在地图上进行标记(同时挪动中心点) var address = $("#search").val(); $.ajax({ url:"https://apis.map.qq.com/ws/geocoder/v1/", type:"get", dataType:"json", data:{ "key":"替换为自己的key", "address":address },success:function(resp){ var lat = resp.result.location.lat; var lng = resp.result.location.lng; //重新设置中心点 map.setCenter(new TMap.LatLng(lat,lng)); markerLayer.add({ "id": 1,//此处为单次测试时使用，实际项目中注意区分 "styleId": 'marker',//内置样式，可直接使用 //指定放置位置 "position": new TMap.LatLng(lat, lng) }); } }); });
效果如下：
3. 完整案例源码
五、视频直达
腾讯位置 - 地址解析
写在结尾：作者力求做到将每个知识点细化，并且对于有关联的知识点都会使用传送门挂载链接。文章采用：“文字 + 配图 + 视频”的方式来进行展现，均是挤时间所作，希望看到这里能留下评论点个赞，略表支持！
