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

1. 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.

Attenzione:un ID progetto è univoco a livello globale e non può essere utilizzato da nessun altro utente dopo essere stato selezionato. Sei l'unico utente di quell'ID. Anche se un progetto viene eliminato, l'ID non può essere riutilizzato

Nota:se utilizzi un account Gmail, puoi lasciare la posizione predefinita impostata su Nessuna organizzazione. Se utilizzi un account Google Workspace, scegli una località adatta alla tua organizzazione.

2. 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

1. 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.

2. 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`

Nota:lo strumento a riga di comando gcloud è uno strumento a riga di comando potente e unificato disponibile in Google Cloud. È già installato in Cloud Shell. Noterai che supporta il completamento della scheda. Per ulteriori informazioni, consulta la panoramica dello strumento a riga di comando gcloud.

3. 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].

Nota:se stai completando questo tutorial al di fuori di Cloud Shell, segui la procedura per la configurazione delle credenziali predefinite dell'applicazione.

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"

Nota: questa variabile di ambiente si applica solo alla sessione di shell attuale. Di conseguenza, se apri una nuova sessione, imposta di nuovo questa variabile.

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

Nota: per interrompere l'utilizzo dell'ambiente virtuale e tornare alla versione Python del sistema, puoi utilizzare il comando deactivate.

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.

Nota: se stai configurando il tuo ambiente di sviluppo Python al di fuori di Cloud Shell, puoi seguire queste linee guida.

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]:

Nota: se necessario, puoi uscire dalla sessione IPython con il comando exit.

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

Note:

• Viene utilizzata la variabile di ambiente PROJECT_ID definita in precedenza.
• La variabile PARENT verrà utilizzata per le richieste nei passaggi successivi. Si riferisce al progetto del chiamante.

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

Se visualizzi un errore PermissionDenied, digita exit per uscire da IPython e torna al passaggio Configurazione e requisiti.

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.