Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyediakan data ephemeris OEM
**penting**
API ephemeris saat ini dalam status Pratinjau
Akses ke API Ephemeris disediakan hanya sesuai kebutuhan. Jika Anda memerlukan kemampuan untuk mengunggah data ephemeris khusus, silakan buka AWS Dukungan tiket melalui. [AWS Support Center Console](https://console.aws.amazon.com/support) Tim kami akan bekerja dengan Anda untuk mengaktifkan kemampuan ini untuk kebutuhan spesifik Anda.
## Ikhtisar
Orbit Ephemeris Message (OEM) adalah format standar untuk mewakili data lintasan pesawat ruang angkasa. API Ephemeris memungkinkan ephemerides OEM diunggah untuk digunakan dengan satelit. AWS Ground Station [Ephemerides ini mengesampingkan ephemerides default dari Space-Track (lihat:).](https://www.space-track.org/) [Data ephemeris standar](default-ephemeris-data.md)
AWS Ground Station memperlakukan ephemerides sebagai Data Penggunaan [Individual](https://aws.amazon.com/service-terms). Jika Anda menggunakan fitur opsional ini, AWS akan menggunakan data ephemeris Anda untuk memberikan dukungan pemecahan masalah.
Mengunggah ephemerides OEM khusus dapat meningkatkan kualitas pelacakan, menangani operasi awal di mana tidak ada ephemerides [Space-Track](https://www.space-track.org/) yang tersedia, dan memperhitungkan manuver. AWS Ground Station
**catatan**
Saat memberikan ephemeris khusus sebelum nomor katalog satelit ditetapkan untuk satelit Anda, Anda dapat menggunakan `satelliteId` untuk `OBJECT_ID` bagian OEM.
Untuk informasi selengkapnya tentang format OEMs, lihat[Format ephemer OEM](#oem-ephemeris-format).
## Format ephemer OEM
AWS Ground Station memproses Ephemerides yang Disediakan Pelanggan OEM sesuai dengan [standar CCSDS](https://ccsds.org/Pubs/502x0b3e1.pdf) dengan beberapa batasan tambahan. File OEM harus dalam format KVN. Tabel berikut menguraikan bidang yang berbeda dalam OEM dan bagaimana AWS Ground Station perbedaannya dari standar CCSDS.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ground-station/latest/ug/providing-oem-ephemeris-data.html)
\$1 Jika ada baris yang tidak didukung oleh AWS Ground Station termasuk dalam OEM yang disediakan, OEM akan gagal validasi.
Penyimpangan penting dari standar CCSDS adalah: AWS Ground Station
+ `CCSDS_OEM_VERS`diperlukan untuk menjadi`2.0`.
+ `REF_FRAME`diperlukan untuk menjadi salah satu `EME2000` atau` ITRF2000`.
+ `REF_FRAME_EPOCH`tidak didukung oleh AWS Ground Station.
+ `CENTER_NAME`diperlukan untuk menjadi`Earth`.
+ `TIME_SYSTEM`diperlukan untuk menjadi`UTC`.
+ `INTERPOLATION`dan `INTERPOLATION_DEGREE` keduanya diperlukan untuk ephemeris yang disediakan AWS Ground Station pelanggan.
## Contoh OEM ephemeris dalam format KVN
Berikut ini adalah contoh terpotong dari ephemeris OEM dalam format KVN untuk satelit penyiar publik JPSS-1.
```
CCSDS_OEM_VERS = 2.0
COMMENT Orbit data are consistent with planetary ephemeris DE-430
CREATION_DATE = 2024-07-22T05:20:59
ORIGINATOR = Raytheon-JPSS/CGS
META_START
OBJECT_NAME = J1
OBJECT_ID = 2017-073A
CENTER_NAME = Earth
REF_FRAME = EME2000
TIME_SYSTEM = UTC
START_TIME = 2024-07-22T00:00:00.000000
STOP_TIME = 2024-07-22T00:06:00.000000
INTERPOLATION = Lagrange
INTERPOLATION_DEGREE = 5
META_STOP
2024-07-22T00:00:00.000000 5.905147360000000e+02 -1.860082793999999e+03 -6.944807075000000e+03 -5.784245796000000e+00 4.347501391999999e+00 -1.657256863000000e+00
2024-07-22T00:01:00.000000 2.425572045154201e+02 -1.595860765983339e+03 -7.030938457373539e+03 -5.810660250794190e+00 4.457103652219009e+00 -1.212889340333023e+00
2024-07-22T00:02:00.000000 -1.063224256538050e+02 -1.325569732497146e+03 -7.090262617183503e+03 -5.814973972202444e+00 4.549739160042560e+00 -7.639633689161465e-01
2024-07-22T00:03:00.000000 -4.547973959231161e+02 -1.050238305712201e+03 -7.122556683227951e+03 -5.797176562437553e+00 4.625064829516728e+00 -3.121687831090774e-01
2024-07-22T00:04:00.000000 -8.015427368657785e+02 -7.709137891269565e+02 -7.127699477194810e+03 -5.757338007808417e+00 4.682800822515077e+00 1.407953645161997e-01
2024-07-22T00:05:00.000000 -1.145240083085062e+03 -4.886583601179489e+02 -7.105671911254255e+03 -5.695608435738609e+00 4.722731329786999e+00 5.932259682105052e-01
2024-07-22T00:06:00.000000 -1.484582479061495e+03 -2.045451985605701e+02 -7.056557069672793e+03 -5.612218005854990e+00 4.744705579872771e+00 1.043421397392599e+00
```
## Membuat ephemeris OEM
Ephemeris OEM dapat dibuat menggunakan [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)tindakan di API. AWS Ground Station Tindakan ini akan mengunggah ephemeris menggunakan data baik di badan permintaan atau dari bucket S3 yang ditentukan.
Penting untuk dicatat bahwa mengunggah ephemeris menyetel ephemeris ` VALIDATING` dan memulai alur kerja asinkron yang akan memvalidasi dan menghasilkan kontak potensial dari ephemeris Anda. Hanya setelah ephemeris melewati alur kerja ini dan menjadi `ENABLED` akan digunakan untuk kontak. Anda harus melakukan polling [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)untuk status ephemeris atau menggunakan CloudWatch peristiwa untuk melacak perubahan status ephemeris.
Untuk memecahkan masalah ephemeris yang tidak valid, lihat: [Memecahkan masalah ephemerides yang tidak valid](troubleshooting-invalid-ephemerides.md)
## Contoh: Mengunggah data ephemeris OEM dari bucket S3
Dimungkinkan juga untuk mengunggah file ephemeris OEM langsung dari bucket S3 dengan menunjuk ke bucket dan kunci objek. AWS Ground Station akan mengambil objek atas nama Anda. Informasi tentang enkripsi data saat istirahat AWS Ground Station dirinci dalam:[Enkripsi data saat istirahat untuk AWS Ground Station](security.encryption-at-rest.md).
Di bawah ini adalah contoh mengunggah file ephemeris OEM dari bucket S3
```
import boto3
from datetime import datetime, timedelta, timezone
# Create AWS clients
s3_client = boto3.client("s3")
ground_station_client = boto3.client("groundstation")
# Define S3 bucket and key
bucket_name = "ephemeris-bucket"
object_key = "test_data.oem"
# Create sample OEM data in KVN format
oem_data = """CCSDS_OEM_VERS = 2.0
COMMENT Orbit data are consistent with planetary ephemeris DE-430
CREATION_DATE = 2024-07-22T05:20:59
ORIGINATOR = Raytheon-JPSS/CGS
META_START
OBJECT_NAME = J1
OBJECT_ID = 2017-073A
CENTER_NAME = Earth
REF_FRAME = EME2000
TIME_SYSTEM = UTC
START_TIME = 2024-07-22T00:00:00.000000
STOP_TIME = 2024-07-22T00:06:00.000000
INTERPOLATION = Lagrange
INTERPOLATION_DEGREE = 5
META_STOP
2024-07-22T00:00:00.000000 5.905147360000000e+02 -1.860082793999999e+03 -6.944807075000000e+03 -5.784245796000000e+00 4.347501391999999e+00 -1.657256863000000e+00
2024-07-22T00:01:00.000000 2.425572045154201e+02 -1.595860765983339e+03 -7.030938457373539e+03 -5.810660250794190e+00 4.457103652219009e+00 -1.212889340333023e+00
2024-07-22T00:02:00.000000 -1.063224256538050e+02 -1.325569732497146e+03 -7.090262617183503e+03 -5.814973972202444e+00 4.549739160042560e+00 -7.639633689161465e-01
2024-07-22T00:03:00.000000 -4.547973959231161e+02 -1.050238305712201e+03 -7.122556683227951e+03 -5.797176562437553e+00 4.625064829516728e+00 -3.121687831090774e-01
2024-07-22T00:04:00.000000 -8.015427368657785e+02 -7.709137891269565e+02 -7.127699477194810e+03 -5.757338007808417e+00 4.682800822515077e+00 1.407953645161997e-01
2024-07-22T00:05:00.000000 -1.145240083085062e+03 -4.886583601179489e+02 -7.105671911254255e+03 -5.695608435738609e+00 4.722731329786999e+00 5.932259682105052e-01
2024-07-22T00:06:00.000000 -1.484582479061495e+03 -2.045451985605701e+02 -7.056557069672793e+03 -5.612218005854990e+00 4.744705579872771e+00 1.043421397392599e+00
"""
# Upload sample OEM data to S3
print(f"Uploading OEM data to s3://{bucket_name}/{object_key}")
s3_client.put_object(
Bucket=bucket_name, Key=object_key, Body=oem_data, ContentType="text/plain"
)
print("OEM data uploaded successfully to S3")
# Create OEM ephemeris from S3
print("Creating OEM ephemeris from S3...")
s3_oem_ephemeris = ground_station_client.create_ephemeris(
name="2024-07-22 S3 OEM Upload",
satelliteId="fde41049-14f7-413e-bd7b-EXAMPLE01",
enabled=True,
expirationTime=datetime.now(timezone.utc) + timedelta(days=5),
priority=2,
ephemeris={"oem": {"s3Object": {"bucket": bucket_name, "key": object_key}}},
)
print(f"Created OEM ephemeris with ID: {s3_oem_ephemeris['ephemerisId']}")
```
Di bawah ini adalah contoh data yang dikembalikan dari [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)tindakan yang dipanggil untuk ephemeris OEM yang diunggah di blok kode contoh sebelumnya.
```
{
"creationTime": 1620254718.765,
"enabled": true,
"name": "Example Ephemeris",
"ephemerisId": "fde41049-14f7-413e-bd7b-EXAMPLE02",
"priority": 2,
"status": "VALIDATING",
"suppliedData": {
"oem": {
"sourceS3Object": {
"bucket": "ephemeris-bucket-for-testing",
"key": "test_data.oem"
}
}
}
}
```