加載谷歌地圖API的URL詳細解讀

原文地址 http://hi.baidu.com/clive%5Fstudio/blog/item/13e57932a5e6474aad4b5fa4.html 

 

谷歌地圖的API類庫是通過script標籤導入的,形式如下:  

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

 

    我們使用API的時候關心的就是這個script的src屬性了,這個屬性也就兩個部分:路徑:http://ditu.google.com/maps; 參數:file=api&hl=zh-CN&v=2&key=abcdefg。

    解剖一下:

    1、 路徑:http://ditu.google.com/maps

    路徑在這裏需要注意的就是它的域名:ditu.google.com。這個和谷歌地圖簡單背景裏介紹的谷歌地圖主頁的問題類似,就是說,我們主要可以使用maps.google.com、ditu.google.com、ditu.google.cn這三個域名,有些區別和說明:

    1) 如果你需要在地圖上顯示大陸以外的詳細地圖,就非maps.google.com莫屬了,不過,這個域名對國內地理數據的查詢(比如查詢地址、路線等等)支持能力有限,如果你這方面有需求就要小心了,而且,這個應該是使用的國外的服務器,所以,訪問速度也需要注意;

    2)相反,如果你需要使用谷歌提供的與國內地理數據查詢相關的API,就是用ditu.google.com吧,使用這個域名的缺點就在於它和 maps.google.com提供的類庫不是完全一致,更新稍微有點滯後,而且,受限於國內數據源在法律等方面的限制,有些功能方面的支持也會受限,比如地址解析(現在已經放開了,這裏只是拿來舉例);

    3)至於ditu.google.com和ditu.google.cn的區別,我也很糊塗,如果你很想做個聽話的好公民,不出一絲差錯,那麼.cn可能會比.com更讓你放心一點吧,臆測,呵呵。

    總得來說,一般的應用使用ditu.google.com就可以了,如果需要使用大陸以外的詳細地圖,就考慮使用maps.google.com吧。不過,因爲使用了相同的命名空間,這兩者在一個頁面中不能共存,所以,可以考慮用兩個iframe來動態切換,這裏有個火炬傳遞的例子,就是這麼實現的,咱當初也貢獻過一把。


    2、 參數:file=api&hl=zh-CN&v=2&key=abcdefg

    1) file=api
         這個是請求API的JS文件用的,少不了,不需多說;

    2) hl=zh-CN
         這個是在設定地圖上除了地圖圖片以外的諸如控件名稱、版權聲明、使用提示等所需要顯示文本的語言版本時候用的,如果沒有指定這個參數就使用API的默認值,對ditu.google.com來說,默認是中文簡體,maps.google.com默認的是英文。其他的語言版本在這裏有一個簡單的英文說明 (好像好久沒更新了)。

    3) v=2
         這個是用來指定需要導入的API類庫的版本號,可以有四種設定方式:

         v=2.s   穩定版本,更新最慢,但是最可靠;
         v=2     當前版本(只用主版本號),更新速度和可靠性介於s和x之間;
         v=2.x   最新版本,更新最快,包括最新功能,可能沒有當前版本可靠;
         v=2.76 指定版本。不建議使用。
         目前谷歌地圖API的主版本號是2,這是從2006年4月開放的版本,對之前的第1版做了一些比較重要的升級,不過估計國內用第1版的應該很少,所以也沒必要多說了,注意第二版裏定義地圖對象時使用GMap2而不是GMap就可以了,否則可能會導致一些奇怪的問題,我是見過這樣的。
         多羅嗦兩句,谷歌地圖API正常情況下還是相當穩定的,不過也有一些比較著名的Bug,比如超長的Polyline在某些特定環境下可能會顯示不正常。萬一有什麼問題可以去這裏找找是不是別人報過的Bug(英文版),當然,更簡單的辦法是到谷歌地圖API論壇裏問問,不過別忘了把你的問題、運行環境描述清楚。我碰到過很多次這樣的情況:對JavaScript或者瀏覽器端的某些技術特性不是很瞭解,出了一些奇怪的問題,撂一句話就走人,唉,就不評論了,“活到老學到老”還是很有道理的。
     4)key=abcdefg
         這個是設定你註冊的API密鑰,我在這裏費了不少口舌,不是很瞭解的話可以看看。

發佈了333 篇原創文章 · 獲贊 14 · 訪問量 73萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章