Tłumaczenie tekstu za pomocą interfejsu Translation API

Usługa Cloud Translation umożliwia przetłumaczenie dowolnego ciągu znaków na dowolny obsługiwany język. Wykrywanie języka jest też dostępne w przypadku, gdy język źródłowy jest nieznany.

Czego się nauczysz

  • Tworzenie żądania do interfejsu Cloud Translation API i wywoływanie tego interfejsu za pomocą polecenia curl
  • Tłumaczenie tekstu
  • Korzystanie z wersji Premium
  • Wykrywanie języka

Czego potrzebujesz

  • Projekt Google Cloud Platform
  • przeglądarka, np. Chrome lub Firefox;

Ankieta

Jak zamierzasz wykorzystać ten samouczek?

Tylko przeczytaj Przeczytaj i wykonaj ćwiczenia

Jak oceniasz korzystanie z Google Cloud Platform?

Początkujący Średnio zaawansowany Zaawansowany

Samodzielne konfigurowanie środowiska

Jeśli nie masz jeszcze konta Google (Gmail lub Google Apps), musisz je utworzyć. Zaloguj się w konsoli Google Cloud Platform (console.cloud.google.com) i utwórz nowy projekt:

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

Zapamiętaj identyfikator projektu, czyli unikalną nazwę we wszystkich projektach Google Cloud (podana powyżej nazwa jest już zajęta i nie będzie działać w Twoim przypadku).

Nowi użytkownicy Google Cloud Platform mogą skorzystać z bezpłatnego okresu próbnego, w którym mają do dyspozycji środki w wysokości 300 USD.

Konfiguracja ćwiczeń z programowania na konferencji

Instruktor udostępni Ci tymczasowe konta z istniejącymi projektami, które są już skonfigurowane, więc nie musisz się martwić o włączenie płatności ani o koszty związane z uruchomieniem tego laboratorium. Pamiętaj, że wszystkie te konta zostaną wyłączone wkrótce po zakończeniu warsztatów.

Gdy otrzymasz od instruktora tymczasową nazwę użytkownika i hasło, zaloguj się w Google Cloud Console: https://console.cloud.google.com/.

Po zalogowaniu się powinny pojawić się te informacje :

Kliknij ikonę menu w lewym górnym rogu ekranu.

W menu kliknij Menedżer interfejsów API.

Kliknij Włącz API.

Następnie w polu wyszukiwania wpisz „tłumacz”. Kliknij Google Cloud Translation API:

Jeśli interfejs API jest już włączony, zobaczysz przycisk „Wyłącz”. Nie wyłączaj interfejsu API.

Jeśli interfejs API jest wyłączony, kliknij Włącz, aby włączyć interfejs Cloud Translation API:

Odczekaj kilka sekund, aż się włączy. Gdy ta funkcja będzie włączona, zobaczysz:

Google Cloud Shell to środowisko wiersza poleceń działające w chmurze. Ta maszyna wirtualna oparta na Debianie zawiera wszystkie potrzebne narzędzia dla programistów (gcloud, bq, git i inne) i oferuje trwały katalog domowy o pojemności 5 GB. Do utworzenia żądania do interfejsu Translation API użyjemy Cloud Shell.

Aby rozpocząć korzystanie z Cloud Shell, kliknij ikonę „Aktywuj Google Cloud Shell” Screen Shot 2015-06-08 at 5.30.32 PM.png w prawym górnym rogu paska nagłówka.

Sesja Cloud Shell otworzy się w nowej ramce u dołu konsoli, zostanie również wyświetlony monit wiersza poleceń. Poczekaj, aż pojawi się prompt user@project:~$

Ponieważ w celu wysłania żądania do interfejsu Translation API będziesz korzystać z narzędzia curl, musisz wygenerować klucz interfejsu API, aby przekazać go w URL żądania. Aby utworzyć klucz interfejsu API, otwórz sekcję API Manager w panelu projektu:

Następnie otwórz kartę Dane logowania i kliknij Utwórz dane logowania:

Z menu wybierz Klucz interfejsu API:

Następnie skopiuj wygenerowany klucz.

Skopiuj klucz interfejsu API do schowka, a następnie zapisz go w zmiennej środowiskowej w Cloud Shell, używając tego wiersza kodu: Pamiętaj, aby zastąpić YOUR_API_KEY kluczem ze schowka.

export API_KEY=YOUR_API_KEY

W tym przykładzie przetłumaczysz ciąg znaków „My name is Steve” na język hiszpański. Do interfejsu Translation API przekaż tekst do przetłumaczenia wraz z zapisaną wcześniej zmienną środowiskową klucza interfejsu API. Użyj tego polecenia curl:

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

Odpowiedź powinna wyglądać tak:

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

W odpowiedzi zobaczysz przetłumaczony tekst oraz język źródłowy wykryty przez interfejs API.

Oprócz tłumaczenia tekstu interfejs Translation API umożliwia też wykrywanie języka tekstu. W tym przykładzie wykryjesz język 2 ciągów znaków. Przekaż tekst do sprawdzenia wraz z zapisaną wcześniej zmienną środowiskową klucza interfejsu API do interfejsu Translation API za pomocą tego polecenia curl: 

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}"

Odpowiedź powinna wyglądać tak:

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

Języki zwrócone przez ten przykład to „pt” i „ja”. Są to identyfikatory ISO-639-1 dla języka portugalskiego i japońskiego. Na tej liście języków obsługiwanych przez interfejs Translation API znajdziesz wszystkie możliwe kody języków, które mogą zostać zwrócone.

Wiesz już, jak tłumaczyć tekst za pomocą interfejsu Cloud Translation API.

Omówione zagadnienia

  • Tworzenie żądania do interfejsu Cloud Translation API i wywoływanie tego interfejsu za pomocą polecenia curl
  • Tłumaczenie tekstu
  • Korzystanie z wersji Premium
  • Wykrywanie języka

Następne kroki