所谓API密钥(API Key),其实就是一个字符串,在使用script标签导入API类库的时候作为请求参数传给谷歌地图的服务器,形式就是:

<script src="http://ditu.google.com/maps?file=api&v=2&key=YOUR_API_KEY" type="text/javascript">

</script>

使用谷歌地图API的第一步就是要注册一个API密钥,谷歌的API使用条款对这个密钥的用途有很正式的说明,其实总结起来也很简单:

1、谷歌地图API提供的服务是免费的,对于通过API正常使用谷歌地图的网站基本没有任何限制;

2、说“基本”没有限制的原因是,谷歌对每个API密钥对应的网站所作的地理编码/地址解析请求次数有限制,每天(24小时)的请求次数不能超过15000次;

3、不能使用谷歌地图从事任何非法的行为,否则谷歌应该能够通过这个密钥阻止你的网站使用谷歌地图;

4、更简单的说,谷歌使用这个密钥保证能够对所有API用户/网站进行区分,方便必要的时候对“超常规”用户进行阻拦。

对于地址解析的次数限制,一般来说不会有什么影响,这里主要说API密钥。

对于API密钥,还有几点需要注意:

1、如果使用API的页面还没有发布,只是在本地调试,可以不用密钥,随便用个字符串代替就可以了;

2、API密钥只对网站目录或者域有效,所以,虽然你是使用同一个谷歌帐号登录后注册的密钥,但是,对不同域的网页,需要用这些域分别注册不同的密钥,对于同一个域里的页面,直接拿你网站的域名注册一个,在这个域里的所有页面就可以通用这个密钥了。

那么就产生了一个关于API密钥的实际问题:

同一个页面需要支持不同的域名,最简单的就是公司有一个cn域名,也有一个com域名,这该怎么办?

其实,对于这种问题,可以提前先注册好不同域名对应的密钥,存在你的JS变量里面,页面加载时通过window.location得到当前请求页面的域名,通过这个域名再找到对应的密钥,然后使用script动态加载的方法加载地图API,用代码描述就是:

//事先已经注册好的密钥

var keyMapping = {host1:key1, host2:key2};

//实际请求页面的域名

var requestHost = window.location.hostname;

//找到需要的密钥

var key = keyMapping[requestHost];

//构造加载API的script url

var apiUrl = "http://ditu.google.com/maps?file=api&v=2&key=" + key;

//使用script动态加载的方法加载地图API

var scriptTag = document.createElement('script');

scriptTag.setAttribute('type', 'text/javascript');

scriptTag.setAttribute('src', apiUrl);

document.getElementsByTagName('head')[0].appendChild(scriptTag);

使用这段代码时,需要注意把你自己的JS代码中对API的各个类的调用放在API加载完成以后,详细的解释可以先搜索一下著名的DomReady的问题,三言两语还是说不清楚的。