翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 衛星の現在のエフェメリスを取得する
特定の衛星 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) アクションを呼び出すことで取得できます。これらのメソッドはいずれも、現在使用中のエフェメリスのメタデータを返します。このエフェメリスメタデータは、 にアップロードされたカスタムエフェメリス 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) によって返されません。方位高度エフェメリスに関する情報を取得するには、特定のエフェメリス 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` は、[Space-Track](https://www.space-track.org/) からプルされた [2 行要素セット](https://en.wikipedia.org/wiki/Two-line_element_set)の[エポック](https://en.wikipedia.org/wiki/Epoch_(astronomy))であり、現在衛星の軌道の計算に使用されています。
カスタムエフェメリスは、`source` 値が `CUSTOMER_PROVIDED` となり、`ephemerisId` フィールドには一意の識別子が含まれます。この一意の識別子は、[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) アクションを介してエフェメリスをクエリするために使用できます。[CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) アクション AWS Ground Station を介して へのアップロード中にエフェメリスに名前が割り当てられた場合、オプションの `name`フィールドが返されます。
エフェメリスは によって動的に更新 AWS Ground Station されるため、返されるデータは API の呼び出し時に使用されているエフェメリスのスナップショットにすぎません。
## デフォルトのエフェメリスを使用した衛星の [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) リターンの例
```
{
"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) の例
```
{
"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"
}
}
```
## 方位高度エフェメリスの一覧表示
方位高度エフェメリスは衛星に関連付けられていないため、異なる APIs を使用してそれらに関する情報を検出および取得する必要があります。
1. [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html) を使用して、方位高度エフェメリスを含む、アカウント内のすべてのエフェメリスを一覧表示します。ステータスとエフェメリスタイプでフィルタリングできます。
1. 特定のエフェメリス ID で [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) を使用して、方位高度エフェメリスに関する詳細情報を取得します。
1. 特定の問い合わせ ID で [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html) を使用して、問い合わせに使用されるエフェメリスに関する詳細情報を取得します。
方位高度エフェメリスを含む [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` フィールドがあるため、識別が容易になります。