Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

AI を組み込んだ言語検出

Thomas Steiner

公開日: 2024 年 9 月 24 日、最終更新日: 2025 年 5 月 20 日

Browser Support

ある言語から別の言語にテキストを翻訳する前に、まず、指定されたテキストで使用されている言語を特定する必要があります。以前は、翻訳を行うには、テキストをクラウドサービスにアップロードし、サーバーで翻訳を実行してから、結果をダウンロードする必要がありました。

Language Detector API はクライアントサイドで動作するため、ユーザーのプライバシーを保護できます。これを行う特定のライブラリを配布することも可能ですが、ダウンロードに追加のリソースが必要になります。

言語検出を使用するタイミング

Language Detector API は、主に次のシナリオで役立ちます。

入力テキストの言語を特定して、翻訳できるようにします。
入力テキストの言語を特定し、有害性の検出など、言語固有のタスクに適切なモデルを読み込めるようにします。
入力テキストの言語を特定して、オンラインソーシャルネットワークサイトなどで正しくラベル付けできるようにします。
入力テキストの言語を判別して、アプリのインターフェースを適切に調整します。たとえば、ベルギーのサイトで、フランス語を話すユーザーに関連するインターフェースのみを表示する場合です。

始める

Language Detector API と Translator API は、パソコン版 Chrome で動作します。これらの API はモバイルデバイスでは動作しません。

機能検出を実行して、ブラウザが Language Detector API をサポートしているかどうかを確認します。

if ('LanguageDetector' in self) {
  // The Language Detector API is available.
}

モデルのダウンロード

言語検出は、言語検出の特定のタスク用にファインチューニングされたモデルに依存します。API はブラウザに組み込まれていますが、モデルはサイトが API を初めて使用しようとしたときにオンデマンドでダウンロードされます。Chrome では、このモデルは他のモデルと比較して非常に小さくなっています。このモデルは他の Chrome 機能で使用されているため、すでに存在している可能性があります。

モデルが使用可能かどうかを判断するには、非同期の LanguageDetector.availability() 関数を呼び出します。availability() へのレスポンスが downloadable の場合は、ダウンロードの進行状況をリッスンしてユーザーに通知します。ダウンロードに時間がかかることがあるためです。

ダウンロードをトリガーして言語検出機能をインスタンス化するには、ユーザーアクティベーションを確認します。次に、非同期の LanguageDetector.create() 関数を呼び出します。

const detector = await LanguageDetector.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
});

言語検出ツールを実行する

Language Detector API は、ランキングモデルを使用して、特定のテキストで使用されている可能性が最も高い言語を特定します。ランキングは、アイテムのリストを並べ替えることを目的とする機械学習の一種です。この場合、Language Detector API は言語を確率の高い順にランク付けします。

detect() 関数は、最初の結果（最も可能性の高い回答）を返すか、信頼度レベルでランク付けされた候補を反復処理できます。これは {detectedLanguage, confidence} オブジェクトのリストとして返されます。confidence レベルは、0.0（信頼度が最も低い）から 1.0（信頼度が最も高い）までの値で表されます。

const someUserText = 'Hallo und herzlich willkommen!';
const results = await detector.detect(someUserText);
for (const result of results) {
  // Show the full list of potential languages with their likelihood, ranked
  // from most likely to least likely. In practice, one would pick the top
  // language(s) that cross a high enough threshold.
  console.log(result.detectedLanguage, result.confidence);
}
// (Output truncated):
// de 0.9993835687637329
// en 0.00038279531872831285
// nl 0.00010798392031574622
// ...

API プレイグラウンド

API プレイグラウンドで Language Detector API をお試しください。テキストエリアに、さまざまな言語で書かれたテキストを入力します。

権限ポリシー、iframe、ウェブワーカー

デフォルトでは、Language Detector API はトップレベルウィンドウとその同一オリジン iframe でのみ使用できます。Permission Policy の allow="" 属性を使用して、API へのアクセスをクロスオリジンの iframe に委任できます。

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Language Detector API by
  setting the `allow="language-detector"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="language-detector"></iframe>

Language Detector API はウェブワーカーでは使用できません。これは、権限ポリシーのステータスを確認するために、各ワーカーに責任のあるドキュメントを確立する複雑さによるものです。

フィードバックをお寄せください

Language Detector API を使用して構築しているものをぜひお聞かせください。X、YouTube、LinkedIn で、ウェブサイトやウェブアプリケーションを共有してください。

Chrome の実装についてフィードバックがある場合は、Chromium のバグを報告してください。

早期プレビュープログラムに参加すると、新しい組み込み AI API をいち早くお試しいただけるほか、メーリングリストでのディスカッションにもご参加いただけます。