Klien Idiomatik Java untuk Terjemahan Cloud.
? Pada Oktober 2022, perpustakaan ini telah pindah ke Google-Cloud-Java/Java-Translate. Repositori ini akan diarsipkan di masa depan. Rilis di masa depan akan muncul di repositori baru (https://github.com/googleapis/google-cloud-java/releases). Koordinat artefak Maven ( com.google.cloud:google-cloud-translate
) tetap sama.
Jika Anda menggunakan Maven dengan BOM, tambahkan ini ke file pom.xml Anda:
< dependencyManagement >
< dependencies >
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >libraries-bom</ artifactId >
< version >26.1.3</ version >
< type >pom</ type >
< scope >import</ scope >
</ dependency >
</ dependencies >
</ dependencyManagement >
< dependencies >
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >google-cloud-translate</ artifactId >
</ dependency >
</ dependencies >
Jika Anda menggunakan Maven tanpa bom, tambahkan ini ke dependensi Anda:
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >google-cloud-translate</ artifactId >
< version >2.3.5</ version >
</ dependency >
Jika Anda menggunakan Gradle 5.x atau yang lebih baru, tambahkan ini ke dependensi Anda:
implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )
implementation ' com.google.cloud:google-cloud-translate '
Jika Anda menggunakan Gradle tanpa BOM, tambahkan ini ke dependensi Anda:
implementation ' com.google.cloud:google-cloud-translate:2.6.0 '
Jika Anda menggunakan SBT, tambahkan ini ke dependensi Anda:
libraryDependencies + = " com.google.cloud " % " google-cloud-translate " % " 2.6.0 "
Lihat bagian otentikasi di readme direktori dasar.
Aplikasi klien yang melakukan panggilan API harus diberikan lingkup otorisasi yang diperlukan untuk API terjemahan cloud yang diinginkan, dan prinsipal yang diautentikasi harus memiliki peran IAM yang diperlukan untuk mengakses sumber daya GCP menggunakan panggilan API Terjemahan Cloud.
Anda akan memerlukan proyek konsol Google Cloud Platform dengan API Terjemahan Cloud diaktifkan. Anda perlu mengaktifkan penagihan untuk menggunakan Google Cloud Translation. Ikuti instruksi ini untuk mengatur proyek Anda. Anda juga perlu mengatur lingkungan pengembangan lokal dengan menginstal Google Cloud SDK dan menjalankan perintah berikut di baris perintah: gcloud auth login
DAN gcloud config set project [YOUR PROJECT ID]
.
Anda harus mendapatkan perpustakaan google-cloud-translate
. Lihat bagian QuickStart untuk menambahkan google-cloud-translate
sebagai ketergantungan dalam kode Anda.
Terjemahan cloud dapat secara dinamis menerjemahkan teks antara ribuan pasangan bahasa. Terjemahan memungkinkan situs web dan program secara terprogram mengintegrasikan dengan layanan terjemahan.
Lihat Dokumen Perpustakaan Klien Terjemahan Cloud untuk mempelajari cara menggunakan Perpustakaan Klien Terjemahan Cloud ini.
TranslateExample
adalah antarmuka baris perintah sederhana yang menyediakan beberapa fungsionalitas terjemahan Google.
Untuk membuat permintaan yang diautentikasi ke Google Translation, Anda harus membuat objek layanan dengan kredensial atau menggunakan kunci API. Cara paling sederhana untuk mengautentikasi adalah dengan menggunakan kredensial default aplikasi. Kredensial ini secara otomatis disimpulkan dari lingkungan Anda, sehingga Anda hanya perlu kode berikut untuk membuat objek layanan Anda:
import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;
Translate translate = TranslateOptions . getDefaultInstance (). getService ();
Perhatikan bahwa kode ini juga dapat digunakan dengan kunci API. Secara default, kunci API dicari dalam variabel lingkungan GOOGLE_API_KEY
. Setelah tombol API diatur, Anda dapat melakukan panggilan API dengan memanggil metode pada layanan terjemahan yang dibuat melalui TranslateOptions.getDefaultInstance().getService()
.
Anda juga dapat secara eksplisit mengatur kunci API sebagai berikut:
Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();
Dengan Terjemahan Google Anda dapat mendeteksi bahasa beberapa teks. Layanan ini akan memberi Anda kode bahasa yang terdeteksi dan tingkat kepercayaan diri.
Tambahkan impor berikut di bagian atas file Anda:
import com . google . cloud . translate . Detection ;
Kemudian pilih sampel teks:
final String mysteriousText = "Hola Mundo" ;
Kemudian tambahkan kode berikut untuk mendeteksi bahasa teks:
Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();
Terjemahan Google memungkinkan Anda menerjemahkan beberapa teks. Saat menerjemahkan satu atau lebih teks, Anda dapat menyediakan bahasa sumber atau membiarkan layanan mendeteksi untuk Anda.
Tambahkan impor berikut di bagian atas file Anda:
import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;
Kemudian tambahkan kode berikut untuk menerjemahkan teks, menentukan bahasa yang terdeteksi sebelumnya ( detectedLanguage
) sebagai bahasa sumber dan bahasa Inggrisnya sebagai bahasa target (memberikan bahasa sumber adalah opsional, jika tidak ditentukan layanan akan mencoba mendeteksi secara otomatis) :
Translation translation = translate . translate (
mysteriousText ,
TranslateOption . sourceLanguage ( detectedLanguage ),
TranslateOption . targetLanguage ( "en" ));
Di DetectLangeAndtranslate.java kami mengumpulkan semua kode yang ditunjukkan di atas menjadi satu program. Program ini mengasumsikan bahwa kredensial default aplikasi atau kunci API yang valid tersedia.
Sampel ada di dalam samples/
direktori.
Mencicipi | Kode Sumber | Cobalah |
---|---|---|
Sampel QuickStart | Kode Sumber | |
Menerjemahkan teks dengan glosarium dan model | Kode Sumber | |
Dokumen Terjemahan Batch | Kode Sumber | |
Menerjemahkan dokumen | Kode Sumber |
Untuk mendapatkan bantuan, ikuti instruksi dalam dokumen pemecahan masalah bersama.
Terjemahan cloud menggunakan GRPC dan HTTP/JSON untuk lapisan transportasi.
Java 8 atau di atas diperlukan untuk menggunakan klien ini.
Perpustakaan Klien Java Google, Perpustakaan Klien Google Cloud dan Perpustakaan API Google Cloud, ikuti Roadmap Dukungan Oracle Java SE (lihat bagian Rilis Produk Oracle Java SE).
Secara umum, pengembangan fitur baru terjadi dengan dukungan untuk versi Java LTS terendah yang dicakup oleh dukungan utama Oracle (yang biasanya berlangsung 5 tahun dari ketersediaan umum awal). Jika JVM minimum yang diperlukan untuk perpustakaan tertentu diubah, itu disertai dengan rilis utama SEMVER.
Java 11 dan (pada bulan September 2021) Java 17 adalah pilihan terbaik untuk pengembangan baru.
Google menguji pustaka kliennya dengan semua versi LTS saat ini yang dicakup oleh dukungan yang diperluas Oracle (yang biasanya berlangsung 8 tahun dari ketersediaan umum awal).
Perpustakaan klien Google mendukung versi warisan Java Runtimes dengan perpustakaan stabil jangka panjang yang tidak menerima pembaruan fitur berdasarkan upaya terbaik karena tidak mungkin untuk mendukung semua tambalan.
Google memberikan pembaruan berdasarkan upaya terbaik untuk aplikasi yang terus menggunakan Java 7, meskipun aplikasi mungkin perlu meningkatkan ke versi perpustakaan saat ini yang mendukung JVM mereka.
Versi terbaru dan versi Java yang didukung diidentifikasi pada repositori github individu github.com/GoogleAPIs/java-SERVICENAME
dan di Google-cloud-java.
Perpustakaan ini mengikuti versi semantik.
Kontribusi untuk perpustakaan ini selalu diterima dan sangat dianjurkan.
Lihat berkontribusi untuk informasi lebih lanjut bagaimana memulai.
Harap dicatat bahwa proyek ini dirilis dengan kode perilaku kontributor. Dengan berpartisipasi dalam proyek ini, Anda setuju untuk mematuhi persyaratannya. Lihat Kode Etik untuk informasi lebih lanjut.
Apache 2.0 - Lihat lisensi untuk informasi lebih lanjut.
Versi Java | Status |
---|---|
Java 8 | |
Java 8 Osx | |
Java 8 Windows | |
Java 11 |
Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.