本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 取得衛星的目前暫時性變化
<a name="getting-current-ephemeris"></a>

 透過呼叫 [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) 或 [ListSatellites](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListSatellites.html) 動作，可以擷取目前由 AWS Ground Station 用於特定衛星的暫時性。這兩種方法都會傳回目前使用中 ephemeris 的中繼資料。此暫時性中繼資料對於上傳至 的自訂暫時性中繼資料 AWS Ground Station 和預設暫時性中繼資料不同。

**注意**  
 方位浮水印不會與衛星相關聯，因此 [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) 或 [ListSatellites](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListSatellites.html) 不會傳回。若要擷取方位角海拔半合子的相關資訊，請使用 [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) API 搭配特定半合子 ID，或使用 [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html) 查看您帳戶的所有可用半合子。

 預設對等詞只會包含 `source`和 `epoch` 欄位。`epoch` 是從 [Space-Track](https://www.space-track.org/) 提取的[雙行元素集](https://en.wikipedia.org/wiki/Two-line_element_set)的 [epoch](https://en.wikipedia.org/wiki/Epoch_(astronomy))，目前正在用於運算衛星的軌跡。

 自訂 ephemeris `source`的值為 ，`CUSTOMER_PROVIDED`並在 `ephemerisId` 欄位中包含唯一識別符。此唯一識別符可用於透過 [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) 動作查詢 ephemeris。如果在 AWS Ground Station 透過 [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) 動作上傳至 期間為 ephemeris 指派名稱，則會傳回選用`name`欄位。

 請務必注意，暫時性資料是由 動態更新， AWS Ground Station 因此傳回的資料只是呼叫 API 時正在使用暫時性資料的快照。

## 使用預設 ephemeris 的衛星 [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
    }
}
```

## 使用自訂 ephemeris 的衛星 [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) 搭配特定 ephemeris ID 來取得方位海拔 ephemeris 的詳細資訊。

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` 欄位，使其易於識別。