기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 위성의 현재 에페메리스 가져오기
[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 대해에서 사용 중인 현재 에페메리스를 검색할 수 있습니다. 이 두 메서드는 모두 현재 사용 중인 에페메리스에 대한 메타데이터를 반환합니다. 이 에페메리스 메타데이터는에 업로드된 사용자 지정 에페메리스 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`는 [스페이스 트랙](https://www.space-track.org/)에서 가져온 [두 줄 요소 세트](https://en.wikipedia.org/wiki/Two-line_element_set)의 [에포크](https://en.wikipedia.org/wiki/Epoch_(astronomy))이며, 현재 위성의 궤적을 계산하는 데 사용되고 있습니다.
사용자 지정 에페메리스는 `CUSTOMER_PROVIDED`의 `source` 값을 가지며 `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` 필드가 있으므로 쉽게 식별할 수 있습니다.