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

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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ị (hệ thống đo lường bằng mét hoặc hệ thống đo lường của Hoa Kỳ). Bạn yêu cầu các giá trị được bản địa hoá bằng cách sử dụng một mặt nạ trường và có thể chỉ định ngôn ngữ cũng như hệ thống đơn vị hoặc sử dụng các giá trị mà API suy luận. Để biết thông tin chi tiết, hãy xem LocalizedValues.

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

Sau đâ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ị, API sẽ suy luận ngôn ngữ và đơn vị như sau:

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

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

Để thêm các giá trị được 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ụ:

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

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

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

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

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

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

Ví dụ về yêu cầ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.localizedValues' \
'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"
        }
    }
}