Sistemi di unità dell'API Weather

Puoi scegliere tra METRIC o IMPERIAL per tutti gli endpoint dell'API meteo.

Per richiedere un sistema di unità, imposta units_system su METRIC o IMPERIAL. Se non viene specificato alcun valore per units_system, il valore predefinito sarà METRIC.

https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&units_system=IMPERIAL

I valori dell'API meteo sono passati dalle unità METRIC a quelle IMPERIAL

La seguente tabella elenca i valori di risposta dell'API Weather che possono essere convertiti tra sistemi di unità di misura.

Conversione delle unità di misura (metriche in imperiali)	Valori dell'API Weather
Da Celsius (°C) a Fahrenheit (°F)	Temperatura, Temperatura percepita, Punto di rugiada, Indice di calore, Fattore di raffreddamento del vento, Temperatura di bulbo umido
Millimetri (mm) a pollici (in)	Precipitazioni, QPF, spessore del ghiaccio
Chilometri all'ora (km/h) in Miglia all'ora (mph)	Velocità del vento, Raffica di vento
Chilometri (km) in miglia (mi)	Visibilità

Nota: la pressione dell'aria (mb) non viene convertita in PSI.

Esempio di risposta currentConditions

La seguente tabella elenca i valori inclusi nel corpo della risposta di una richiesta currentConditions. I valori in blu grassetto sono passati dalle unità METRIC alle unità IMPERIAL:

Funzionalità dell'API Weather	METRIC (predefinito)	IMPERIALE
Ora attuale	2025-03-06T11:08:49.126979608Z	06/03/2025 06:08:49
Fuso orario	America/New_York	America/New_York
È giorno	FALSO	FALSO
Descrizione del meteo	Prevalentemente nuvoloso	Prevalentemente nuvoloso
Temperatura	11,5 °C	11,5 °C
Temperatura percepita	9,9 °C	9,3 °C
Punto di rugiada	8,7 °C	8,6 °C
Indice di calore	11,5 °C	11,5 °C
Wind chill	9,9 °C	9,3 °C
Umidità relativa	83 %	83 %
Indice UV	0	0
Probabilità di precipitazioni	9 %	9 %
Precipitazioni	0 mm	0 in
Probabilità di temporale	0	0
Pressione atmosferica	991,47 MB	991,47 MB
Direzione del vento	275 °	275 °
Direzione del vento (cardinali)	OVEST	OVEST
Velocità vento	14 km/h	9 mph
Raffica di vento	27 km/h	17 mph
Visibilità	10 km	9,6 km
CloudCover	65 %	65 %
Variazione di temperatura	1,4 °C	-3,3 °C
Temperatura massima	13,2 °C	13,2 °C
Temperatura minima	10,1 °C	10 °C
QPF	27,5564 mm	2,75 cm

Sistemi di unità di misura nel mondo

Sistemi di unità di misura per paese

La maggior parte dei paesi al di fuori degli Stati Uniti utilizza il sistema METRIC, mentre gli Stati Uniti utilizzano il sistema IMPERIAL. Alcuni paesi, come il Regno Unito e il Canada, utilizzano un sistema ibrido che combina entrambi. Per una mappa e un elenco completo dei paesi che utilizzano il sistema metrico, consulta Metrica.

Convertire le unità dalla risposta dell'API Weather

Convertire le unità manualmente

Puoi convertire le unità manualmente utilizzando il seguente script:

function convert(conversionType, value) {
  if (value === null || value === undefined || typeof value !== 'number') {
    return "Invalid input"; // Handle null, undefined, or non-numeric input
  }

  switch (conversionType) {
    case 'C_to_F': // Celsius to Fahrenheit
      let convertedCtoF = (value * 9 / 5) + 32;
      return convertedCtoF.toFixed(2) + " °F";
    case 'mm_to_in': // Millimeters to Inches
      let convertedMmToIn = value * 0.0393701;
      return convertedMmToIn.toFixed(2) + " in";
    case 'km_to_mi': // Kilometers to Miles
      let convertedKmToMi = value * 0.621371;
      return convertedKmToMi.toFixed(2) + " mi";
    case 'km/h_to_mph': // Kilometers per hour to Miles per hour
      let convertedKmHToMph = value * 0.621371;
      return convertedKmHToMph.toFixed(2) + " mph";
    case 'millibar_to_psi': // Millibar to PSI
      let convertedMillibarToPsi = value * 0.0145038;
      return convertedMillibarToPsi.toFixed(2) + " psi";
    default:
      return "Invalid conversion type";
  }
}

console.log(convert('C_to_F', 10)); // Output: 50.00 °F
console.log(convert('mm_to_in', 25)); // Output: 0.98 in
console.log(convert('invalid_type', 5)); // Output: Invalid conversion type

Convertire unità utilizzando una libreria

Puoi anche utilizzare una libreria come convert-units per convertire le unità:

// module

import convert from 'convert-units';

// or script inclusion
//   <script src="https://unpkg.com/convert@5.8.0/dist/index.js" ></script> 
// let convert = convert.convert

function convertWithLibrary(conversionType, value) {
  if (value === null || value === undefined || typeof value !== 'number') {
    return "Invalid input";
  }

  try {
    switch (conversionType) {
      case 'C_to_F':
        let convertedCtoF = convert(value, 'C').to('F');
        return convertedCtoF.toFixed(2) + " °F";
      case 'mm_to_in':
        let convertedMmToIn = convert(value, 'mm').to('in');
        return convertedMmToIn.toFixed(2) + " in";
      case 'km_to_mi':
        let convertedKmToMi = convert(value, 'km').to('mi');
        return convertedKmToMi.toFixed(2) + " mi";
      case 'km/h_to_mph':
        // km/h is not directly supported, so we convert km to mi
        // then assume it's per hour
        let convertedKmToMiValue = convert(value, 'km').to('mi');
        return convertedKmToMiValue.toFixed(2) + " mph";
      case 'millibar_to_psi':
        // millibar is not directly supported, so convert millibar to bar, then bar to psi
        let barValue = value / 1000;
        let convertedMillibarToPsi = convert(barValue, 'bar').to('psi');
        return convertedMillibarToPsi.toFixed(2) + " psi";
      default:
        return "Invalid conversion type";
    }
  } catch (error) {
    console.error("Conversion error:", error);
    return "Conversion failed";
  }
}

console.log(convertWithLibrary('C_to_F', 10)); // Output: 50.00 °F
console.log(convertWithLibrary('mm_to_in', 25)); // Output: 0.98 in
console.log(convertWithLibrary('invalid_type', 5)); // Output: Invalid conversion type