Romanizzare il testo

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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

Per sapere 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 è attivata l'API Cloud Translation e devi disporre delle credenziali appropriate. Puoi anche installare librerie client per i linguaggi di programmazione comuni per aiutarti a effettuare chiamate all'API. Per ulteriori informazioni, consulta la pagina Configurazione.

Romanizzare il testo

REST

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

Prima di utilizzare i dati della richiesta, apporta 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: 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 ti 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 alla CLI 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 ha un prezzo per carattere inviato. Per ulteriori informazioni, consulta la sezione Prezzi.