Menyediakan data ephemeris khusus

penting

Ephemeris saat API ini dalam status Pratinjau

Akses ke API Ephemeris disediakan hanya sesuai kebutuhan. <Jika Anda memerlukan kemampuan untuk mengunggah data ephemeris khusus, Anda harus menghubungi [e-mail].>

Gambaran Umum

Ephemeris API memungkinkan ephemerides khusus untuk diunggah untuk digunakan dengan satelit. AWS Ground Station Ephemerides ini mengesampingkan ephemerides default dari Space-Track (lihat:). Data ephemeris standar Kami mendukung penerimaan data ephemeris dalam format Orbit Ephemeris Message (OEM), dan elemen dua baris (). TLE

Mengunggah ephemerides khusus dapat meningkatkan kualitas pelacakan, menangani operasi awal di mana tidak ada ephemerides Space-Track yang tersedia, dan memperhitungkan manuver. AWS Ground Station

penting

Saat ini, set elemen dua baris (TLE) adalah satu-satunya jenis ephemeris yang didukung untuk satelit tanpa ID yang ditetapkan NORAD (nomor katalog satelit).

Saat memberikan ephemeris khusus sebelum nomor katalog satelit ditetapkan untuk satelit Anda, Anda dapat menggunakan 00000 untuk bidang nomor katalog satelitTLE, dan 000 untuk bagian nomor peluncuran bidang penunjuk internasional (misalnya 24000A untuk kendaraan yang diluncurkan pada tahun 2024). Untuk informasi selengkapnya tentang formatTLEs, lihat Kumpulan elemen dua baris.

Membuat ephemeris khusus

Ephemeris khusus dapat dibuat menggunakan CreateEphemerisaksi di. AWS Ground Station API 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 DescribeEphemerisuntuk status ephemeris atau menggunakan CloudWatch peristiwa untuk melacak perubahan status ephemeris.

Untuk memecahkan masalah ephemeris yang tidak valid, lihat: Memecahkan masalah ephemerides tidak valid

Contoh: Buat elemen dua baris (TLE) set ephemeris via API

The AWS SDKs, dan CLI dapat digunakan untuk mengunggah elemen dua baris (TLE) mengatur ephemeris AWS Ground Station melalui panggilan. CreateEphemeris Ephemeris ini akan digunakan sebagai pengganti data ephemeris default untuk satelit (lihat Data Ephemeris Default). Contoh ini menunjukkan bagaimana melakukan ini menggunakan AWS SDKuntuk Python (Boto3).

TLESet adalah objek yang JSON diformat yang merangkai satu atau lebih TLEs bersama-sama untuk membangun lintasan kontinu. TLEsDalam TLE himpunan harus membentuk himpunan kontinu yang dapat kita gunakan untuk membangun lintasan (yaitu tidak ada celah waktu antara TLEs dalam satu set). TLE Contoh TLE set ditunjukkan di bawah ini:

# example_tle_set.json
[
    {
        "tleLine1": "1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997",
        "tleLine2": "2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906",
        "validTimeRange": {
            "startTime": 12345,
            "endTime": 12346
        }
    },
    {
        "tleLine1": "1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997",
        "tleLine2": "2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906",
        "validTimeRange": {
            "startTime": 12346,
            "endTime": 12347
        }
    }
]

catatan

Rentang waktu TLEs dalam TLE satu set harus sama persis untuk menjadi lintasan yang valid dan berkelanjutan.

Satu TLE set dapat diunggah melalui klien AWS Ground Station boto3 sebagai berikut:

tle_ephemeris_id = ground_station_boto3_client.create_ephemeris( name="Example Ephemeris", satelliteId="2e925701-9485-4644-b031-EXAMPLE01", enabled=True, expirationTime=datetime.now(timezone.utc) + timedelta(days=3), priority=2,
    ephemeris = {
      "tle": {
        "tleData": [
            {
                "tleLine1": "1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997",
                "tleLine2": "2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906",
                "validTimeRange": {
                    "startTime": datetime.now(timezone.utc),
                    "endTime": datetime.now(timezone.utc) + timedelta(days=7)
                }
            }
        ]
      }
    })

Panggilan ini akan mengembalikan sebuah ephemerisId yang dapat digunakan untuk referensi ephemeris di masa depan. Misalnya, kita dapat menggunakan yang disediakan ephemerisId dari panggilan di atas untuk polling untuk status ephemeris:

client.describe_ephemeris(ephemerisId=tle_ephemeris_id['ephemerisId'])

Contoh respons dari DescribeEphemeristindakan disediakan di bawah ini

{
  "creationTime": 1620254718.765,
  "enabled": true,
  "name": "Example Ephemeris",
  "ephemerisId": "fde41049-14f7-413e-bd7b-EXAMPLE01",
  "priority": 2,
  "status": "VALIDATING",
  "suppliedData": {
    "tle": {
      "ephemerisData": "[{\"tleLine1\": \"1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997\",\"tleLine2": \"2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906\",\"validTimeRange\": {\"startTime\": 1620254712000,\"endTime\": 1620859512000}}]"
    }
  }
}

Disarankan untuk melakukan polling DescribeEphemerisrute atau menggunakan CloudWatch peristiwa untuk melacak status ephemeris yang diunggah karena harus melalui alur kerja validasi asinkron sebelum disetel ke dan menjadi dapat digunakan untuk ENABLED menjadwalkan dan mengeksekusi kontak.

Perhatikan bahwa NORAD ID di semua TLE set, TLEs dalam contoh 25994 di atas, harus cocok dengan NORAD ID satelit Anda telah ditetapkan dalam database Space-Track.

Contoh: Mengunggah data Ephemeris dari bucket S3

Dimungkinkan juga untuk mengunggah file ephemeris 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

Di bawah ini adalah contoh mengunggah file OEM ephemeris dari bucket S3

s3_oem_ephemeris_id = ground_station_client.create_ephemeris( name="2022-10-26 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": "ephemeris-bucket-for-testing",
                "key": "test_data.oem",
            }
        }
    })

Di bawah ini adalah contoh data yang dikembalikan dari DescribeEphemeristindakan yang dipanggil untuk OEM ephemeris 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"
      }
    }
  }
}