Phần 3: Tích hợp API thời tiết

1. Giới thiệu về API thời tiết và cách thức hoạt động

API thời tiết là một giao diện lập trình ứng dụng cho phép người dùng truy cập dữ liệu thời tiết từ các dịch vụ cung cấp thông tin thời tiết trực tuyến. Các API này thường cung cấp thông tin như nhiệt độ, độ ẩm, lượng mưa, và dự báo thời tiết trong khoảng thời gian nhất định.

Các API thời tiết hoạt động dựa trên yêu cầu từ phía người dùng, trong đó người dùng gửi một yêu cầu HTTP đến máy chủ của dịch vụ thời tiết và nhận lại dữ liệu được định dạng theo JSON hoặc XML. Dữ liệu này có thể được sử dụng để phân tích và hiển thị thông tin thời tiết trong ứng dụng của bạn.

2. Đăng ký và lấy khóa API từ dịch vụ thời tiết

Để sử dụng một API thời tiết, trước tiên bạn cần đăng ký tài khoản trên một dịch vụ thời tiết. Một số dịch vụ phổ biến bao gồm OpenWeatherMap, WeatherAPI, và Weatherstack. Dưới đây là hướng dẫn đăng ký và lấy khóa API từ OpenWeatherMap:

Truy cập vào trang web OpenWeatherMap.
Nhấp vào nút "Sign Up" để tạo tài khoản mới.
Điền thông tin cần thiết và xác nhận tài khoản qua email.
Đăng nhập vào tài khoản và truy cập vào mục "API keys".
Sao chép khóa API được cung cấp.

Khóa API này sẽ được sử dụng trong mã lập trình của bạn để xác thực yêu cầu.

3. Lập trình ESP32 để gọi API và nhận dữ liệu thời tiết

Để ESP32 có thể gọi API thời tiết, bạn cần sử dụng thư viện HTTPClient trong Arduino IDE. Dưới đây là mã mẫu để gọi API và nhận dữ liệu thời tiết:


#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "YOUR_SSID";  // Thay thế bằng SSID của bạn
const char* password = "YOUR_PASSWORD";  // Thay thế bằng mật khẩu của bạn
const String apiKey = "YOUR_API_KEY";  // Thay thế bằng khóa API của bạn
const String city = "Hanoi";  // Thay thế bằng thành phố bạn muốn

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);
    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Đang kết nối đến WiFi...");
    }
    Serial.println("Đã kết nối đến WiFi!");

    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;
        String url = "http://api.openweathermap.org/data/2.5/weather?q=" + city + "&appid=" + apiKey;
        http.begin(url);
        
        int httpCode = http.GET();  // Gửi yêu cầu GET
        if (httpCode > 0) {
            String payload = http.getString();  // Nhận dữ liệu
            Serial.println(payload);  // Hiển thị dữ liệu nhận được
        } else {
            Serial.println("Lỗi khi gọi API: " + String(httpCode));
        }
        http.end();  // Giải phóng tài nguyên
    }
}

void loop() {
    // Không có mã trong vòng lặp
}

4. Phân tích dữ liệu nhận được và kiểm tra điều kiện mưa

Dữ liệu nhận được từ API thường ở định dạng JSON. Bạn cần phân tích chuỗi JSON này để lấy thông tin về thời tiết, đặc biệt là điều kiện mưa. Để phân tích JSON, bạn có thể sử dụng thư viện ArduinoJson.

Dưới đây là cách phân tích dữ liệu JSON để kiểm tra điều kiện mưa:


#include <ArduinoJson.h>

...

if (httpCode > 0) {
    String payload = http.getString();
    Serial.println(payload);

    DynamicJsonDocument doc(1024);
    deserializeJson(doc, payload);
    
    // Kiểm tra điều kiện mưa
    if (doc["weather"][0]["main"] == "Rain") {
        Serial.println("Có mưa, không tưới cây.");
    } else {
        Serial.println("Không có mưa, có thể tưới cây.");
    }
}

5. Tích hợp API vào hệ thống tưới cây

Sau khi đã lấy được thông tin thời tiết và kiểm tra điều kiện mưa, bạn có thể tích hợp vào hệ thống tưới cây. Dưới đây là cách tích hợp mã gọi API vào hệ thống tưới cây của bạn:


void loop() {
    // Kiểm tra độ ẩm đất và gọi API thời tiết
    if (soilMoisture < threshold) {
        // Gọi API thời tiết
        checkWeatherAndWater();
    }
}

void checkWeatherAndWater() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;
        String url = "http://api.openweathermap.org/data/2.5/weather?q=" + city + "&appid=" + apiKey;
        http.begin(url);
        
        int httpCode = http.GET();
        if (httpCode > 0) {
            String payload = http.getString();
            DynamicJsonDocument doc(1024);
            deserializeJson(doc, payload);
            
            if (doc["weather"][0]["main"] != "Rain") {
                Serial.println("Tưới cây...");
                // Thêm mã tưới cây ở đây
            } else {
                Serial.println("Có mưa, không tưới cây.");
            }
        }
        http.end();
    }
}

Lưu ý: Đảm bảo rằng bạn đã cài đặt thư viện ArduinoJson và HTTPClient trong Arduino IDE để mã hoạt động chính xác.

Với các bước trên, bạn đã tích hợp thành công API thời tiết vào hệ thống tưới cây thông minh của mình. Hệ thống giờ đây có thể tự động tưới cây mà không cần phải lo lắng về thời tiết xấu!