Translation API ile metin çevirme

Cloud Translation, rastgele dizeleri desteklenen dillere çevirmenize olanak tanır. Kaynak dilin bilinmediği durumlarda da dil algılama özelliği kullanılabilir.

Neler öğreneceksiniz?

  • Cloud Translation API isteği oluşturma ve API'yi curl ile çağırma
  • Metin Çevirme
  • Premium Sürümü Kullanma
  • Dili Algılama

Gerekenler

  • Google Cloud Platform projesi
  • Chrome veya Firefox gibi bir tarayıcı

Anket

Bu eğitimi nasıl kullanacaksınız?

Yalnızca okuyun Okuyun ve alıştırmaları tamamlayın

Google Cloud Platform deneyiminizi nasıl değerlendirirsiniz?

Başlangıç Orta İleri

Kendi hızınızda ortam kurulumu

Henüz bir Google Hesabınız (Gmail veya Google Apps) yoksa oluşturmanız gerekir. Google Cloud Platform Console'da (console.cloud.google.com) oturum açın ve yeni bir proje oluşturun:

Screenshot from 2016-02-10 12:45:26.png

Proje kimliğini unutmayın. Bu kimlik, tüm Google Cloud projelerinde benzersiz bir addır (Yukarıdaki ad zaten alınmış olduğundan sizin için çalışmayacaktır).

Google Cloud Platform'un yeni kullanıcıları 300 ABD doları değerindeki ücretsiz deneme sürümünden yararlanabilir.

Konferansta Codelab kurulumu

Eğitmen, size mevcut projelerin bulunduğu geçici hesaplar paylaşacak. Bu nedenle, faturalandırmayı etkinleştirme veya bu codelab'i çalıştırmayla ilişkili maliyetler konusunda endişelenmenize gerek kalmayacak. Bu hesapların tümünün, codelab sona erdikten kısa süre sonra devre dışı bırakılacağını unutmayın.

Eğitmenden giriş yapmak için geçici bir kullanıcı adı / şifre aldıktan sonra Google Cloud Console'da oturum açın: https://console.cloud.google.com/.

Giriş yaptıktan sonra görecekleriniz :

Ekranın sol üst kısmındaki menü simgesini tıklayın.

Açılır menüden API Yöneticisi'ni seçin.

Enable API'yi (API'yi etkinleştir) tıklayın.

Ardından, arama kutusunda "translate" (çevir) ifadesini arayın. Google Cloud Translation API'yi tıklayın:

API zaten etkinleştirilmişse "Disable" (Devre dışı bırak) düğmesini görürsünüz. API'yi devre dışı bırakmayın.

API devre dışıysa Cloud Translation API'yi etkinleştirmek için Etkinleştir'i tıklayın:

Etkinleşmesi için birkaç saniye bekleyin. Etkinleştirildikten sonra şunları görürsünüz:

Google Cloud Shell, Cloud'da çalışan bir komut satırı ortamıdır. Bu Debian tabanlı sanal makine, ihtiyaç duyacağınız tüm geliştirme araçları (gcloud, bq, git ve diğerleri) yüklü olarak gelir ve 5 GB kalıcı ana dizin sunar. Translation API'ye yönelik isteğimizi oluşturmak için Cloud Shell'i kullanacağız.

Cloud Shell'i kullanmaya başlamak için başlık çubuğunun sağ üst köşesindeki "Google Cloud Shell'i etkinleştir" Screen Shot 2015-06-08 at 5.30.32 PM.png simgesini tıklayın.

Konsolun altındaki yeni bir çerçevede Cloud Shell oturumu açılır ve komut satırı istemi görüntülenir. user@project:~$ istemi görünene kadar bekleyin.

Translation API'ye istek göndermek için curl kullanacağımızdan istek URL'mizi iletmek üzere bir API anahtarı oluşturmamız gerekecek. API anahtarı oluşturmak için proje kontrol panelinizin API Yöneticisi bölümüne gidin:

Ardından, Kimlik bilgileri sekmesine gidin ve Kimlik bilgileri oluştur'u tıklayın:

Açılır menüde, API anahtarı'nı seçin:

Ardından, az önce oluşturduğunuz anahtarı kopyalayın.

API anahtarınızı panonuza kopyalayın, ardından aşağıdaki kod satırını kullanarak Cloud Shell'deki bir ortam değişkenine kaydedin. YOUR_API_KEY kısmını panonuzdaki anahtarla değiştirdiğinizden emin olun.

export API_KEY=YOUR_API_KEY

Bu örnekte, "My name is Steve" (Adım Steve) dizesini İspanyolcaya çevireceksiniz. Çevrilecek metni, daha önce kaydettiğiniz API anahtarı ortam değişkeniyle birlikte aşağıdaki curl komutuyla Translation API'ye iletin:

TEXT="My%20name%20is%20Steve"
curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"

Yanıtınız aşağıdaki gibi görünmelidir:

{
  "data": {
    "translations": [
      {
        "translatedText": "Mi nombre es Steve",
        "detectedSourceLanguage": "en"
      }
    ]
  }
}

Yanıt bölümünde, çevrilen metnin yanı sıra API'nin algıladığı kaynak dili görebilirsiniz.

Translation API, metin çevirmenin yanı sıra metinlerin dilini algılamanıza da olanak tanır. Bu örnekte iki dizenin dilini algılayacaksınız. İncelenecek metni, daha önce kaydettiğiniz API anahtarı ortam değişkeniyle birlikte aşağıdaki curl komutuyla Translation API'ye iletin: 

TEXT_ONE="Meu%20nome%20é%20Steven"
TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります"
curl "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}&q=${TEXT_ONE}&q=${TEXT_TWO}"

Yanıtınız aşağıdaki gibi görünmelidir:

{
  "data": {
    "detections": [
      [
        {
          "confidence": 0.20671661198139191,
          "isReliable": false,
          "language": "pt"
        }
      ],
      [
        {
          "confidence": 0.97750955820083618,
          "isReliable": false,
          "language": "ja"
        }
      ]
    ]
  }
}

Bu örnek tarafından döndürülen diller "pt" ve "ja"dır. Bunlar, Portekizce ve Japonca için ISO-639-1 tanımlayıcılarıdır. Translation API'nin desteklediği dillerin listesinde döndürülebilecek tüm olası dil kodları yer alır.

Cloud Translation API ile metin çevirmeyi öğrendiniz.

İşlediğimiz konular

  • Cloud Translation API isteği oluşturma ve API'yi curl ile çağırma
  • Metin Çevirme
  • Premium Sürümü Kullanma
  • Dili Algılama

Sonraki Adımlar