Yayınlanma tarihi: 24 Eylül 2024, Son güncelleme tarihi: 20 Mayıs 2025
Metni bir dilden başka bir dile çevirmeden önce, metinde hangi dilin kullanıldığını belirlemeniz gerekir. Daha önce çeviri için metnin bir bulut hizmetine yüklenmesi, çevirinin sunucuda yapılması ve sonuçların indirilmesi gerekiyordu.
Language Detector API, istemci tarafında çalıştığı için kullanıcı gizliliğini koruyabilirsiniz. Bunu yapan belirli bir kitaplığı göndermek mümkün olsa da indirmek için ek kaynaklar gerekir.
Dil algılama ne zaman kullanılır?
Language Detector API, öncelikle aşağıdaki senaryolarda yararlıdır:
- Giriş metninin dilini belirleyerek çevrilmesini sağlar.
- Giriş metninin dilini belirleyerek zehirli içerik algılama gibi dile özgü görevler için doğru modelin yüklenmesini sağlar.
- Giriş metninin dilini belirleyerek doğru şekilde etiketlenmesini sağlar. Örneğin, online sosyal ağ sitelerinde.
- Giriş metninin dilini belirleyerek uygulamanın arayüzünün buna göre ayarlanmasını sağlar. Örneğin, Belçika'daki bir sitede yalnızca Fransızca konuşan kullanıcılarla alakalı arayüzü göstermek için.
Başlayın
Tarayıcının Language Detector API'yi destekleyip desteklemediğini görmek için özellik algılama işlemini çalıştırın.
if ('LanguageDetector' in self) {
// The Language Detector API is available.
}
Model indirme
Dil algılama, dilleri algılama görevine göre hassaslaştırılmış bir modele bağlıdır. API tarayıcıda yerleşik olsa da model, bir site API'yi ilk kez kullanmaya çalıştığında isteğe bağlı olarak indirilir. Chrome'da bu model, diğer modellerle karşılaştırıldığında çok küçüktür. Bu model diğer Chrome özellikleri tarafından kullanıldığından zaten mevcut olabilir.
Modelin kullanıma hazır olup olmadığını belirlemek için eşzamansız LanguageDetector.availability()
işlevini çağırın. availability()
yanıtı downloadable
ise indirme işleminin ilerleme durumunu dinleyin ve indirme işlemi zaman alabileceği için kullanıcıyı bilgilendirin.
İndirmeyi tetiklemek ve dil algılayıcıyı başlatmak için kullanıcı etkinleştirme olup olmadığını kontrol edin. Ardından, eşzamansız LanguageDetector.create()
işlevini çağırın.
const detector = await LanguageDetector.create({
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded * 100}%`);
});
},
});
Dil algılayıcıyı çalıştırma
Language Detector API, belirli bir metinde hangi dilin kullanılma olasılığının en yüksek olduğunu belirlemek için bir sıralama modeli kullanır. Sıralama, makine öğrenimi türlerinden biridir. Amaç, öğe listesini sıralamaktır. Bu durumda, Dil Algılama API'si dilleri en yüksek olasılıktan en düşük olasılığa doğru sıralar.
detect()
işlevi, ilk sonucu, en olası yanıtı döndürebilir veya sıralanmış adayları güven düzeyine göre yineleyebilir.
Bu, {detectedLanguage, confidence}
nesnelerinin listesi olarak döndürülür. confidence
düzeyi, 0.0
(en düşük güven) ile 1.0
(en yüksek güven) arasında bir değer olarak ifade edilir.
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 playground
API deneme alanımızda Language Detector API ile denemeler yapın. Metin alanına farklı dillerde yazılmış metinler girin.
İzin politikası, iframe'ler ve Web Workers
Dil Algılayıcı API'si varsayılan olarak yalnızca üst düzey pencerelerde ve aynı kaynaklı iFrame'lerde kullanılabilir. API'ye erişim, Permission Policy allow=""
özelliği kullanılarak kaynaklar arası iframe'lere devredilebilir:
<!--
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, Web Workers'da kullanılamaz. Bunun nedeni, izin politikası durumunu kontrol etmek için her çalışan adına sorumlu bir belge oluşturmanın karmaşık olmasıdır.
Görüşlerinizi paylaşın
Dil Algılama API'si ile neler geliştirdiğinizi görmek istiyoruz. Web sitelerinizi ve web uygulamalarınızı X, YouTube ve LinkedIn'de bizimle paylaşın.
Chrome'un uygulamasıyla ilgili geri bildiriminiz varsa Chromium hata bildiriminde bulunun.