本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 获取卫星的当前星历
<a name="getting-current-ephemeris"></a>

 可以通过调用或操作来检索 AWS Ground Station 特定卫星当前使用的星历表。[GetSatellite[ListSatellites](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListSatellites.html)](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html)这两种方法都将返回当前使用的星历的元数据。上传到默认星历表的自定义星历表和默认星历表的星历表元数据有所不同。 AWS Ground Station 

**注意**  
 方位角高程星历表与卫星无关，因此不由或返回。[GetSatellite[ListSatellites](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListSatellites.html)](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html)要检索有关方位角高程星历表的信息，请使用带有特定星历表 ID [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)的 API，或者使用[ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)查看您账户的所有可用星历表。

 默认星历将仅包含 `source` 和 `epoch` 字段。`epoch`这是从 Sp [ace-Track 中提取的[双线元素集](https://en.wikipedia.org/wiki/Two-line_element_set)[的时代](https://en.wikipedia.org/wiki/Epoch_(astronomy))，它目前正用于计算卫星](https://www.space-track.org/)的轨迹。

 自定义星历的 `CUSTOMER_PROVIDED` 为 `source` 值，且在 `ephemerisId` 字段中包含唯一标识符。此唯一标识符可用于通过 [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) 操作查询星历。如果在上传时 AWS Ground Station 通过操作为星历分配了名称，则会返回一个可选字`name`段。[CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)

 值得注意的是，星历表是通过动态更新的， AWS Ground Station 因此返回的数据只是调用 API 时使用的星历的快照。

## 使用默认星历的卫星示例返回 [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html)
<a name="w2aac28c23c13"></a>

```
{
    "satelliteId": "e1cfe0c7-67f9-4d98-bad2-EXAMPLE",
    "satelliteArn": "arn:aws:groundstation::111122223333:satellite/e1cfe0c7-67f9-4d98-bad2-EXAMPLE",
    "noradSatelliteID": 25994,
    "groundStations": [
        "Ohio 1",
        "Oregon 1"
    ],
    "currentEphemeris": {
        "source": "SPACE_TRACK",
        "epoch": 1528245583.619
    }
}
```

## 使用自定义星历的卫星示例 [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html)
<a name="w2aac28c23c15"></a>

```
{
      "satelliteId": "e1cfe0c7-67f9-4d98-bad2-EXAMPLE",
      "satelliteArn": "arn:aws:groundstation::111122223333:satellite/e1cfe0c7-67f9-4d98-bad2-EXAMPLE",
      "noradSatelliteID": 25994,
      "groundStations": [
            "Ohio 1",
            "Oregon 1"
      ],
      "currentEphemeris": {
          "source": "CUSTOMER_PROVIDED",
          "ephemerisId": "e1cfe0c7-67f9-4d98-bad2-EXAMPLE",
          "name": "My Ephemeris"
      }
  }
```

## 列出方位角仰角星历表
<a name="w2aac28c23c17"></a>

 由于方位角高程星历表与卫星无关，因此您需要使用不同的星历 APIs 来发现和检索有关它们的信息：

1. 用于列[ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)出您账户中的所有星历，包括方位角高程星历。您可以按状态和星历类型进行筛选。

1. [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)与特定的星历表 ID 一起使用可获取有关方位角高程星历的详细信息。

1. [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)与特定的联系人 ID 配合使用，可获取有关用于联系人的星历的详细信息。

 包含方位角高程星历的[ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)响应示例：

```
{
    "ephemerides": [
        {
            "ephemerisId": "abc12345-6789-def0-1234-5678EXAMPLE",
            "ephemerisType": "AZ_EL",
            "name": "Azimuth Elevation for Ohio Ground Station",
            "status": "ENABLED",
            "creationTime": 1620254718.765
        },
        {
            "ephemerisId": "def45678-9012-abc3-4567-8901EXAMPLE",
            "ephemerisType": "TLE",
            "name": "TLE for Satellite 12345",
            "status": "ENABLED",
            "creationTime": 1620254700.123
        }
    ]
}
```

**注意**  
 在[ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)响应中，方位角高程星历表将使用`groundStation`场而不是字`satelliteId`段，因此易于识别。