Giờ mặt trời mọc, lặn API
Giờ mặt trời mọc, lặn, giữa trưa, độ dài ngày, chạng vạng, giờ vàng và pha mặt trăng cho mọi tỉnh thành Việt Nam hoặc toạ độ bất kỳ, tối đa 31 ngày.
API giờ mặt trời tính cho một ngày: giờ mặt trời mọc và lặn, giữa trưa thực và độ cao mặt trời lúc đó, độ dài ban ngày, các mốc chạng vạng dân dụng, hàng hải và thiên văn, khung giờ vàng (mặt trời ở độ cao từ −4° đến +6°, ánh sáng dịu mà dân chụp ảnh săn đón), cùng pha mặt trăng bằng tiếng Việt và tiếng Anh, độ sáng và ngày trăng mới, trăng tròn tiếp theo.
Truyền tỉnh thành (province=hn, tên như Đà Nẵng, mã 2 số, hoặc trên đường dẫn /v1/sun-times/hcm) hoặc lat và lon bất kỳ. Giờ trả về theo giờ địa phương, mặc định UTC+7 (đổi bằng tz); days (tối đa 31) trả về chuỗi ngày bắt đầu từ date (mặc định: hôm nay theo giờ Việt Nam).
Mọi thứ được tính bằng công thức thiên văn của NOAA, sai số khoảng một phút, không phụ thuộc dịch vụ bên ngoài nên phản hồi tức thì. Ở vùng cực, sunrise là null khi mặt trời không mọc.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
province | path|query | string | không | Mã hoặc tên tỉnh (hn, hcm, Đà Nẵng, 48), qua ?province= hoặc trên đường dẫn. Bắt buộc nếu không có lat / lon. | |
lat | query | number | không | Vĩ độ (đi cùng lon). | |
lon | query | number | không | Kinh độ. | |
date | query | string | không | YYYY-MM-DD (mặc định: hôm nay theo giờ Việt Nam). | |
days | query | number | không | 1 | Số ngày (1–31); lớn hơn 1 thì trả về mảng days. |
tz | query | number | không | 7 | Múi giờ của kết quả (lệch so với UTC, tính bằng giờ). |
Ví dụ
curl "https://apibox.io.vn/v1/sun-times?province=Hà Nội&date=2026-11-11" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/sun-times?province=Hà Nội&date=2026-11-11', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/sun-times?province=Hà Nội&date=2026-11-11",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/sun-times?province=Hà Nội&date=2026-11-11');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"location": {
"lat": 21.0285,
"lon": 105.8542,
"province_code": "01",
"province": "Thành phố Hà Nội",
"location": "Hà Nội"
},
"timezone_offset": 7,
"date": "2026-11-11",
"sunrise": "06:04",
"sunset": "17:17",
"solar_noon": "11:40",
"day_length": "11h13",
"day_length_hours": 11.21,
"solar_noon_elevation": 51.7,
"civil_twilight": {
"dawn": "05:41",
"dusk": "17:40"
},
"nautical_twilight": {
"dawn": "05:14",
"dusk": "18:07"
},
"astronomical_twilight": {
"dawn": "04:48",
"dusk": "18:33"
},
"golden_hour": {
"morning": [
"05:50",
"06:35"
],
"evening": [
"16:46",
"17:31"
]
},
"moon": {
"phase_vi": "Trăng mới (sóc)",
"phase_en": "New moon",
"age_days": 1.5,
"illumination": 0.024,
"next_new_moon": "2026-12-09",
"next_full_moon": "2026-11-24"
},
"note": "Times in local time (UTC+7 by default), accurate to about one minute; golden hour = sun between −4° and +6°."
}
Ứng dụng
- Lên lịch chụp ảnh, quay phim vào giờ vàng
- Hẹn giờ đèn chiếu sáng, hệ thống điện mặt trời
- Sắp xếp lễ hội, sự kiện ngoài trời
- Hiển thị giờ mọc, lặn trong ứng dụng thời tiết, du lịch
Hỏi đáp
Độ chính xác thế nào?
Khoảng một phút; địa hình (núi, nhà cao tầng) không được tính đến.
Tính theo điểm nào của tỉnh?
Theo trung tâm hành chính của tỉnh; gửi lat và lon nếu cần đúng một địa điểm.
Lấy cả tháng được không?
Được, days=31 trả về 31 ngày bắt đầu từ date.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.