Trang này được dịch bởi Cloud Translation API.

Hệ thống đơn vị của API Thời tiết

Bạn có thể chọn METRIC hoặc IMPERIAL cho tất cả điểm cuối của Weather API.

Để yêu cầu hệ thống đơn vị, hãy đặt units_system thành METRIC hoặc IMPERIAL. Nếu không có units_system nào được chỉ định, mặc định sẽ là METRIC.

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

Các giá trị Weather API đã thay đổi từ đơn vị METRIC sang đơn vị IMPERIAL

Bảng sau đây liệt kê các giá trị phản hồi của Weather API có thể được chuyển đổi giữa các hệ thống đơn vị.

Chuyển đổi đơn vị (Hệ mét sang Hệ Anh)	Giá trị API thời tiết
Độ C (°C) đến độ F (°F)	Nhiệt độ, Cảm giác, Điểm sương, Chỉ số nhiệt, Gió lạnh, Bóng đèn ướt
Milimet (mm) sang Inch (in)	Lượng mưa, QPF, Độ dày băng
Kilômét/giờ (km/h) sang Dặm/giờ (mph)	Tốc độ gió, Gió giật
Kilômét (km) sang Dặm (mi)	Chế độ hiển thị

Ví dụ về phản hồi currentConditions

Bảng sau liệt kê các giá trị có trong nội dung phản hồi của yêu cầu currentConditions. Các giá trị được in đậm màu xanh đã thay đổi từ đơn vị METRIC thành IMPERIAL:

Tính năng API thời tiết	METRIC (mặc định)	ĐẾ CHẾ
Thời gian Hiện tại	2025-03-06T11:08:49.126979608Z	6:08:49 ngày 6 tháng 3 năm 2025
Múi giờ	Châu Mỹ/New_York	Châu Mỹ/New_York
Là ban ngày	FALSE	FALSE
Nội dung mô tả thời tiết	Nhiều mây	Nhiều mây
Nhiệt độ	11,5 °C	11,5 °C
Nhiệt độ cảm giác	9,9 °C	9,8 °C
Điểm sương	8,7 °C	8,7 °C
Chỉ số nhiệt	11,5 °C	11,5 °C
Gió lạnh	9,9 °C	9,8 °C
Độ ẩm tương đối	83 %	83 %
Chỉ số UV	0	0
Xác suất có mưa	9 %	9 %
Lượng mưa	0 mm	0 in
Xác suất có dông bão	0	0
Áp suất không khí	991,47 MB	991,47 MB
Hướng gió	275 °	275 °
Hướng gió (Hướng chính)	TÂY	TÂY
Tốc độ gió	14 km/giờ	9 dặm/giờ
Gió giật	27 km/giờ	17 dặm/giờ
Chế độ hiển thị	10 km	6 dặm
Độ che phủ của mây	65 %	65 %
Thay đổi nhiệt độ	1,4 °C	-16,3 °C
Nhiệt độ tối đa	13,2 °C	13 °C
Nhiệt độ tối thiểu	10,1 °C	10 °C
QPF	27,5564 mm	1.0849 in

Hệ thống đơn vị trên thế giới

Hệ đơn vị theo quốc gia

Hầu hết các quốc gia bên ngoài Hoa Kỳ đều sử dụng hệ thống METRIC, trong khi Hoa Kỳ sử dụng hệ thống IMPERIAL. Một số quốc gia, chẳng hạn như Vương quốc Anh và Canada, sử dụng kết hợp cả hai hệ thống. Để xem bản đồ và danh sách đầy đủ các quốc gia sử dụng hệ đo lường, hãy xem Hệ đo lường.

Hệ thống đơn vị trên toàn cầu

Chuyển đổi đơn vị từ phản hồi của Weather API

Tự chuyển đổi đơn vị

Bạn có thể chuyển đổi đơn vị theo cách thủ công bằng cách sử dụng tập lệnh sau:

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

Chuyển đổi đơn vị bằng thư viện

Bạn cũng có thể dùng một thư viện như convert-units để chuyển đổi đơn vị:


// 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