Yêu cầu giá trị được bản địa hóa

Giá trị phản hồi đã bản địa hoá là một trường phản hồi bổ sung cung cấp văn bản đã bản địa hoá cho các giá trị tham số được trả về. Văn bản đã bản địa hoá được cung cấp cho thời lượng chuyến đi, khoảng cách và hệ thống đơn vị (theo hệ mét hoặc hệ đo lường Anh). Bạn yêu cầu các giá trị đã bản địa hoá bằng mặt nạ trường và có thể chỉ định ngôn ngữ và hệ thống đơn vị hoặc sử dụng các giá trị do API suy luận. Để biết thông tin chi tiết, hãy xem LocalizedValues.

Ví dụ: nếu chỉ định mã ngôn ngữ cho đơn vị tiếng Đức (de) và đơn vị hệ Anh, bạn sẽ nhận được giá trị distanceMeters là 49889.7, nhưng cũng đã bản địa hoá văn bản cung cấp phép đo khoảng cách bằng đơn vị tiếng Đức và đơn vị Anh, vì vậy, bạn sẽ nhận được "31 Meile".

Dưới đây là ví dụ về những gì bạn sẽ thấy đối với các giá trị đã bản địa hoá:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

Nếu bạn không chỉ định ngôn ngữ hoặc hệ thống đơn vị, thì API sẽ suy ra ngôn ngữ và đơn vị như sau:

  • Phương thức ComputeRoutes dự đoán vị trí và đơn vị khoảng cách từ điểm tham chiếu gốc. Vì vậy, đối với yêu cầu định tuyến ở Hoa Kỳ, API dự đoán ngôn ngữ en-US và đơn vị IMPERIAL.
  • Phương thức ComputeRouteMatrix mặc định sử dụng ngôn ngữ "en-US" và đơn vị METRIC.

Cách yêu cầu các giá trị đã bản địa hoá

Để đưa các giá trị đã bản địa hoá vào phản hồi, bạn cần làm như sau:

  1. Yêu cầu các giá trị đã bản địa hoá trong mặt nạ trường. Ví dụ:

    Kiến trúc chuyển trạng thái đại diện (REST)

    -H X-Goog-FieldMask: routes.localized_values

    RPC

    const (fieldMask = "routes.localized_values")

  2. Nếu bạn muốn các giá trị được bản địa hoá sang một hệ thống đơn vị hoặc ngôn ngữ cụ thể, hãy chỉ định mã ngôn ngữ và hệ thống đơn vị:

    "languageCode": "language_code",
"units": "METRIC | IMPERIAL",

    Để biết thêm thông tin, hãy xem phần Hỗ trợ ngôn ngữ.

    Ví dụ: đoạn mã này chỉ định ngôn ngữ là đơn vị tiếng Đức (de) và đơn vị METRIC:

    "languageCode": "de",
"units": "METRIC",

Yêu cầu mẫu

curl -X POST -d '{
  "origin": { "location": {
    "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } }
  },
  "destination": { "location": {
    "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } }
  },
  "travelMode": "DRIVE",
  "computeAlternativeRoutes": true,
  "languageCode": "de",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.localized_values' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ví dụ về phản hồi

Phản hồi trả về các giá trị đã bản địa hoá cho các trường distance, duration và staticDuration:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}