Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori nello 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 è fornito per la durata della corsa, la distanza e il sistema di unità di misura (metrico o imperiale). Richiedi valori localizzati utilizzando una maschera di campo e puoi specificare la lingua e il sistema di unità di misura oppure utilizzare i valori dedotti dall'API. Per maggiori dettagli, consulta
LocalizedValues.
Ad esempio, se specifichi un codice lingua per il tedesco (de) e le unità imperiali, ottieni un valore di distanceMeters pari a 49889,7, ma anche un testo localizzato che fornisce la misurazione della distanza in tedesco e unità imperiali, quindi "31 Meile".
Ecco un esempio di ciò che vedrai per i valori localizzati:
Se non specifichi la lingua o il sistema di unità, l'API deducono la lingua
e le unità come segue:
Il metodo ComputeRoutes deducono le unità di misura della posizione e della distanza dal waypoint di partenza. Pertanto, per una richiesta di routing negli Stati Uniti, l'API deduce la lingua en-US e le unità IMPERIAL.
Il metodo ComputeRouteMatrix ha come valore predefinito la lingua "en-US"
e le unità di misura METRIC.
Per richiedere valori localizzati
Per includere i valori localizzati nella risposta, devi procedere nel seguente modo:
Richiedi valori localizzati nella maschera del campo. Ad esempio:
REST
-H X-Goog-FieldMask: localizedValues
RPC
const(fieldMask="localizedValues")
Se vuoi i valori localizzati in una lingua o un sistema di unità specifico,
specifica il codice lingua e il sistema di unità:
[null,null,["Ultimo aggiornamento 2025-06-20 UTC."],[],[],null,["# Request localized values\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nLocalized response values are an additional response field that provides\nlocalized text for returned parameter values. Localized text is provided for\ntrip duration, distance, and unit system (metric or imperial). You request\nlocalized values using a field mask, and can either specify the language and\nunit system or use the values inferred by the API. For details, see\n[LocalizedValues](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#routelegsteplocalizedvalues).\n\nFor example, if you specify a language code for German (de) and imperial\nunits, you get a value for `distanceMeters` of 49889.7,\nbut also localized text providing that distance measurement in German and\nimperial units, so \"31 Meile.\"\n\nHere is an example of what you would see for localized values: \n\n```restructuredtext\n{ \"localized_values\":\n {\n \"distance\": { \"text\": \"31,0 Meile/n\" },\n \"duration\": { \"text\": 38 Minuten}.\n \"static_duration\": { \"text\": 36 Minuten}.\n }\n}\n```\n| Note: You get two values for the expected duration: `duration` uses the traffic model you specify, and `static_duration` does not take traffic into account. So, if your requested traffic model is `TRAFFIC_UNAWARE` these times are identical.\n\nIf you don't specify the language or unit system, the API infers the language\nand units as follows:\n\n- The `ComputeRoutes` method infers the location and distance units from the origin waypoint. So for a routing request in the US, the API infers `en-US` language and `IMPERIAL` units.\n- The `ComputeRouteMatrix` method defaults to 'en-US' language and METRIC units.\n\nTo request localized values\n---------------------------\n\nTo include localized values in the response, you need to do the following:\n\n1. Request localized values in your field mask. For example:\n\n **REST** \n\n ```restructuredtext\n -H X-Goog-FieldMask: localizedValues\n ```\n\n **RPC** \n\n ```gdscript\n const (fieldMask = \"localizedValues\")\n ```\n2. If you want the localized values in a specific language or unit system,\n specify the language code and unit system:\n\n ```console\n \"languageCode\": \"language_code\",\n \"units\": \"METRIC | IMPERIAL\",\n ```\n\n For example, this code snippet specifies the language as German (de), and\n METRIC units: \n\n ```console\n \"languageCode\": \"de\",\n \"units\": \"METRIC\",\n ```\n\n For more information, see\n [Language Support](/maps/faq#languagesupport)."]]