API&SDK简介

API(Application Programming Interface)是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。而sdk(Software Development Kit)是封装好的调用api的方法，用户在调用时只需要下载该 sdk 文档，根据相应规范进行调用即可。

高德开发平台数据开放情况

高德开放平台提供地图、定位、导航、搜索、路径规划、室内地图等服务，用户可利用高德针对不同平台和语言的api&sdk服务，获取其所需的数据。

高德api&sdk服务范围

以地图服务为例，高德开放平台提供2D，3D，卫星多种地图形式供开发者选择，完善的地图数据系统为用户提供poi数据、地址数据、公交数据、行政区划数据、天气数据、业务数据。且无论基于哪种平台，都可以通过高德开放平台提供的API和SDK轻松的完成地图的构建工作。同时，高德提供强大的地图再开发能力，全面的地图数据支持，离线在线两种使用方式，多种地图交互模式，满足各个场景下对地图的需求。

尝试使用高德微信小程序sdk

下面我以高德微信小程序sdk为例，尝试获取地址描述、POI数据和导航结果：

1. 在高德开放平台注册账号，在微信小程序sdk申请Key。

2. 配置工程。新建一个微信小程序项目，下载sdk，放到自己的程序目录下，引用时在头部进行路径声明

3. 写代码。

首先，引入 amap-wx.js 文件

//javascript

var amapFile = require('path/to/amap-wx.js');//如：..­/..­/libs/amap-wx.js

获取路线规划

路线规划常用于出行路线的提前预览，高德为用户提供了4种类型的路线规划，分别为：驾车、步行、公交和骑行。下面以驾车为例：

构造 AMapWX 对象，并调用 getDrivingRoute 方法，用户需要提供的参数包括origin(出发点的经纬度)、destination(目的地的经纬度)。

var myAmapFun = new amapFile.AMapWX({key: '高德Key'});

myAmapFun.getDrivingRoute({

origin: that.data.origin,

destination: that.data.destination,

success: function (data) {

console.log(data)

}

})

调用该方法的返回值为json格式：

路线规划请求返回值

编写相应的wxss和wxml代码后，小程序界面如下：

到四川省人民医院的驾车路线规划

获取poi数据

构造 AMapWX 对象，并调用 getPoiAround 方法，调用此方法不需要用户提供参数，高德将用户地理位置识别、结果marker输出都封装在了此方法内

myAmapFun.getPoiAround({

success: function(data){

//成功回调

},

fail: function(info){

//失败回调

console.log(info)

}

})

调用方法后，得到结果：

获取周边poi请求结果

获取输入提示词

输入提示是指根据用户输入的关键词，给出相应的提示信息，将最有可能的搜索词呈现给用户，以减少用户输入信息，提升用户体验。如：输入“方恒”，提示“方恒国际中心A座”，“方恒购物中心”等。

构造 AMapWX 对象，并调用 getInputtips 方法，代码如下：

myAmapFun.getInputtips({

keywords: keywords,

location: lonlat,

city: city,

success: function (data) {

console.log(data)

}

})

调用方法后，得到返回的json：

请求输入搜索结果返回值