Google AJAX Language API開發者參考
日期:2008-07-11 作者:喜騰小二 來源:PHPChina
使用AJAX Language API，妳可以僅使用JavaScript來完成對某個網頁上某個區網域的語言進行翻譯和偵測的工作。
API是新開發的，因此相對於一個完美的文檔來說，可能有一些bug和微小的不足。我們會修補這些漏洞，因此請諒解、妳可以加入AJAX APIs開發者論壇來給我們回饋和討論這個API。
麵嚮讀者
本文檔是麵嚮對JavaScript編程和麵嚮物件編程概念有所瞭解的人準備的。在網際網路上有很多JavaScript教程。
介紹
在Google Ajax Language API上的“Hello,World”程式
開始學習本API的最簡單方法是來看一個簡單的例子，一下案例將偵測給定語言，並且將其翻譯為英文。
妳可以在這裡檢視該案例，並且隨意修改和執行它。
在妳的網頁中包含Ajax Language API
為了在妳的網頁中加入AJAX Language API，妳需要利用Google AJAX API Loader。該公有載入類允許妳載入妳所需要的所有AJAX API，包括這裡的language API。妳需要同時包含Google AJAX APIs的script選項卡並且調用google.load("language","1");。
第一個script選項卡載入了google.load函式，這個函式允許妳載入特定的 Google API。google.load("language","1")載入了Language API的第一版。當前，AJAX Language API的版本為1，但是不久後新版本將可以使用。參考下麵的版本討論來獲得更多資訊。
API 更新
google.load函式的第二個參數實際上是妳所使用的AJAX Language API的版本。當前，AJAX Language API的版本為1，但是不久後新版本將可以使用。
如果以後我們對API進行重要更新，我們將改變版本號，並且在Google Code和AJAX APIS 討論中發佈通知。當該事件發生後，我們預期會在至少一個月的時間內繼續支援所有版本來使妳有足夠的時間來遷移妳的程式碼。
AJAX Language API團隊對於最近日較的Bug修復和平臺最佳化進行定期更新。這些Bug修復應當僅提高表現和修復Bug，但是我們有可能不小心破壞某些API使用者、請使用AJAX APIs 討論組來報告這樣的問題。
實例
語言翻譯
本案例展示了一個簡單的對一個JavaScript字串變數進行翻譯的過程。
google.language.translate("Hello world", "en", "es", function(result) {
if (!result.error) {
var container = document.getElementById("translation");
container.innerHTML = result.translation;
}
});
檢視案例（translate.html）
語言偵測
這個案例展示了對於一個JavaScript字串的語言偵測。將返回語言程式碼。
var text = "¿Dnde est el baño?"$$
google.language.detect(text, function(result) {
if (!result.error) {
var language = 'unknown';
for (l in google.language.Languages) {
if (google.language.Languages[l] == result.language) {
language = l;
break;
}
}
var container = document.getElementById("detection");
container.innerHTML = text + " is: " + language + ""$$
}
});
檢視案例 (detection.html)
翻譯時源偵測
如下的案例類似於基本的翻譯案例，但是它展示了如何在不知道源語言時對文字進行翻譯。透過傳入一個空字串來表示未知的源語言，係統將在一次調用中自動偵測和翻譯。
google.language.translate("Hello world", "", "es", function(result) {
if (!result.error) {
var container = document.getElementById("translation");
container.innerHTML = result.translation;
}
});
檢視案例 (autotranslate.html)
更多案例
這裡有進行互動作用的兩個附加案例。第一個案例對預輸入的文字字串進行語言偵測，同時也允許輸入其他的文字。它同時也顯示信任和可靠因數（confidence and reliability factors—譯者注）。
檢視案例(detect.html)
第二個附加案例進行翻譯。同時他也允許與上述類似的互動作用。
檢視案例(translate.html)
API細節
支援的語言
Google AJAX Language API現在支援下列語言。該技術正在不斷的提高，同時我們的團隊也在努力的延伸這個清單，因此請經常回來看看。妳也可以訪問Google Translate來檢視最近更新的清單。
- Arabic （阿拉伯文）
- Chinese (Simplified and Traditional) （中文簡體）
- Dutch （荷蘭文）
- English （英文）
- French （法文）
- German （德文）
- Greek （希臘文）
- Italian （義大利文）
- Japanese （日文）
- Korean （韓文）
- Portuguese （葡萄牙文）
- Russian （俄文）
- Spanish（西班牙文）
支援的語言翻譯對
Google AJAX Language API現在支援下列語言翻譯對。該技術正在不斷的提高，同時我們的團隊也在努力的延伸這個清單，因此請經常回來看看。妳也可以訪問Google Translate來檢視最近更新的清單。
- Arabic to English （阿拉伯文到英文）
- Chinese to English （中文到英文）
- Chinese (Simplified to Traditional) （簡體中文到繁體中文）
- Chinese (Traditional to Simplified) （繁體中文到簡體中文）
- Dutch to English （荷蘭文到英文）
- English to Arabic （英文到阿拉伯文）
- English to Chinese (Simplified) （英文到簡體中文）
- English to Chinese (Traditional) （英文到繁體中文）
- English to Dutch （英文到荷蘭文）
- English to French （英文到法文）
- English to German （英文到德文）
- English to Greek （英文到希臘文）
- English to Italian （英文到義大利文）
- English to Japanese （英文到日文）
- English to Korean （英文到韓文）
- English to Portuguese （英文到葡萄牙文）
- English to Russian （英文到俄文）
- English to Spanish （英文到西班牙文）
- French to English （法文到英文）
- French to German （法文到德文）
- German to English （德文到英文）
- German to French （德文到法文）
- Greek to English （希臘文到英文）
- Italian to English （義大利文到英文）
- Japanese to English （日文到英文）
- Korean to English （韓文到英文）
- Portuguese to English （葡萄牙文到英文）
- Russian to English （俄文到英文）
- Spanish to English（西班牙文到英文）
問題解決
如果在妳的程式碼中遇到了問題：
- 檢查程式碼。請牢記JavaScript是對大小寫敏感的語言。
- 使用JavaScript偵錯器、在Firefox中，妳可以使用JavaScript控制臺或者FireBug延伸。在IE中，妳可以使用Microsoft Script Debugger。
- 在AJAX APIs討論組中搜尋。如果妳找不到回答妳問題的帖子，那麼可以在討論組中發佈妳的問題，並且包含指嚮妳出問題的页面的連結。