Nguồn dữ liệu & phương pháp

Nguồn thời tiết chính đang được cấu hình trên website là [dbtt_primary_weather_provider]. Theme hỗ trợ Open-Meteo và WeatherAPI, đồng thời có cơ chế failover có kiểm soát khi nguồn chính không khả dụng.

Open-Meteo

Nguồn forecast có thể được dùng làm nguồn chính hoặc nguồn dự phòng. Website chỉ sử dụng payload đáp ứng contract dữ liệu và timezone mà theme kiểm tra.

Trang Open-Meteo

WeatherAPI

Có thể được cấu hình làm nguồn chính hoặc dự phòng khi chủ website có API key phù hợp. Khóa API không được in trở lại frontend.

Trang WeatherAPI

Một forecast, một provider

Theme không lấy nhiệt độ hiện tại từ một provider rồi tự ghép hourly/daily từ provider khác trong cùng forecast response. Khi failover xảy ra, response được lấy từ một nguồn hợp lệ duy nhất để tránh đổi nghĩa giữa các trường dữ liệu.

Múi giờ và thời gian cập nhật

Provider cần trả timezone IANA hợp lệ cho địa điểm. Các mốc “bây giờ”, theo giờ, ngày dự báo, bình minh/hoàng hôn và thời gian cập nhật được diễn giải theo múi giờ của forecast thay vì mặc định theo timezone của máy chủ WordPress.

Cache và gián đoạn upstream

Website sử dụng cache để giảm số request và giữ trải nghiệm ổn định. Khi upstream lỗi, hệ thống có thể chuyển sang provider dự phòng hoặc dùng last-good data còn đủ coverage theo policy của theme. Hệ thống không tự điền số liệu giả chỉ để giao diện luôn có dữ liệu.

Dữ liệu địa giới

Khi bộ dữ liệu xã/phường được đồng bộ, website sử dụng Vietnam Administrative Divisions Dataset (CC BY 4.0) để lập chỉ mục địa điểm và tọa độ đại diện. Tọa độ đại diện có thể không trùng vị trí thực tế của từng người dùng.

Cách hiểu dữ liệu

Giá trị hiển thị được chuẩn hóa đơn vị trước khi vào component dùng chung. Một số chỉ số hoặc kết luận chỉ xuất hiện khi nguồn có đủ field cần thiết; nếu thiếu dữ liệu, theme ưu tiên trạng thái “chưa có dữ liệu” thay vì suy đoán.

Giới hạn

Mô hình dự báo, dữ liệu lưới và tọa độ đại diện đều có sai số. Xem [dbtt_trust_link slug=”mien-tru-trach-nhiem-thoi-tiet” label=”Miễn trừ trách nhiệm thời tiết”] trước khi dùng thông tin cho hoạt động nhạy cảm với an toàn.

Cập nhật nội dung: 18/09/2026.