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.

GEThttps://apibox.io.vn/v1/sun-times
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
provincepath|querystringkhôngMã 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.
latquerynumberkhôngVĩ độ (đi cùng lon).
lonquerynumberkhôngKinh độ.
datequerystringkhôngYYYY-MM-DD (mặc định: hôm nay theo giờ Việt Nam).
daysquerynumberkhông1Số ngày (1–31); lớn hơn 1 thì trả về mảng days.
tzquerynumberkhông7Mú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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →