ML Kit を使用してテキストの言語を識別する（iOS）

ML Kit を使用すると、テキスト文字列の言語を特定できます。Google Chat では 最も確率の高い言語と、その文字列に関連するすべての あります。

ML Kit では、ネイティブ スクリプトで 100 を超える言語のテキストを認識できます。 さらに、アラビア語、ブルガリア語、中国語、 ギリシャ語、ヒンディー語、日本語、ロシア語に対応しています。詳しくは、 サポートされている言語とスクリプトの完全なリストをご覧ください。

試してみる

始める前に

  1. Podfile に次の ML Kit Pod を追加します。 
    pod 'GoogleMLKit/LanguageID', '8.0.0'
  2. プロジェクトの 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。