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ệ đo lường hoặc hệ đo lường Anh). 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ữ và 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ữ là tiếng Đức (de) và đơn vị đo lường theo hệ đo lường Anh, bạn sẽ nhận được giá trị 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".

Để yêu cầu các giá trị được bản địa hoá, hãy làm theo các bước sau:

  1. Thêm trường localizedValues vào thuộc tính fields của ComputeRoutesRequest.
  2. Bạn có thể chỉ định ngôn ngữ và hệ thống đơn vị bằng cách sử dụng các thuộc tính languageCode và units của ComputeRoutesRequest.

Sau đây là ví dụ về cách yêu cầu các giá trị đã bản địa hoá:

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};

Nếu bạn không chỉ định ngôn ngữ hoặc hệ thống đơn vị, phương thức computeRoutes sẽ 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 một yêu cầu định tuyến ở Hoa Kỳ, API sẽ suy ra ngôn ngữ en-US và đơn vị IMPERIAL.

Để đọc các giá trị được bản địa hoá, hãy sử dụng route.localizedValues. Ví dụ:

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;