API名称：月出月落和月相
支持国内3400+个城市以及国际4万个城市的月出月落和月相数据，每日月出时间、月落时间、月相、受照占比、月相相位角、下一个新月时间、下一个满月时间等数据。
该产品拥有以下 APIs：
1.月出月落和月相
2.城市搜索（支持国内、国外城市）
注意：该示例代码适用于 www.apispace.com 网站下 API，使用该产品前，您需要通过以下链接订阅服务：https://www.apispace.com/eolink/api/3244/api/
### APISpace_月出月落和月相_API接口_PHP调用示例代码知识点解析
#### 一、API概述
**APISpace**是一个中立的API社区平台，旨在为开发者提供一个查找、开放、购买、测试及使用的API平台。其中，“月出月落和月相”API是一个专门用于获取全球范围内城市月出月落时间和月相数据的服务。
#### 二、API功能介绍
##### 1. 月出月落和月相
此API能够提供包括但不限于以下数据：
- **每日月出时间**：指月亮升起的时间。
- **月落时间**：指月亮落下的时间。
- **月相**：当前月亮所处的阶段，例如新月、上弦月、满月、下弦月等。
- **受照占比**：指月亮被太阳照射部分与整个可见表面的比例。
- **月相相位角**：表示月球相对于地球和太阳的位置，通常用来精确描述月相的变化。
- **下一个新月时间**：指接下来出现新月的时间。
- **下一个满月时间**：指接下来出现满月的时间。
此API支持国内3400+个城市以及国际上的4万个城市的数据查询，覆盖范围广泛。
##### 2. 城市搜索
该API支持国内外城市的搜索功能，可以按照特定条件筛选城市数据，比如按名称模糊匹配、地理位置等。通过该API，用户可以轻松地获取到所需的城市信息。
#### 三、API使用方法
##### 1. 月出月落和月相调用示例
```php
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://eolink.o.apispace.com/3244/lives_geo/v001/moon?days=1&areacode=101010100",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_POSTFIELDS => "",
CURLOPT_HTTPHEADER => array(
"X-APISpace-Token: YOUR_API_TOKEN",
"Authorization-Type:apikey"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
```
**注意事项**：
- 需要在`CURLOPT_HTTPHEADER`数组中的`"X-APISpace-Token"`后添加自己的API密钥。
- `areacode`参数用于指定查询的城市编码，此处以北京为例。
- `days`参数表示获取未来多少天内的月相数据，默认值为1。
##### 2. 城市搜索（支持国内、国外城市）调用示例
```php
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://eolink.o.apispace.com/3244/function/v001/city?location=bei&items=10&area=china&language=&withTz=&withPoi=false",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_POSTFIELDS => "",
CURLOPT_HTTPHEADER => array(
"X-APISpace-Token: YOUR_API_TOKEN",
"Authorization-Type:apikey"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
```
**注意事项**：
- 同样需要在`CURLOPT_HTTPHEADER`数组中的`"X-APISpace-Token"`后添加自己的API密钥。
- `location`参数用于输入关键词搜索城市，如“bei”会搜索包含“bei”的城市名。
- `items`参数表示返回结果的数量，此处设置为10个。
- `area`参数用于指定搜索范围，`china`表示仅在中国范围内搜索。
#### 四、API订阅与使用流程
为了使用上述API，首先需要访问APISpace官方网站并注册账号。然后，通过链接订阅服务：
```
https://www.apispace.com/eolink/api/3244/api/
```
订阅成功后，可以获得API密钥，用于后续调用API时的身份验证。
#### 五、小结
本文详细介绍了APISpace提供的“月出月落和月相”API的功能特点及使用方法，并提供了具体的PHP调用示例代码。通过这些API，开发者可以方便地集成月相及城市数据查询功能到自己的应用程序中，满足不同场景下的需求。
