Dự báo theo ngày cho một toạ độ, từ 1 tới 16 ngày (mặc định 7)

Nhiệt độ cao nhất và thấp nhất, tổng lượng mưa, xác suất mưa cao nhất, gió mạnh nhất, giờ mọc và lặn của mặt trời. Phản hồi kèm luôn khối thời tiết hiện tại để một lượt gọi dựng đủ một màn hình. Ngày được cắt theo giờ ĐỊA PHƯƠNG của điểm hỏi, tự suy từ toạ độ; truyền `timezone` để ép về một múi giờ cụ thể khi cần xếp nhiều điểm lên cùng một trục ngày. Xa hơn 16 ngày không phải hạn mức tự đặt mà là trần của chính mô hình dự báo.

GET https://api-tools.hitechcloud.vn/api/weather/forecast Đã chép

Cần khoá API

Tham số

lat string · truy vấn bắt buộc

Vĩ độ, -90…90.

lon string · truy vấn bắt buộc

Kinh độ, -180…180.

days string · truy vấn

Số ngày dự báo, 1–16, mặc định 7.

timezone string · truy vấn

Múi giờ dạng IANA để cắt ngày. Bỏ trống thì dùng giờ địa phương của điểm hỏi.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

Ví dụ gọi

bash

curl --location 'https://api-tools.hitechcloud.vn/api/weather/forecast?lat=GIA_TRI&lon=GIA_TRI&days=GIA_TRI&timezone=GIA_TRI' \
--header 'X-API-Key: $HITECH_API_KEY' \
--header 'Accept: application/json'

php

$response = Http::withHeaders([
    'X-API-Key' => env('HITECH_API_KEY'),
])->get('https://api-tools.hitechcloud.vn/api/weather/forecast', [
    'lat' => 'GIA_TRI',
    'lon' => 'GIA_TRI',
    'days' => 'GIA_TRI',
    'timezone' => 'GIA_TRI',
]);

$data = $response->json();

javascript

const q = new URLSearchParams({
  lat: 'GIA_TRI',
  lon: 'GIA_TRI',
  days: 'GIA_TRI',
  timezone: 'GIA_TRI',
});

const res = await fetch(`https://api-tools.hitechcloud.vn/api/weather/forecast?${q}`, {
  headers: { 'X-API-Key': process.env.HITECH_API_KEY },
});

const data = await res.json();

python

import os, requests

res = requests.get(
    "https://api-tools.hitechcloud.vn/api/weather/forecast",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    params={
        "lat": "GIA_TRI",
        "lon": "GIA_TRI",
        "days": "GIA_TRI",
        "timezone": "GIA_TRI",
    },
)
data = res.json()

Đã chép mã

Thử ngay

X-API-Key

Khoá chỉ lưu trong trình duyệt của bạn. Lấy khoá →

lat bắt buộc truy vấn

lon bắt buộc truy vấn

days truy vấn

timezone truy vấn

Cùng nhóm

GET Danh sách quốc gia kèm mã ISO và mã điện thoại GET Tra ngược từ mã bưu chính năm chữ số ra các xã... GET Danh sách 34 tỉnh và thành phố trực thuộc trun... GET Chi tiết một tỉnh hoặc thành phố trực thuộc tr... GET Toàn bộ xã GET Đoán tỉnh và xã/phường từ một chuỗi địa chỉ tự...