Richiedi valori localizzati

Sviluppatori dello Spazio economico europeo (SEE)

I valori di risposta localizzati sono un campo di risposta aggiuntivo che fornisce testo localizzato per i valori dei parametri restituiti. Il testo localizzato viene fornito per la durata del viaggio, la distanza e il sistema di unità (metrico o imperiale). Richiedi valori localizzati utilizzando una maschera del campo e puoi specificare la lingua e il sistema di unità di misura oppure utilizzare i valori dedotti dall'API. Per maggiori dettagli, vedi LocalizedValues.

Ad esempio, se specifichi un codice lingua per il tedesco (de) e le unità imperiali, ottieni un valore per distanceMeters di 49889,7, ma anche un testo localizzato che fornisce la misurazione della distanza in tedesco e in unità imperiali, ovvero "31 Meile".

Per richiedere valori localizzati:

  1. Aggiungi il campo localizedValues alla proprietà fields di ComputeRoutesRequest.
  2. Facoltativamente, specifica la lingua e il sistema di unità utilizzando le proprietà languageCode e units di ComputeRoutesRequest.

Ecco un esempio di richiesta di valori localizzati:

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

Se non specifichi la lingua o il sistema di unità di misura, il metodo computeRoutes deduce le unità di posizione e distanza dal waypoint di origine. Quindi, per una richiesta di routing negli Stati Uniti, l'API deduce la lingua en-US e le unità IMPERIAL.

Per leggere i valori localizzati, utilizza route.localizedValues. Ad esempio:

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