## 引言

如果你想知道準確的月出月落時間，又或者你想設計一個月出月落時間查詢的應用，又或者你只是好奇點進來了，還是可以過來圍觀一下漲漲知識，今天想跟大家聊一聊的是月出月落的計算方法以及替代工具 - 月出月落和月相 API 。

月出月落和月相 API 是一種可以獲取指定城市或地點每日月出時間、月落時間、月相、受照佔比、月相相位角、下一個新月時間、下一個滿月時間等資料的介面。該 API 基於全球月出月落計算公式和高精度天文演算法，可以為使用者提供準確的月出月落時間資料，覆蓋全球3400+個城市和4萬個地點。

![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/a5fa7232013b40758bc75a4acef4bc20~tplv-k3u1fbpfcp-zoom-1.image)

## 月出月落的計算方法

月出月落時間的計算涉及到地球的自轉、公轉、地球的形狀、大氣折射等多個因素，因此需要使用天文學公式和計算方法。以下是一些常用的計算方法：

1. 基於經緯度的簡單方法：根據觀測地點的經緯度和日期，透過經驗公式計算出月出月落的大致時間。這種方法的精度較低，只能提供一個大致的參考時間。

月出時間 = 當天日出時間 + arccos(-sin(φ)×sin(δ)÷cos(φ)×cos(δ))÷15

月落時間 = 當天日落時間 - arccos(-sin(φ)×sin(δ)÷cos(φ)×cos(δ))÷15

其中，φ表示所在緯度，δ表示月亮赤緯，arccos為反餘弦函式，15表示每小時移動15度（地球自轉速度）。

需要注意的是，這個公式只是一個簡單的近似計算公式，實際月出月落時間還會受到多種因素的影響，如地球自轉速度變化、地形、氣象條件等等，因此計算結果可能存在一定誤差。

2. 天文學方法：利用天文學知識和計算方法，可以更加準確地計算出月出月落的時間。這種方法需要使用天文學軟體或者資料表格進行計算。

月出時間 = 日落時刻 + arccos[(sin(h) - sin(δ) * sin(φ)) / (cos(δ) * cos(φ))] 月落時間 = 日出時刻 + arccos[(sin(h) - sin(δ) * sin(φ)) / (cos(δ) * cos(φ))]

其中，h為天文黃赤交角，δ為月球的赤緯，φ為觀測地點的緯度。

3. 基於觀測地點的方法：這種方法需要測量觀測地點的海拔高度、天文觀測點的經度和緯度等引數，並結合當前時間和日期，計算出月亮的出入時間。

具體的計算方法和公式較為複雜，需要藉助計算機程式實現。

在實際應用中，常用的方法是天文學方法，除此之外可以透過天文學軟體、網站等工具進行計算。例如，可以使用月出月落和月相 API ，輸入城市編碼引數，就可以得到相應的結果。

## 月出月落和月相 API 的工作原理

月出月落和月相的 API 的工作原理通常是基於天文演算法和日曆計算，透過收集和處理與天文資料相關的資訊，計算出具體時間和位置的月出月落和月相。

具體地說，月出月落的 API 通常需要輸入使用者所在的經緯度和日期，然後透過天文演算法計算出太陽和月亮的位置和運動軌跡，進而推算出在這個地點和日期的月出月落時間，並且根據月球的運動軌跡和相位計算出指定日期的月相狀態，例如滿月、新月、上弦月或下弦月。

## 應用場景

月出月落和月相 API 可以廣泛應用於多個領域，包括氣象學應用、天文學應用、攝影、旅遊等

![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/f0078034088240bb86c48b016cef29ae~tplv-k3u1fbpfcp-zoom-1.image)

## 常用月出月落和月相 API推薦

以下是我推薦的幾個月出月落和月相 API：

#### 1.APISpace 月出月落和月相 API

**簡介：** [APISpace 月出月落和月相 API](https://www.apispace.com/eolink/api/3244/introduction?utm_source=itpub&utm_content=deep&utm_term=yuexiang)支援國內3400+個城市以及國際4萬個城市的月出月落和月相資料，每日月出時間、月落時間、月相、受照佔比、月相相位角、下一個新月時間、下一個滿月時間等資料。

**接入方式：** 很簡單三個步驟即可完成了，有不明白的小夥伴可以評論區交流~

![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/3c39491ac9a8478fadcb12243d63af70~tplv-k3u1fbpfcp-zoom-1.image)

**Java 接入程式碼：**

```
OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/3244/lives_geo/v001/moon?days=1&areacode=101010100")
  .method("GET",null)
  .addHeader("X-APISpace-Token","")
  .addHeader("Authorization-Type","apikey")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());
```

**返回示例：**

```
{
    "status": 0,
    "result": {
        "location": {
            "areacode": "101010100",        //城市ID
            "name": "北京",                //城市中文名
            "country": "中國",                //所屬國家中文名
            "path": "北京,北京市,北京市,中國"            //行政區劃路徑
        },
        "moon": [
            {
                "date": "2020-04-26",                //日期
                "moonrise": "17:58:23",        //月出時間，有時為空
                "moonset": "06:12:22",        //月落時間，有時為空
                "phaseAngle": 178.56,        //0時月相相位角，單位°
                "percent": 98.75,                //0時受照佔比，單位100%
                "phase": "Full",            //月相英文
                "phaseCn": "滿月",                //月相
                "phaseCode": 17,            //對應圖片程式碼
            },
                    ……            //其它日期月相資訊
         ]
        "full": [                //查詢時段內的所有滿月時間，沒有滿月則為空
                "2020-04-26 17:58:23",
                ……
         ]
        "new": [                //查詢時段內的所有新月時間，沒有新月則為空
                "2020-04-26 17:58:23",
                ……
         ]
    }
}
```

#### 2. Sunrise-Sunset API

提供世界各地的月出月落時間，包括民用和航空月出月落時間

#### 3. OpenWeatherMap API

提供實時天氣資訊，包括月出月落時間和月相資訊。

淺談月出月落和月相的計算方法以及替代工具 - 月出月落和月相 API

相關文章