检测语言（基本版）

本文档介绍了如何使用 Cloud Translation 基本版 (v2) 检测字符串的语言。

准备工作

在开始使用 Cloud Translation API 之前，您必须有一个启用了 Cloud Translation API 的项目，以及相应的凭据。您还可以安装常用编程语言的客户端库，以便调用 API。

如需了解详情，请参阅设置页面。

检测文本字符串的语言

要检测文本字符串的语言，使用以下格式的网址发送 HTTP 请求即可：

https://translation.googleapis.com/language/translate/v2/detect

检测单个字符串的语言

REST 和命令行

要检测部分文本的语言，请发出 POST 请求并提供相应的请求正文。下面显示了使用 curl 或 PowerShell 的 POST 请求的示例。本示例针对通过 Cloud SDK 为项目设置的服务帐号使用访问令牌。如需了解有关安装 Cloud SDK、使用服务帐号设置项目以及获取访问令牌的说明，请参阅设置页面。

HTTP 方法和网址：

POST https://translation.googleapis.com/language/translate/v2/detect

请求 JSON 正文：

{
  "q": "Mi comida favorita es una enchilada."
}

如需发送请求，请选择以下方式之一：

curl

注意：请确保已将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务帐号私钥文件路径。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/language/translate/v2/detect

PowerShell

注意：请确保已将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务帐号私钥文件路径。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://translation.googleapis.com/language/translate/v2/detect
" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "data": {
    "detections": [
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "es"
        }
      ]
    ]
  }
}

在响应中，language 是检测到的语言代码。另外两个字段 isReliable 和 confidence 是为了向后兼容而添加的已弃用字段；我们建议不要根据其值做出任何决定或设置任何阈值。

C#

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 C# 设置说明进行操作。如需了解详情，请参阅 Translation C# API 参考文档。

在 GitHub 上查看 反馈

using Google.Cloud.Translation.V2;
using System;

public partial class TranslateSample
{
    public Detection DetectLanguage()
    {
        TranslationClient client = TranslationClient.Create();
        var detection = client.DetectLanguage(text: "Hello world.");
        Console.WriteLine(
            $"{detection.Language}\tConfidence: {detection.Confidence}");
        return detection;
    }
}

Go

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 Go 设置说明进行操作。如需了解详情，请参阅 Translation Go API 参考文档。

在 GitHub 上查看 反馈

import (
	"context"
	"fmt"

	"cloud.google.com/go/translate"
)

func detectLanguage(text string) (*translate.Detection, error) {
	// text := "こんにちは世界"
	ctx := context.Background()
	client, err := translate.NewClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("translate.NewClient: %v", err)
	}
	defer client.Close()
	lang, err := client.DetectLanguage(ctx, []string{text})
	if err != nil {
		return nil, fmt.Errorf("DetectLanguage: %v", err)
	}
	if len(lang) == 0 || len(lang[0]) == 0 {
		return nil, fmt.Errorf("DetectLanguage return value empty")
	}
	return &lang[0][0], nil
}

Java

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 Java 设置说明进行操作。如需了解详情，请参阅 Translation Java API 参考文档。

在 GitHub 上查看 反馈

// TODO(developer): Uncomment these lines.
// import com.google.cloud.translate.*;
// Translate translate = TranslateOptions.getDefaultInstance().getService();

List<String> texts = new LinkedList<>();
texts.add("Hello, World!");
texts.add("¡Hola Mundo!");
List<Detection> detections = translate.detect(texts);

System.out.println("Language(s) detected:");
for (Detection detection : detections) {
  System.out.printf("\t%s\n", detection);
}

Node.js

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情，请参阅 Translation Node.js API 参考文档。

在 GitHub 上查看 反馈

// Imports the Google Cloud client library
const {Translate} = require('@google-cloud/translate').v2;

// Creates a client
const translate = new Translate();

/**
 * TODO(developer): Uncomment the following line before running the sample.
 */
// const text = 'The text for which to detect language, e.g. Hello, world!';

// Detects the language. "text" can be a string for detecting the language of
// a single piece of text, or an array of strings for detecting the languages
// of multiple texts.
async function detectLanguage() {
  let [detections] = await translate.detect(text);
  detections = Array.isArray(detections) ? detections : [detections];
  console.log('Detections:');
  detections.forEach(detection => {
    console.log(`${detection.input} => ${detection.language}`);
  });
}

detectLanguage();

PHP

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 PHP 设置说明进行操作。如需了解详情，请参阅 Translation PHP API 参考文档。

在 GitHub 上查看 反馈

use Google\Cloud\Translate\TranslateClient;

/** Uncomment and populate these variables in your code */
// $text = 'The text whose language to detect.  This will be detected as en.';

$translate = new TranslateClient();
$result = $translate->detectLanguage($text);
print("Language code: $result[languageCode]\n");
print("Confidence: $result[confidence]\n");

Python

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 Python 设置说明进行操作。如需了解详情，请参阅 Translation Python API 参考文档。

在 GitHub 上查看 反馈

def detect_language(text):
    """Detects the text's language."""
    from google.cloud import translate_v2 as translate

    translate_client = translate.Client()

    # Text can also be a sequence of strings, in which case this method
    # will return a sequence of results for each text.
    result = translate_client.detect_language(text)

    print("Text: {}".format(text))
    print("Confidence: {}".format(result["confidence"]))
    print("Language: {}".format(result["language"]))

Ruby

在试用此示例之前，请按照《Translation 快速入门：使用客户端库》中的 Ruby 设置说明进行操作。如需了解详情，请参阅 Translation Ruby API 参考文档。

在 GitHub 上查看 反馈

# project_id = "Your Google Cloud project ID"
# text       = "The text you would like to detect the language of"

require "google/cloud/translate"

translate = Google::Cloud::Translate.translation_v2_service project_id: project_id
detection = translate.detect text

puts "'#{text}' detected as language: #{detection.language}"
puts "Confidence: #{detection.confidence}"

检测多个字符串的语言

REST 和命令行

如需检测多个字符串的语言，请使用 q 参数指定每个字符串。下面的示例传递了两个单独字符串以进行检测：

HTTP 方法和网址：

POST https://translation.googleapis.com/language/translate/v2/detect

请求 JSON 正文：

{
  "q": ["Hello world", "我的名字叫傑夫"]
}

如需发送请求，请选择以下方式之一：

curl

注意：请确保已将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务帐号私钥文件路径。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/language/translate/v2/detect

PowerShell

注意：请确保已将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务帐号私钥文件路径。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://translation.googleapis.com/language/translate/v2/detect
" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "data": {
    "detections": [
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "en"
        }
      ],
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "zh-TW"
        }
      ]
    ]
  }
}

此处，响应包含两项检测结果，它们的顺序与相应源字符串在请求中出现的顺序相同。

C#

如需检测多个文本的语言，只需将多个字符串传递给 client.DetectLanguage 方法（如以上示例所示）。

Go

如需检测多个文本的语言，请将多个字符串包含在传递给 Client#DetectLanguage 方法的切片中（如以上示例所示）。

Java

如需检测多个文本的语言，只需将多个字符串传递给 Translate#detect 方法（如以上示例所示）。

Node.js

如需检测多个文本的语言，只需将字符串数组传递给 Translate#detect 方法（如以上示例所示）。

Python

如需检测多个文本的语言，只需将多个字符串传递给 Client#detect_language 方法（如以上示例所示）。

Ruby

如需检测多个文本的语言，只需将多个字符串传递给 Translate#detect 方法（如以上示例所示）。