一、什么是API

这周我们来了解一下API的学习和使用。 

应用程序接口(API),又称为应用编程接口,是软件系统不同组成部分衔接的约定。良好的接口设计可以降低系统各部分的相互依赖,提高组成单元的内聚性,降低组成单元间的耦合程度,从而提高系统的可维护性和可扩展性。”

百度百科解释API是:操作系统留给应用程序的一个调用接口,应用程序通过调用操作系统的 API 而使操作系统去执行应用程序的命令。这个解释很官方,很专业。我在仔细阅读后还是不知道API 到底是什么,在产品中有什么作用。

实际上,API的本质就是第三方数据的调用与处理。

二、应用实例

我们今天以高德地图的数据为例来简单的了解一下,在APP中如何调用和使用API。了解它内部的原理和注意事项。首先我们应该找到一个API的开放网站,以高德地图为例,我们找到高德地图的官网。

 

注册成为开发者。成为开发者后,点击创建项目。

 

 

我们要选择Web服务,而不是其他。创建成功后,会给你一个密钥,我们使用这个密钥,才可以正确的与服务器进行通信。

至于如何使用密钥以及和服务器通讯的规则和方法,每个网站都不相同。我们可以从网站的开发者文档中寻找相应的规则和方法。我们以高德地图的开发者文档为例,简单简述一下各个部分的作用和原理。

https://restapi.amap/v3/staticmap?location=116.481485,39.990464&zoom=10&size=750*300&markers=mid,,A:116.481485,39.990464&key=<用户的key>

 

“?”前代表的是高德地图的网址,问号代表的是一个分隔符,用来分隔前一部分和后一部分的内容。“?”后面的部分是我们要显示的这张地图的放大倍数,长和宽,标记点等重要的参数,这些参数我们可以通过相关数值进行自由调整。


了解完这些知识,我们便可以简单的调用一个静态地图的API了通过下方的代码块儿进行拼接,我们可以得到如下的现象,是不是非常简单。但是我们有一点需要注意,我们在发送汉字的时候,需要将汉字进行编码服务器一般情况下是不能识别汉字的,如果不进行编码的话,可能会报错。

 


以上就是调用一张静态地图的API方法了。这张地图的作用就是可以标注我们我的位置和离我最近的加油站的位置。

 

三、API在搜索中的调用原理

然而在实际生活中,我们调用的地图更为灵活和多变。首先我们一定会使用到搜索功能,搜索功能如何实现,要用静态地图API便是我们所学习到的基础。​由于知识含量比较多,我们下次介绍。这次给大家一个简单的思路。我们要将静态地图中那些常量转化为变量。使用搜索的关键词来替换,静态地图中那些常量。然后结合列表和json数据处理来实现我们通过手机APP端搜索并调用API的全部过程。

 

这是API使用搜索功能的一段简单的UIL,红色部分是高德地图的服务器网址,v3代表搜索功能,around是确认地点,location=后面的内容是搜索的关键字的位置(经纬度),output是输出显示,xml是地图文件,radius代表搜索关键字半件范围。types代表目标地点。所以,上面一段话的意思是,搜索天安门周围的商务写字楼,搜索半径为10000米。

 

更多推荐

手机APP开发之MIT Appinventor详细实战教程(十一),地图API的调用与学习,第一部分