Romanisasi teks

Romanisasi mengonversi skrip non-Latin ke skrip Latin. Skrip Latin didasarkan pada pengucapan bahasa sumber. Misalnya, Cloud Translation mengubah karakter Jepang berikut こんにちは世界 menjadi Kon'nichiwa sekai secara romawi.

Untuk mengetahui bahasa yang dapat menggunakan abjad romawi, lihat Bahasa yang didukung.

Sebelum memulai

Sebelum dapat mulai menggunakan Cloud Translation API, Anda harus memiliki project yang mengaktifkan Cloud Translation API, dan harus memiliki kredensial yang sesuai. Anda juga dapat menginstal library klien untuk bahasa pemrograman umum guna membantu melakukan panggilan ke API. Untuk informasi selengkapnya, lihat halaman Penyiapan.

Romanisasi teks

REST

Gunakan metode romanizeText untuk mengonversi skrip non-Latin menjadi skrip Latin.

Sebelum menggunakan data permintaan apa pun, lakukan penggantian sebagai berikut:

PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda
LOCATION: Region tempat Anda ingin menjalankan operasi ini. Contoh, us-central1
SOURCE_LANGUAGE: Kode bahasa teks sumber.
SOURCE_TEXT: Teks dalam bahasa sumber yang akan ditulis dalam abjad romawi.

Metode HTTP dan URL:

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

Isi JSON permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login gcloud CLI. Anda dapat memeriksa akun yang saat ini sedang aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON seperti berikut:

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

Langkah berikutnya

Harga abjad romawi dihitung per karakter yang dikirim. Untuk informasi selengkapnya, lihat Harga.