Żą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 dostępny w przypadku czasu trwania przejazdu, odległości i systemu jednostek (metrycznego lub imperialnego). Żądanie wartości zlokalizowanych wysyłasz za pomocą maski pola. Możesz 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 podasz kod języka niemieckiego (de) i jednostki imperialne, otrzymasz wartość distanceMeters równą 49889, 7, ale także zlokalizowany tekst podający pomiar odległości w języku niemieckim i jednostkach imperialnych, czyli „31 Meile”.

Oto przykład, jak wyglądałyby zlokalizowane wartości:

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

Jeśli nie określisz języka ani systemu jednostek, interfejs API wywnioskuje język i jednostki w ten sposób:

  • Metoda ComputeRoutes określa lokalizację i jednostki odległości na podstawie punktu początkowego. W przypadku żądania wyznaczania trasy w Stanach Zjednoczonych interfejs API wywnioskuje język en-US i jednostki IMPERIAL.
  • Metoda ComputeRouteMatrix domyślnie używa języka „en-US” i jednostek METRYCZNYCH.

Aby poprosić o zlokalizowane wartości

Aby uwzględnić w odpowiedzi zlokalizowane wartości, musisz wykonać te czynności:

  1. W masce pola poproś o zwrócenie zlokalizowanych wartości. Na przykład:

    REST

    -H X-Goog-FieldMask: localizedValues

    RPC

    const (fieldMask = "localizedValues")
  2. Jeśli chcesz, aby zlokalizowane wartości były podawane w określonym języku lub systemie jednostek, podaj kod języka i system jednostek:

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

    Na przykład ten fragment kodu określa język niemiecki (de) i jednostki METRYCZNE:

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

    Więcej informacji znajdziesz w sekcji Obsługiwane języki.