ML Kit を使用すると、テキスト文字列の言語を特定できます。Google Chat では 最も確率の高い言語と、その文字列に関連するすべての あります。
ML Kit では、ネイティブ スクリプトで 100 を超える言語のテキストを認識できます。 さらに、アラビア語、ブルガリア語、中国語、 ギリシャ語、ヒンディー語、日本語、ロシア語に対応しています。詳しくは、 サポートされている言語とスクリプトの完全なリストをご覧ください。
試してみる
- サンプルアプリを試してみましょう。 この API の使用例をご覧ください
始める前に
- Podfile に次の ML Kit Pod を追加します。
pod 'GoogleMLKit/LanguageID', '3.2.0'
- プロジェクトの Pod をインストールまたは更新したら、Xcode プロジェクトを開きます。
.xcworkspace
。ML Kit は Xcode バージョン 12.4 以降でサポートされています。
文字列の言語を特定する
文字列の言語を特定するには、
LanguageIdentification
を呼び出してから、その文字列を
identifyLanguage(for:)
メソッドを使用します。
例:
Swift
let languageId = NaturalLanguage.languageIdentification() languageId.identifyLanguage(for: text) { (languageCode, error) in if let error = error { print("Failed with error: \(error)") return } if let languageCode = languageCode, languageCode != "und" { print("Identified Language: \(languageCode)") } else { print("No language was identified") } }
Objective-C
MLKLanguageIdentification *languageId = [MLKLanguageIdentification languageIdentification]; [languageId identifyLanguageForText:text completion:^(NSString * _Nullable languageCode, NSError * _Nullable error) { if (error != nil) { NSLog(@"Failed with error: %@", error.localizedDescription); return; } if (![languageCode isEqualToString:@"und"] ) { NSLog(@"Identified Language: %@", languageCode); } else { NSLog(@"No language was identified"); } }];
呼び出しに成功すると、
BCP-47 言語コード
テキストの言語を示す完了ハンドラに渡されます。「いいえ」の場合
確実に検出できる場合は、コード und
(不確定)が渡されます。
デフォルトでは、ML Kit が und
以外の値を返すのは、
信頼値 0.5 以上とする必要があります。このしきい値は変更できます
LanguageIdentificationOptions
オブジェクトを
languageIdentification(options:)
:
Swift
let options = LanguageIdentificationOptions(confidenceThreshold: 0.4) let languageId = NaturalLanguage.languageIdentification(options: options)
Objective-C
MLKLanguageIdentificationOptions *options = [[MLKLanguageIdentificationOptions alloc] initWithConfidenceThreshold:0.4]; MLKLanguageIdentification *languageId = [MLKLanguageIdentification languageIdentificationWithOptions:options];
文字列の言語を取得する
文字列の中で最も可能性が高い言語の信頼値を取得するには、
LanguageIdentification
のインスタンスを作成し、その文字列を
identifyPossibleLanguages(for:)
メソッドを使用します。
例:
Swift
let languageId = NaturalLanguage.languageIdentification() languageId.identifyPossibleLanguages(for: text) { (identifiedLanguages, error) in if let error = error { print("Failed with error: \(error)") return } guard let identifiedLanguages = identifiedLanguages, !identifiedLanguages.isEmpty, identifiedLanguages[0].languageCode != "und" else { print("No language was identified") return } print("Identified Languages:\n" + identifiedLanguages.map { String(format: "(%@, %.2f)", $0.languageCode, $0.confidence) }.joined(separator: "\n")) }
Objective-C
MLKLanguageIdentification *languageId = [MLKLanguageIdentification languageIdentification]; [languageId identifyPossibleLanguagesForText:text completion:^(NSArray* _Nonnull identifiedLanguages, NSError * _Nullable error) { if (error != nil) { NSLog(@"Failed with error: %@", error.localizedDescription); return; } if (identifiedLanguages.count == 1 && [identifiedLanguages[0].languageCode isEqualToString:@"und"] ) { NSLog(@"No language was identified"); return; } NSMutableString *outputText = [NSMutableString stringWithFormat:@"Identified Languages:"]; for (MLKIdentifiedLanguage *language in identifiedLanguages) { [outputText appendFormat:@"\n(%@, %.2f)", language.languageCode, language.confidence]; } NSLog(outputText); }];
呼び出しが成功すると、IdentifiedLanguage
オブジェクトのリストが
使用することもできます。各オブジェクトから言語の BCP-47 コードを取得できます
文字列がその言語であることの信頼度などです。注:
これらの値は、文字列全体が特定の確率で許容される
言語ML Kit では、1 つの文字列で複数の言語が識別されません。
デフォルトでは、ML Kit は信頼値が
0.01。このしきい値を変更するには、
LanguageIdentificationOptions
オブジェクトを languageIdentification(options:)
にマッピングします。
Swift
let options = LanguageIdentificationOptions(confidenceThreshold: 0.4) let languageId = NaturalLanguage.languageIdentification(options: options)
Objective-C
MLKLanguageIdentificationOptions *options = [[MLKLanguageIdentificationOptions alloc] initWithConfidenceThreshold:0.4]; MLKLanguageIdentification *languageId = [MLKLanguageIdentification languageIdentificationWithOptions:options];
このしきい値を満たす言語がない場合、リストには
und
。