Romanizza un testo

La romanizzazione converte i caratteri non latini in caratteri latini. L'alfabeto latino si basa sulla pronuncia della lingua di origine. Ad esempio, Cloud Translation romanizza i caratteri giapponesi こんにちは世界 in Kon'nichiwa sekai.

Per vedere quali lingue possono essere romanizzate, consulta la sezione Lingue supportate.

Prima di iniziare

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

Romanizza un testo

REST

Utilizza il metodo romanizeText per convertire i caratteri non latini in caratteri latini.

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

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

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste 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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

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)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

$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

La romanizzazione viene calcolata per carattere inviato. Per saperne di più, consulta i prezzi.