Romanzare il testo

La traslitterazione in caratteri latini consente di convertire il testo in caratteri latini. Lo script latino si basa sulla pronuncia della lingua di origine. Ad esempio, Cloud Translation romanizza i seguenti caratteri giapponesi こんにちは世界 in Kon'nichiwa sekai.

Per sapere quali lingue possono essere romanizzate, vedi Lingue supportate.

Prima di iniziare

Per iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e disporre delle credenziali appropriate. Puoi anche installare librerie client per linguaggi di programmazione comuni per facilitare le chiamate all'API. Per saperne di più, consulta la pagina Configurazione.

Romanzare il testo

REST

Utilizza il metodo romanizeText per convertire lo script non latino in script latino.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud
LOCATION: regione in cui vuoi eseguire questa operazione. Ad esempio, us-central1.
SOURCE_LANGUAGE: il codice lingua del testo di origine.
SOURCE_TEXT: testo nella lingua di origine da localizzare.

Metodo e URL HTTP:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText

Corpo JSON richiesta:

{
  "source_language_code": "SOURCE_LANGUAGE",
  "contents": "SOURCE_TEXT"
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all' interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login, oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso all'interfaccia a riga di comando di gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "romanizations": [
    {
      "romanizedText": "ROMANIZED_TEXT"
    }
  ]
}

Passaggi successivi

Il prezzo di traslitterazione viene calcolato in base al carattere inviato. Per ulteriori informazioni, consulta la pagina Prezzi.