Żądanie zlokalizowanych wartości

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Zlokalizowane wartości odpowiedzi to dodatkowe pole odpowiedzi, które zawiera zlokalizowany tekst dla zwracanych wartości parametrów. Zlokalizowany tekst jest podawany w przypadku czasu trwania podróży, odległości i systemu jednostek (metrycznego lub imperialnego). Wartości zlokalizowane możesz pobrać za pomocą maski pola. Możesz też określić język i system jednostek lub użyć wartości wywnioskowanych przez interfejs API. Więcej informacji znajdziesz w sekcji LocalizedValues.

Jeśli na przykład określisz kod języka niemieckiego (de) i jednostki imperialne, otrzymasz wartość distanceMeters 49889, 7, ale także zlokalizowany tekst podający pomiar odległości w języku niemieckim i jednostkach imperialnych, czyli „31 Meile”.

Aby poprosić o wartości w lokalnym języku:

  1. Dodaj pole localizedValues do właściwości fields elementu ComputeRoutesRequest.
  2. Opcjonalnie możesz określić język i system jednostek za pomocą właściwości languageCode i units elementu ComputeRoutesRequest.

Oto przykład żądania zlokalizowanych wartości:

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

Jeśli nie określisz języka ani układu jednostek, metoda computeRoutes wywnioskuje lokalizację i jednostki odległości na podstawie punktu początkowego. W przypadku żądania dotyczącego wyznaczania trasy w Stanach Zjednoczonych interfejs API wywnioskuje en-US język i IMPERIAL jednostki.

Aby odczytać wartości zlokalizowane, użyj route.localizedValues. Na przykład:

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