Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzo dell'API Translation con Python

1. Panoramica

L'API Translation fornisce un'interfaccia programmatica semplice per la traduzione dinamica di una stringa arbitraria in qualsiasi lingua supportata utilizzando una traduzione automatica neurale all'avanguardia. Può essere utilizzata anche per rilevare una lingua nei casi in cui non sia nota.

In questo tutorial utilizzerai l'API Translation con Python. I concetti trattati includono come elencare le lingue disponibili, tradurre un testo e rilevare la lingua di un determinato testo.

Cosa imparerai a fare

Come configurare l'ambiente
Come elencare le lingue disponibili
Come tradurre testo
Come rilevare le lingue

Che cosa ti serve

Un progetto Google Cloud
Un browser, ad esempio Chrome o Firefox
Dimestichezza nell'utilizzo di Python

Sondaggio

Come utilizzerai questo tutorial?

Solo lettura

Leggilo e completa gli esercizi

Come valuteresti la tua esperienza con Python?

Principiante

Livello intermedio

Eccellente

Come giudichi la tua esperienza con i servizi Google Cloud?

Principiante

Livello intermedio

Eccellente

2. Configurazione e requisiti

Configurazione dell'ambiente da seguire in modo autonomo

Accedi alla console Google Cloud e crea un nuovo progetto o riutilizzane uno esistente. Se non hai ancora un account Gmail o Google Workspace, devi crearne uno.

Il Nome progetto è il nome visualizzato dei partecipanti del progetto. Si tratta di una stringa di caratteri non utilizzata dalle API di Google. Puoi sempre aggiornarla.
L'ID progetto è univoco in tutti i progetti Google Cloud ed è immutabile (non può essere modificato dopo essere stato impostato). La console Cloud genera automaticamente una stringa univoca. di solito non ti importa cosa sia. Nella maggior parte dei codelab, dovrai fare riferimento al tuo ID progetto (in genere identificato come PROJECT_ID). Se l'ID generato non ti soddisfa, potresti generarne un altro casuale. In alternativa, puoi provarne una personalizzata per verificare se è disponibile. Non può essere modificato dopo questo passaggio e rimane per tutta la durata del progetto.
Per informazione, c'è un terzo valore, un numero di progetto, utilizzato da alcune API. Scopri di più su tutti e tre questi valori nella documentazione.

Successivamente, dovrai abilitare la fatturazione nella console Cloud per utilizzare risorse/API Cloud. L'esecuzione di questo codelab non ha alcun costo. Per arrestare le risorse ed evitare di incorrere in fatturazione dopo questo tutorial, puoi eliminare le risorse che hai creato o eliminare il progetto. I nuovi utenti di Google Cloud sono idonei al programma prova senza costi di 300$.

Avvia Cloud Shell

Mentre Google Cloud può essere utilizzato da remoto dal tuo laptop, in questo codelab utilizzerai Cloud Shell, un ambiente a riga di comando in esecuzione nel cloud.

Attiva Cloud Shell

Dalla console Cloud, fai clic su Attiva Cloud Shell .

Se è la prima volta che avvii Cloud Shell, ti verrà mostrata una schermata intermedia che descrive di cosa si tratta. Se ti è stata presentata una schermata intermedia, fai clic su Continua.

Il provisioning e la connessione a Cloud Shell dovrebbero richiedere solo qualche istante.

Questa macchina virtuale viene caricata con tutti gli strumenti di sviluppo necessari. Offre una home directory permanente da 5 GB e viene eseguita in Google Cloud, migliorando notevolmente le prestazioni di rete e l'autenticazione. Gran parte, se non tutto, del lavoro in questo codelab può essere svolto con un browser.

Una volta stabilita la connessione a Cloud Shell, dovresti vedere che hai eseguito l'autenticazione e che il progetto è impostato sul tuo ID progetto.

Esegui questo comando in Cloud Shell per verificare che l'account sia autenticato:

gcloud auth list

Output comando

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Esegui questo comando in Cloud Shell per confermare che il comando gcloud è a conoscenza del tuo progetto:

gcloud config list project

Output comando

[core]
project = <PROJECT_ID>

In caso contrario, puoi impostarlo con questo comando:

gcloud config set project <PROJECT_ID>

Output comando

Updated property [core/project].

3. Configurazione dell'ambiente

Prima di poter iniziare a utilizzare l'API Translation, esegui questo comando in Cloud Shell per abilitare l'API:

gcloud services enable translate.googleapis.com

Il risultato dovrebbe essere simile a questo:

Operation "operations/..." finished successfully.

Ora puoi utilizzare l'API Translation.

Imposta la seguente variabile di ambiente (da utilizzare nella tua applicazione):

export PROJECT_ID=$(gcloud config get-value core/project)

echo "→ PROJECT_ID: $PROJECT_ID"

Passa alla tua home directory:

cd ~

Crea un ambiente virtuale Python per isolare le dipendenze:

virtualenv venv-translate

Attiva l'ambiente virtuale:

source venv-translate/bin/activate

Installa IPython e la libreria client dell'API Translation:

pip install ipython google-cloud-translate

Il risultato dovrebbe essere simile a questo:

...
Installing collected packages: ..., ipython, google-cloud-translate
Successfully installed ... google-cloud-translate-3.11.0 ...

A questo punto puoi utilizzare la libreria client dell'API Translation.

Nei passaggi successivi, utilizzerai un interprete Python interattivo chiamato IPython, che hai installato nel passaggio precedente. Avvia una sessione eseguendo ipython in Cloud Shell:

ipython

Il risultato dovrebbe essere simile a questo:

Python 3.9.2 (default, Feb 28 2021, 17:03:44)
Type 'copyright', 'credits' or 'license' for more information
IPython 8.12.0 -- An enhanced Interactive Python. Type '?' for help.

In [1]:

Copia il seguente codice nella tua sessione IPython:

from os import environ

from google.cloud import translate


PROJECT_ID = environ.get("PROJECT_ID", "")
assert PROJECT_ID
PARENT = f"projects/{PROJECT_ID}"

Puoi effettuare la tua prima richiesta ed elencare le lingue supportate...

4. Elenca le lingue disponibili

In questa sezione elencherai tutte le lingue disponibili nell'API Translation.

Per elencare le lingue disponibili, copia il seguente codice nella sessione IPython:

def print_supported_languages(display_language_code: str):
    client = translate.TranslationServiceClient()

    response = client.get_supported_languages(
        parent=PARENT,
        display_language_code=display_language_code,
    )

    languages = response.languages
    print(f" Languages: {len(languages)} ".center(60, "-"))
    for language in languages:
        language_code = language.language_code
        display_name = language.display_name
        print(f"{language_code:10}{display_name}")

Richiama la funzione:

print_supported_languages("en")

Dovresti ottenere qualcosa del genere:

---------------------- Languages: 136 ----------------------
af        Afrikaans
ak        Akan
sq        Albanian
am        Amharic
ar        Arabic
...
cy        Welsh
xh        Xhosa
yi        Yiddish
yo        Yoruba
zu        Zulu

Ecco cosa offre la lingua di visualizzazione in francese:

print_supported_languages("fr")

Dovresti ottenere lo stesso elenco, ordinato con i nomi in francese, simile al seguente:

---------------------- Languages: 136 ----------------------
af        Afrikaans
sq        Albanais
de        Allemand
am        Amharique
en        Anglais
...
vi        Vietnamien
xh        Xhosa
yi        Yiddish
yo        Yorouba
zu        Zoulou

Puoi provare con un altro codice lingua.

Riepilogo

In questo passaggio hai potuto elencare tutte le lingue disponibili nell'API Translation. Puoi trovare l'elenco completo delle lingue supportate nella pagina delle lingue supportate.

5. Traduci testo

Puoi utilizzare l'API Translation per tradurre il testo da una lingua a un'altra. Il testo viene tradotto utilizzando il modello di traduzione automatica neurale (NMT). Se il modello NMT non è supportato per la coppia di traduzione linguistica richiesta, viene utilizzato il modello di traduzione automatica a frase (PBMT). Per saperne di più su Google Traduttore e sui suoi modelli di traduzione, leggi il post dell'annuncio della NMT.

Per tradurre un testo, copia il seguente codice nella sessione Python:

def translate_text(text: str, target_language_code: str) -> translate.Translation:
    client = translate.TranslationServiceClient()

    response = client.translate_text(
        parent=PARENT,
        contents=[text],
        target_language_code=target_language_code,
    )

    return response.translations[0]

Richiama la funzione per tradurre lo stesso testo in lingue diverse:

text = "Hello World!"
target_languages = ["tr", "de", "es", "it", "el", "zh", "ja", "ko"]

print(f" {text} ".center(50, "-"))
for target_language in target_languages:
    translation = translate_text(text, target_language)
    source_language = translation.detected_language_code
    translated_text = translation.translated_text
    print(f"{source_language} → {target_language} : {translated_text}")

Dovresti visualizzare quanto segue:

------------------ Hello World! ------------------
en → tr : Selam Dünya!
en → de : Hallo Welt!
en → es : ¡Hola Mundo!
en → it : Ciao mondo!
en → el : Γειά σου Κόσμε!
en → zh : 你好世界！
en → ja : 「こんにちは世界」
en → ko : 안녕하세요 세계!

Riepilogo

In questo passaggio hai potuto utilizzare l'API Translation per tradurre il testo in più lingue. Scopri di più sulla traduzione di testo.

6. Rileva lingue

Puoi anche utilizzare l'API Translation per rilevare la lingua di una stringa di testo.

Copia il seguente codice nella tua sessione IPython:

def detect_language(text: str) -> translate.DetectedLanguage:
    client = translate.TranslationServiceClient()

    response = client.detect_language(parent=PARENT, content=text)

    return response.languages[0]

Richiama la funzione per rilevare la lingua di diverse frasi:

sentences = [
    "Selam Dünya!",
    "Hallo Welt!",
    "¡Hola Mundo!",
    "Ciao mondo!",
    "Γειά σου Κόσμε!",
    "你好世界！",
    "「こんにちは世界」",
    "안녕하세요 세계!",
]
for sentence in sentences:
    language = detect_language(sentence)
    confidence = language.confidence
    language_code = language.language_code
    print(
        f"Confidence: {confidence:4.0%}",
        f"Language: {language_code:5}",
        sentence,
        sep=" | ",
    )

Dovresti visualizzare quanto segue:

Confidence: 100% | Language: tr    | Selam Dünya!
Confidence:  80% | Language: de    | Hallo Welt!
Confidence: 100% | Language: es    | ¡Hola Mundo!
Confidence: 100% | Language: it    | Ciao mondo!
Confidence: 100% | Language: el    | Γειά σου Κόσμε!
Confidence: 100% | Language: zh-CN | 你好世界！
Confidence: 100% | Language: ja    | 「こんにちは世界」
Confidence: 100% | Language: ko    | 안녕하세요 세계!

Riepilogo

In questo passaggio, sei stato in grado di rilevare la lingua di una parte di testo utilizzando l'API Translation. Scopri di più sul rilevamento delle lingue.

7. Complimenti

Hai imparato a utilizzare l'API Translation con Python.

Pulizia

Per ripulire il tuo ambiente di sviluppo, da Cloud Shell:

Se sei ancora nella sessione Python, torna alla shell: exit
Interrompi l'utilizzo dell'ambiente virtuale Python: deactivate
Elimina la cartella dell'ambiente virtuale: cd ~ ; rm -rf ./venv-translate

Per eliminare il tuo progetto Google Cloud, da Cloud Shell:

Recupera il tuo ID progetto attuale: PROJECT_ID=$(gcloud config get-value core/project)
Assicurati che questo sia il progetto che vuoi eliminare: echo $PROJECT_ID
Elimina il progetto: gcloud projects delete $PROJECT_ID

Scopri di più

Documentazione di Cloud Translation: https://cloud.google.com/translate/docs
Python su Google Cloud: https://cloud.google.com/python
Librerie client di Cloud per Python: https://github.com/googleapis/google-cloud-python

Licenza

Questo lavoro è concesso in licenza ai sensi di una licenza Creative Commons Attribution 2.0 Generic.