Firebase Summit で発表されたすべての情報をご覧ください。Firebase を使用してアプリ開発を加速し、自信を持ってアプリを実行する方法を紹介しています。詳細

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

ML Kitを使用して、テキスト文字列の言語を識別できます。文字列の最も可能性の高い言語を取得するか、文字列のすべての可能な言語の信頼スコアを取得できます。

ML Kitは、ネイティブスクリプトで103の異なる言語のテキストを認識します。さらに、ローマ字化されたテキストは、アラビア語、ブルガリア語、中国語、ギリシャ語、ヒンディー語、日本語、およびロシア語で認識できます。

あなたが始める前に

  1. アプリにFirebaseをまだ追加していない場合は、スタートガイドの手順に従って追加してください。
  2. ポッドファイルにMLキットライブラリを含めます。l10n
    pod 'Firebase/MLNaturalLanguage', '6.25.0'
    pod 'Firebase/MLNLLanguageID', '6.25.0'
    
    プロジェクトのポッドをインストールまたは更新した後、必ず.xcworkspaceを使用してXcodeプロジェクトを開いてください。
  3. アプリで、Firebaseをインポートします。

    迅速

    import Firebase

    Objective-C

    @import Firebase;

文字列の言語を特定する

文字列の言語を識別するには、 LanguageIdentificationのインスタンスを取得してから、文字列をidentifyLanguage(for:)メソッドに渡します。

例えば:

迅速

let languageId = NaturalLanguage.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

FIRNaturalLanguage *naturalLanguage = [FIRNaturalLanguage naturalLanguage];
FIRLanguageIdentification *languageId = [naturalLanguage languageIdentification];

[languageId identifyLanguageForText:text
                         completion:^(NSString * _Nullable languageCode,
                                      NSError * _Nullable error) {
                           if (error != nil) {
                             NSLog(@"Failed with error: %@", error.localizedDescription);
                             return;
                           }
                           if (languageCode != nil
                               && ![languageCode isEqualToString:@"und"] ) {
                             NSLog(@"Identified Language: %@", languageCode);
                           } else {
                             NSLog(@"No language was identified");
                           }
                         }];

呼び出しが成功すると、 BCP-47言語コードが完了ハンドラーに渡され、テキストの言語が示されます。サポートされている言語の完全なリストを参照してください。自信を持って言語を検出できなかった場合は、コードund (未決定)が渡されます。

デフォルトでは、ML Kitは、信頼値が0.5以上の言語を識別する場合にのみ非und値を返します。このしきい値を変更するには、 LanguageIdentificationOptionsオブジェクトをlanguageIdentification(options:)に渡します。

迅速

let options = LanguageIdentificationOptions(confidenceThreshold: 0.4)
let languageId = NaturalLanguage.naturalLanguage().languageIdentification(options: options)

Objective-C

FIRNaturalLanguage *naturalLanguage = [FIRNaturalLanguage naturalLanguage];
FIRLanguageIdentificationOptions *options =
    [[FIRLanguageIdentificationOptions alloc] initWithConfidenceThreshold:0.4];
FIRLanguageIdentification *languageId =
    [naturalLanguage languageIdentificationWithOptions:options];

文字列の可能な言語を取得する

文字列の最も可能性の高い言語の信頼値を取得するには、 LanguageIdentificationのインスタンスを取得してから、文字列をidentifyPossibleLanguages(for:)メソッドに渡します。

例えば:

迅速

let languageId = NaturalLanguage.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

FIRNaturalLanguage *naturalLanguage = [FIRNaturalLanguage naturalLanguage];
FIRLanguageIdentification *languageId = [naturalLanguage languageIdentification];

[languageId identifyPossibleLanguagesForText:text
                                  completion:^(NSArray<FIRIdentifiedLanguage *> * _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 (FIRIdentifiedLanguage *language in identifiedLanguages) {
    [outputText appendFormat:@"\n(%@, %.2f)", language.languageCode, language.confidence];
  }
  NSLog(outputText);
}];

呼び出しが成功すると、 IdentifiedLanguageオブジェクトのリストが継続ハンドラーに渡されます。各オブジェクトから、言語のBCP-47コードと、文字列がその言語であるという信頼度を取得できます。サポートされている言語の完全なリストを参照してください。これらの値は、文字列全体が特定の言語であるという確信を示していることに注意してください。 ML Kitは、1つの文字列で複数の言語を識別しません。

デフォルトでは、MLキットは少なくとも0.01の信頼値を持つ言語のみを返します。このしきい値を変更するには、 LanguageIdentificationOptionsオブジェクトをlanguageIdentification(options:)に渡します。

迅速

let options = LanguageIdentificationOptions(confidenceThreshold: 0.4)
let languageId = NaturalLanguage.naturalLanguage().languageIdentification(options: options)

Objective-C

FIRNaturalLanguage *naturalLanguage = [FIRNaturalLanguage naturalLanguage];
FIRLanguageIdentificationOptions *options =
    [[FIRLanguageIdentificationOptions alloc] initWithConfidenceThreshold:0.4];
FIRLanguageIdentification *languageId =
    [naturalLanguage languageIdentificationWithOptions:options];

このしきい値を満たす言語がない場合、リストには値undの項目が1つあります。