Cliente idiomático java para tradução em nuvem.
? Em outubro de 2022, esta biblioteca se mudou para o Google-cloud-Java/Java-Translate. Este repositório será arquivado no futuro. Os lançamentos futuros aparecerão no novo repositório (https://github.com/googleapis/google-cloud-java/releases). As coordenadas do artefato maven ( com.google.cloud:google-cloud-translate
) permanecem as mesmas.
Se você estiver usando o MAVEN com BOM, adicione -o ao seu arquivo pom.xml:
< 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 >
Se você estiver usando o MAVEN SEM BOM, adicione isso às suas dependências:
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >google-cloud-translate</ artifactId >
< version >2.3.5</ version >
</ dependency >
Se você estiver usando o gradle 5.x ou posterior, adicione isso às suas dependências:
implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )
implementation ' com.google.cloud:google-cloud-translate '
Se você estiver usando o gradle sem nascimento, adicione isso às suas dependências:
implementation ' com.google.cloud:google-cloud-translate:2.6.0 '
Se você estiver usando o SBT, adicione isso às suas dependências:
libraryDependencies + = " com.google.cloud " % " google-cloud-translate " % " 2.6.0 "
Consulte a seção de autenticação no readme do diretório básico.
As chamadas de API de aplicativo do cliente devem receber escopos de autorização necessários para as APIs de tradução de nuvem desejadas, e o principal autenticado deve ter a (s) função (s) do IAM necessária para acessar os recursos do GCP usando as chamadas da API de tradução em nuvem.
Você precisará de um projeto de console da plataforma do Google Cloud com a API de tradução em nuvem ativada. Você precisará permitir que o faturamento use o Google Cloud Translation. Siga estas instruções para configurar seu projeto. Você também precisará configurar o ambiente de desenvolvimento local instalando o Google Cloud SDK e executando os seguintes comandos na linha de comando: gcloud auth login
e gcloud config set project [YOUR PROJECT ID]
.
Você precisará obter a biblioteca google-cloud-translate
. Consulte a seção Quickstart para adicionar google-cloud-translate
como uma dependência no seu código.
A tradução em nuvem pode traduzir dinamicamente o texto entre milhares de pares de idiomas. A tradução permite que sites e programas se integrem programaticamente ao serviço de tradução.
Consulte os documentos da biblioteca do cliente de tradução em nuvem para aprender a usar essa biblioteca de clientes de tradução em nuvem.
TranslateExample
é uma interface simples da linha de comando que fornece algumas das funcionalidades do Google Translation.
Para fazer solicitações autenticadas para a tradução do Google, você deve criar um objeto de serviço com credenciais ou usar uma chave da API. A maneira mais simples de autenticar é usar credenciais padrão do aplicativo. Essas credenciais são deduzidas automaticamente do seu ambiente; portanto, você só precisa do código a seguir para criar seu objeto de serviço:
import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;
Translate translate = TranslateOptions . getDefaultInstance (). getService ();
Observe que este código também pode ser usado com uma chave da API. Por padrão, uma chave da API é procurada na variável de ambiente GOOGLE_API_KEY
. Depois que a chave da API estiver definida, você pode fazer chamadas de API invocando métodos no Serviço de Tradução criado via TranslateOptions.getDefaultInstance().getService()
.
Você também pode definir explicitamente a chave da API da seguinte maneira:
Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();
Com a tradução do Google, você pode detectar o idioma de algum texto. O serviço fornecerá o código do idioma detectado e um nível de confiança.
Adicione a seguinte importação na parte superior do seu arquivo:
import com . google . cloud . translate . Detection ;
Em seguida, escolha uma amostra de texto:
final String mysteriousText = "Hola Mundo" ;
Em seguida, adicione o código a seguir para detectar o idioma do texto:
Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();
O Google Translation permite traduzir algum texto. Ao traduzir um ou mais textos, você pode fornecer o idioma de origem ou deixar o serviço detectá -lo para você.
Adicione as seguintes importações no topo do seu arquivo:
import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;
Em seguida, adicione o código a seguir para traduzir o texto, especificando a linguagem detectada anteriormente ( detectedLanguage
) como sua linguagem de origem e inglês como o idioma de destino (fornecendo o idioma de origem é opcional, se não for especificado, o serviço tentará detectá -lo automaticamente) :
Translation translation = translate . translate (
mysteriousText ,
TranslateOption . sourceLanguage ( detectedLanguage ),
TranslateOption . targetLanguage ( "en" ));
No DetectLanguageAndTranslate.java, montamos todo o código mostrado acima em um programa. O programa pressupõe que as credenciais padrão do aplicativo ou uma chave de API válida estejam disponíveis.
As amostras estão nas samples/
diretório.
Amostra | Código -fonte | Experimente |
---|---|---|
Amostra rápida | código -fonte | |
Traduzir texto com glossário e modelo | código -fonte | |
Documento de tradução em lote | código -fonte | |
Traduzir documento | código -fonte |
Para obter ajuda, siga as instruções no documento de solução de problemas compartilhados.
A tradução em nuvem usa GRPC e HTTP/JSON para a camada de transporte.
Java 8 ou acima é necessário para usar este cliente.
As bibliotecas de clientes Java do Google, as bibliotecas de clientes do Google Cloud e as bibliotecas de API do Google Cloud, siga o roteiro do Oracle Java SE Support (consulte a seção Oracle Java SE Product Lanfeases).
Em geral, o desenvolvimento de novos recursos ocorre com o suporte à versão mais baixa do Java LTS coberta pelo principal suporte da Oracle (que normalmente dura 5 anos a partir da disponibilidade geral inicial). Se a JVM mínima exigida para uma determinada biblioteca for alterada, ela será acompanhada por uma versão principal do Semver.
Java 11 e (em setembro de 2021) Java 17 são as melhores opções para o novo desenvolvimento.
O Google testa suas bibliotecas de clientes com todas as versões atuais do LTS cobertas pelo suporte estendido da Oracle (que normalmente dura 8 anos a partir da disponibilidade geral inicial).
As bibliotecas de clientes do Google suportam versões legadas do Java RunTimes com bibliotecas estáveis de longo prazo que não recebem atualizações de recursos em uma base de melhores esforços, pois pode não ser possível fazer o backup de todos os patches.
O Google fornece atualizações com base nos esforços dos aplicativos que continuam a usar o Java 7, embora os aplicativos possam precisar atualizar para as versões atuais da biblioteca que suportam sua JVM.
As versões mais recentes e as versões Java suportadas são identificadas no repositório individual do GitHub github.com/GoogleAPIs/java-SERVICENAME
e no google-cloud-java.
Esta biblioteca segue a versão semântica.
As contribuições para esta biblioteca são sempre bem -vindas e altamente encorajadas.
Consulte Contribuindo para obter mais informações sobre como começar.
Observe que este projeto é lançado com um código de conduta colaborador. Ao participar deste projeto, você concorda em cumprir seus termos. Consulte Código de Conduta para obter mais informações.
Apache 2.0 - Consulte Licença para obter mais informações.
Versão Java | Status |
---|---|
Java 8 | |
Java 8 OSX | |
Java 8 Windows | |
Java 11 |
Java é uma marca registrada da Oracle e/ou suas afiliadas.