java translate Download - java translate Source Code Download

java translate

Anderer Quellcode

v2.3.5

Herunterladen

Google Cloud Translation Client für Java

Java -idiomatischer Client für die Cloud -Übersetzung.

Produktdokumentation
Client Library -Dokumentation

? Im Oktober 2022 ist diese Bibliothek zu Google-Cloud-Java/Java-Translate übergegangen. Dieses Repository wird in Zukunft archiviert. Zukünftige Veröffentlichungen werden im neuen Repository (https://github.com/googleapis/google-cloud-java/releases) angezeigt. Die Koordinaten der Maven-Artefakte ( com.google.cloud:google-cloud-translate ) bleiben gleich.

QuickStart

Wenn Sie Maven mit BOM verwenden, fügen Sie dies Ihrer Datei pom.xml hinzu:

< 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 >

Wenn Sie Maven ohne BOM verwenden, fügen Sie dies zu Ihren Abhängigkeiten hinzu:

< dependency >
  < groupId >com.google.cloud</ groupId >
  < artifactId >google-cloud-translate</ artifactId >
  < version >2.3.5</ version >
</ dependency >

Wenn Sie Gradle 5.x oder höher verwenden, fügen Sie dies zu Ihren Abhängigkeiten hinzu:

implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )

implementation ' com.google.cloud:google-cloud-translate '

Wenn Sie Gradle ohne BOM verwenden, fügen Sie dies zu Ihren Abhängigkeiten hinzu:

implementation ' com.google.cloud:google-cloud-translate:2.6.0 '

Wenn Sie SBT verwenden, fügen Sie dies zu Ihren Abhängigkeiten hinzu:

libraryDependencies + = " com.google.cloud " % " google-cloud-translate " % " 2.6.0 "

Authentifizierung

Siehe den Abschnitt Authentifizierung im Readme des Basisverzeichnisses.

Genehmigung

Der für die gewünschten Cloud -Übersetzungs -APIs erforderlichen API -Anrufe für API -Aufrufe von API müssen die Autorisierungsbereiche erteilt werden, und das authentifizierte Kapital muss über die IAM -Rolle verfügen, die für den Zugriff auf GCP -Ressourcen mithilfe der Cloud -Übersetzungs -API -Aufrufe erforderlich sind.

Erste Schritte

Voraussetzungen

Sie benötigen ein Google Cloud -Plattform -Konsolenprojekt mit der Cloud -Übersetzungs -API aktiviert. Sie müssen die Abrechnung aktivieren, um die Google Cloud -Übersetzung zu verwenden. Befolgen Sie diese Anweisungen, um Ihr Projekt einzurichten. Sie müssen auch die lokale Entwicklungsumgebung einrichten, indem Sie das Google Cloud SDK installieren und die folgenden Befehle in der Befehlszeile ausführen: gcloud auth login und gcloud config set project [YOUR PROJECT ID] .

Installation und Setup

Sie müssen die google-cloud-translate Bibliothek erhalten. Siehe Abschnitt QuickStart, um google-cloud-translate als Abhängigkeit in Ihrem Code hinzuzufügen.

Über Cloud -Übersetzung

Die Cloud -Übersetzung kann den Text zwischen Tausenden von Sprachpaaren dynamisch übersetzen. Mit Übersetzung können Websites und Programme programmatisch in den Übersetzungsdienst integrieren.

In den Cloud Translation Client -Bibliotheksdokumenten finden Sie unter Verwendung dieser Cloud -Übersetzungs -Client -Bibliothek.

Beispielanwendung

TranslateExample ist eine einfache Befehlszeilenschnittstelle, die einige Funktionen von Google Translation bietet.

Erstellen eines autorisierten Serviceobjekts

Um authentifizierte Anfragen an Google Translation zu stellen, müssen Sie ein Serviceobjekt mit Anmeldeinformationen erstellen oder einen API -Schlüssel verwenden. Der einfachste Weg zur Authentifizierung ist die Verwendung von Anwendungsausfallanmeldeinformationen. Diese Anmeldeinformationen werden automatisch aus Ihrer Umgebung abgeleitet, sodass Sie nur den folgenden Code benötigen, um Ihr Serviceobjekt zu erstellen:

 import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;

Translate translate = TranslateOptions . getDefaultInstance (). getService ();

Beachten Sie, dass dieser Code auch mit einem API -Schlüssel verwendet werden kann. Standardmäßig wird in der Umgebungsvariablen GOOGLE_API_KEY ein API -Schlüssel gesucht. Sobald der API -Schlüssel festgelegt ist, können Sie API -Aufrufe tätigen, indem Sie Methoden auf dem Übersetzungsdienst auf den Übersetzer erstellt.getDefaultInstance TranslateOptions.getDefaultInstance().getService() .

Sie können die API -Schlüssel auch ausdrücklich wie folgt festlegen:

 Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();

Sprache erkennen

Mit Google Translation können Sie die Sprache eines Textes erkennen. Der Service bietet Ihnen den Code der erkannten Sprache und ein Vertrauensniveau.

Fügen Sie den folgenden Import oben in Ihrer Datei hinzu:

 import com . google . cloud . translate . Detection ;

Wählen Sie dann ein Textspiel aus:

 final String mysteriousText = "Hola Mundo" ;

Fügen Sie dann den folgenden Code hinzu, um die Sprache des Textes zu erkennen:

 Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();

Text übersetzen

Mit Google Translation können Sie einen Text übersetzen. Wenn Sie einen oder mehrere Texte übersetzen, können Sie entweder die Quellsprache angeben oder den Dienst für Sie erkennen lassen.

Fügen Sie die folgenden Importe oben in Ihrer Datei hinzu:

 import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;

Fügen Sie dann den folgenden Code hinzu, um den Text zu übersetzen, und geben Sie die zuvor erkannte Sprache ( detectedLanguage ) als Quellsprache und Englisch als Zielsprache an (bereitzustellen, dass die Quellsprache optional ist. Wenn der Dienst nicht angegeben ist, versucht der Dienst automatisch zu erkennen) :

 Translation translation = translate . translate (
    mysteriousText ,
    TranslateOption . sourceLanguage ( detectedLanguage ),
    TranslateOption . targetLanguage ( "en" ));

Komplette Quellcode

In DetectLanguageAndtranslate.java haben wir alle oben gezeigten Code in ein Programm zusammengestellt. Das Programm geht davon aus, dass entweder Anwendungsausfallanmeldeinformationen oder ein gültiger API -Schlüssel verfügbar sind.

Proben

Die Proben befinden sich in den samples/ Verzeichnissen.

Probe	Quellcode	Versuchen Sie es
QuickStart -Probe	Quellcode
Text mit Glossar und Modell übersetzen	Quellcode
Batch -Übersetzungsdokument	Quellcode
Dokument übersetzen	Quellcode

Fehlerbehebung

Um Hilfe zu erhalten, befolgen Sie die Anweisungen im gemeinsam genutzten Dokument zur Fehlerbehebung.

Transport

Cloud Translation verwendet sowohl GRPC als auch HTTP/JSON für die Transportschicht.

Unterstützte Java -Versionen

Java 8 oder höher ist für die Verwendung dieses Clients erforderlich.

Die Java -Client -Bibliotheken von Google, Google Cloud -Client -Bibliotheken und Google Cloud -API -Bibliotheken folgen dem Oracle Java SE -Support -Roadmap (siehe Abschnitt Oracle Java SE -Produktveröffentlichungen).

Für neue Entwicklung

Im Allgemeinen erfolgt eine neue Feature -Entwicklung mit Unterstützung für die niedrigste Java -LTS -Version, die von Oracas wichtigster Unterstützung abgedeckt wird (die normalerweise 5 Jahre von der ersten allgemeinen Verfügbarkeit dauert). Wenn das erforderliche Mindest -JVM für eine bestimmte Bibliothek geändert wird, wird sie von einer SEMVER -Hauptveröffentlichung begleitet.

Java 11 und (im September 2021) Java 17 sind die besten Möglichkeiten für die neue Entwicklung.

Produktionssysteme aktuell halten

Google testet seine Client -Bibliotheken mit allen aktuellen LTS -Versionen, die von Oracles erweitertem Support abgedeckt werden (was normalerweise 8 Jahre von der ersten allgemeinen Verfügbarkeit dauert).

Legacy -Unterstützung

Die Client -Bibliotheken von Google unterstützen Legacy -Versionen von Java Runtimes mit langfristigen stabilen Bibliotheken, die keine Funktionsaktualisierungen auf bestenfalls auf Bemühungen erhalten, da es möglicherweise nicht möglich ist, alle Patches zu erfassen.

Google bietet Updates für Apps, die weiterhin Java 7 verwenden, auf bestmögliche Bemühungen aktualisiert, obwohl Apps möglicherweise auf aktuelle Versionen der Bibliothek ein Upgrade durchführen müssen, die ihre JVM unterstützen.

Wo finden Sie spezielle Informationen

Die neuesten Versionen und die unterstützten Java-Versionen werden auf dem einzelnen Github-Repository github.com/GoogleAPIs/java-SERVICENAME und auf Google-loud-java identifiziert.

Versioning

Diese Bibliothek folgt der semantischen Versionierung.

Beitragen

Beiträge zu dieser Bibliothek sind immer willkommen und sehr gefördert.

Weitere Informationen finden Sie unter Einstieg, um loszulegen.

Bitte beachten Sie, dass dieses Projekt mit einem Verhaltenskodex von Mitwirkenden veröffentlicht wird. Wenn Sie an diesem Projekt teilnehmen, erklären Sie sich damit einverstanden, sich an seine Bedingungen einzuhalten. Weitere Informationen finden Sie unter Verhaltenskodex.