使用AjaxLanguage API，你可以僅使用javaScript來完成對某個網頁上某個區域的語言進行翻譯和檢測的工作。
API是新開發的，因此相對于一個完美的文檔來說，可能有一些bug和微小的不足。我們會修補這些漏洞，因此請諒解、你可以加入AJAX APIs開發者論壇來給我們反饋和討論這個API。
面向讀者
本文檔是面向對Javascript編程和面向對象編程概念有所了解的人準備的。在互聯網上有很多JavaScript教程。
介紹
在Google Ajax LanguageAPI上的“Hello,World”程序
開始學習本API的最簡單方法是來看一個簡單的例子，一下案例將檢測給定語言，并且將其翻譯為英文。
<html>
<head>
<script type="text/javascript" src=">
<script type="text/javascript">
google.load("language", "1");
function initialize() {
var text = document.getElementById("text").innerHTML;
google.language.detect(text, function(result) {
if (!result.error && result.language) {
google.language.translate(text, result.language, "en",
function(result) {
var translated = document.getElementById("translation");
if (result.translation) {
translated.innerHTML = result.translation;
}
});
}
});
}
google.setOnLoadCallback(initialize);
</script>
</head>
<body>
<div id="text">你好，很高興見到你。</div>
<div id="translation"></div>
</body>
</html>
你可以在這里查看該案例，并且隨意修改和運行它。
在你的網頁中包含Ajax LanguageAPI
為了在你的網頁中加入AJAXLanguage API，你需要利用Google AJAX API Loader。該公有加載類允許你加載你所需要的所有AJAX API，包括這里的language API。你需要同時包含Google AJAX APIs的script標簽并且調用google.load("language","1");。
<script type="text/javascript" src=">
<script type="text/javascript">
google.load("language", "1");
</script>
第一個script標簽加載了google.load函數，這個函數允許你加載特定的 GoogleAPI。google.load("language","1")加載了Language API的第一版。當前，AJAXLanguage API的版本為1，但是不久后新版本將可以使用。參考下面的版本討論來獲得更多信息。
API更新
google.load函數的第二個參數實際上是你所使用的AJAXLanguage API的版本。當前，AJAX Language API的版本為1，但是不久后新版本將可以使用。
如果以后我們對API進行重要更新，我們將改變版本號，并且在Google Code和AJAX APIS 討論中發布通知。當該事件發生后，我們預期會在至少一個月的時間內繼續支持所有版本來使你有足夠的時間來遷移你的代碼。
AJAXLanguage 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 = "¿Dónde está el baño?"$$
google.language.detect(text, function(result) {
if (!result.error) {
var language = 'unknown';
for (l ingoogle.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細節
支持的語言
GoogleAJAXLanguage API現在支持下列語言。該技術正在不斷的提高，同時我們的團隊也在努力的擴展這個列表，因此請經?；貋砜纯?。你也可以訪問Google Translate來查看最近更新的列表。
Arabic （阿拉伯語）
Chinese (Simplified and Traditional) （中文簡體）
Dutch （荷蘭語）
English （英語）
French （法語）
German （德語）
Greek （希臘語）
Italian （意大利語）
Japanese （日語）
Korean （韓語）
Portuguese （葡萄牙語）
Russian （俄語）
Spanish（西班牙語）
支持的語言翻譯對
GoogleAJAXLanguage 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。
在AJAXAPIs討論組中搜索。如果你找不到回答你問題的帖子，那么可以在討論組中發布你的問題，并且包含指向你出問題的頁面的鏈接。
新聞熱點
疑難解答
