Android 和 iOS 裝置會應用以下 <meta> 標記: <meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
有關針對 iPhone 進行開發的詳情,請參閱 Apple 的開發人員文檔。有關針對 Android 裝置進行開發的詳情,請參閱 Android 文檔。
本地化您可以通過更改預設語言設定和設定應用的地區代碼來本地化您的 Google Maps API 應用程式,從而根據給定的國家或地區改變應用的運行方式。
語言本地化Google Maps API 在顯示文本資訊(如控制項名稱、著作權聲明、行車路線和地圖上的標籤)時,使用瀏覽器的慣用語言設定。大多數情況下,這是首選的做法;通常您不應覆蓋使用者的慣用語言設定。不過,如果您想要更改 Maps API 以忽略瀏覽器的語言設定,並使瀏覽器用特定語言顯示資訊,可以在加入 Maps API JavaScript 代碼時將可選的language 參數添加到 <script> 標記,以指定要使用的語言。
例如,要用日語顯示 Maps API 應用程式,可以將 &language=ja 添加到 <script> 標記,如下所示:
<script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=false&language=ja">
注意:按照上述方式載入 API 後,不論使用者的喜好設定如何,系統都會對所有使用者顯示日語。在設定此選項之前,請確定您確實希望這麼做。
Maps JavaScript API 還支援雙向 (Bidi) 文本,即本身同時包含從左至右 (LTR) 和從右至左 (RTL) 語言字元的文本。RTL 語言的樣本包括阿拉伯語、希伯來語和波斯語。通常,您應當將 dir=‘rtl‘ 添加到網頁的 <html> 元素中,以指定要正確呈現的 RTL 語言網頁。地區本地化預設情況下,Maps API 會根據載入 API 的主域所在的省/地區,提供地圖底圖並偏嚮應用行為。如果您想要更改應用以提供不同的地圖底圖或偏嚮應用(例如,偏向地理編碼結果使其靠近某地區),可以在加入 Maps API JavaScript 代碼時將 region 參數添加到 <script> 標記中,以覆蓋該預設行為。
作為 Maps API 應用程式的開發人員,您有責任確保針對應用託管所在的省/地區進行正確的地區本地化,從而確保您的應用符合當地法律。
region 參數接受 Unicode 地區子標記識別項,該標識符通常與國家/區域碼頂級網域名稱 (ccTLD) 一對一映射。除某些明顯不同之外,大多數 Unicode 地區標識符與 ISO 3166-1 代碼是相同的。例如,英國的 ccTLD 為“uk”(與其網域名稱 .co.uk 相對應),而其地區標識符則為“GB”。
例如,要使用本地化到英國的 Maps API 應用程式,可將 ®ion=GB 添加到 <script> 標記中,如下所示:
<script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=false?ion=GB">
版本控制
Google Maps API 小組會定期更新此 JavaScript API,即增加新地圖項、修複錯誤和改進效能。所有的 API 更改均向後相容,以確保您啟動應用時使用的是目前記錄的介面,且應用可在 API 更新後繼續運行,而無需進行相關修改。(注意:實驗性 API 參考中記錄的實驗性地圖項並不在此擔保範圍內。實驗性地圖項將在 API 文檔中明確標出。)
版本類型您只需使用 Maps JavaScript API 引導程式請求的 v 參數指定 API 版本,即可指明要在您應用中載入該版本。目前,系統支援以下兩個選項:
- 發行版本,可使用
v=3 或省略 v 參數來指定。
- 實驗版本,可使用
v=3.exp 來指定。該版本是以主幹版本為基礎的目前的版本,其中包含公開發布的所有錯誤修複和新增地圖項。
- 編號版本,用
v=3.number 表示,指定了 API 的地圖項集。
下面的引導程式請求示範了如何請求具體版本的 Maps JavaScript API:
http://maps.googleapis.com/maps/api/js?v=3.9&sensor=true_or_false
每個季度,我們都會構建新的編號版本(“發行版本”),並進行發布以供公眾使用。在整個季度期間,在確保地圖項集保持穩定的同時,我們還會繼續向此發行版本中添加錯誤修複,Maps JavaScript API 變更記錄檔將會對此進行記錄。
當我們發行新的編號版本時,將會“凍結”之前的發行版本,這表示我們不再對其進行任何代碼更改更新(包括錯誤修複),以確保其充分的穩定性。每次我們以此方式推出新的凍結版本時,都會停用現有的凍結版本。也就是說,在任何指定的時間段內,我們只會提供一個凍結版本。請求已停用的編號版本的應用將會自動收到當前的凍結版本。
選擇 API 版本在為您的 Maps API V3 應用選擇合適的 API 版本時,可參考以下指南:
- 生產應用應指定發行版本 (
v=3) 或凍結版本。指定已停用的版本(如 v=3.0)總是會返回當前的凍結版本。
- Maps API for Business SLA 不適用於當前的實驗版本。Maps API for Business 應用必須使用當前的發行版本(當前為 3.9)或較早版本,以便適用 SLA。
- 開發新款 Maps API v3 應用時,建議您根據版本號碼(例如 3.10)選擇使用最新的實驗版本,直到您需要添加較新版本中所提供的其他地圖項時再改用該新版本。這樣,您使用的版本會隨著應用的開發而日趨成熟,並會在一段時間後變為發行版本,最終成為凍結版本。
- 請求當前凍結版本或較早版本的生產應用應在每季度對最新的發行版本進行測試,以便在該版本凍結前識別有關向後相容性方面的任何問題。
版本文檔文檔將始終反映實驗版本。不過,我們會針對每個版本提供一份單獨進行維護的參考。
- 版本 3.9 參考(發行)
- 版本 3.10 參考(實驗)
- 版本 3.8 參考(凍結)
- 版本 3.0 到 3.7 都已停用。
問題排查如果您的代碼不起作用,可以參考以下一些方法來解決您遇到的問題:
- 尋找拼字錯誤。請注意,JavaScript 語言區分大小寫。
- 使用 JavaScript 調試器。在 Firefox 中,您可以使用 JavaScript 控制台、Venkman 調試器或 Firebug 外掛程式。在 IE 中,您可以使用 Microsoft Script Debugger。該系列抓屏示範了如何使用各種調試工具。
- 有關問題,請在 Google Maps API v3 網上論壇上發帖提問。
Last updated 二月 1, 2013.