Google Map开发系列(一)——谷歌地图API密钥(API Key)的解读和使用技巧

好了,通過前一篇的介紹,大家對Google Map都有所瞭解了吧。不過還得一步步的來。先瞭解API Key吧。所谓 API 密钥( API Key),其实就是一个字符串,在使用 script 标签导入 API 类库的时候作为请求参数传给谷歌的地图服务器,形式就是: 
    <script src="http://ditu.google.com/maps?file=api&v=2&key=
 你注册的 API 密钥 " type="text/javascript"></script>
    我的API Key是:ABQIAAAAMWyR7XvYN8KE9N6m_jcU4BRlfWJrPzRGiYSzS4l55_z1ea3VShRolPwARGHvivnEFRLVGXyIlsrYpA


    
使用谷歌地图 API 的第一步就是要 注册一个 API 密钥  谷歌的 API 使用条款 对这个密钥的用途有很正式的说明,其实总结起来也很简单: 
    1
 、谷歌地图 API 提供的服务是免费的,对于通过 API 正常使用谷歌地图的网站基本没有任何限制; 
    2
 、说  基本  没有限制的原因是,谷歌对每个 API 密钥对应的网站所作的 地理编码 / 地址解析 请求次数有限制,每天( 24 小时)的请求次数不能超过 15000 次;


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

    更简单的说,谷歌使用这个密钥保证能够对所有 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&amp;v=2&amp;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 加载完成以后,详细的解释可以先google 一下著名的DomReady 的问题 ,三言两语还是说不清楚的,呵呵。
    
这段代码我没有实际跑过,欢迎斧正,如果你有更好的方法,我更愿意洗耳恭听了。

来源:http://blog.csdn.net/jiali765/archive/2010/03/02/5338265.aspx

加支付宝好友偷能量挖...


评论(0)网络
阅读(189)喜欢(0)Google Maps开发