翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# OEM エフェメリスデータを提供する
**重要**
エフェメリス API は現在プレビュー状態です。
エフェメリス API へのアクセスは、必要な場合にのみ提供されます。カスタムエフェメリスデータをアップロードする必要がある場合は、 を通じて AWS サポート チケットを開いてください[AWS Support Center Console](https://console.aws.amazon.com/support)。当社のチームがお客様と協力して、特定の要件に応じてこの機能を有効にします。
## 概要:
軌道エフェメリスメッセージ (OEM) は、宇宙機の軌道データを表すための標準化された形式です。Ephemeris API を使用すると、OEM エフェメリスを にアップロード AWS Ground Station して衛星で使用できます。これらのエフェメリスは、[Space-Track](https://www.space-track.org/) からのデフォルトのエフェメリスを上書きします (「」を参照[デフォルトのエフェメリスデータ](default-ephemeris-data.md))。
AWS Ground Station はエフェメリスを[個別の使用状況データ](https://aws.amazon.com/service-terms)として扱います。このオプション機能を使用する場合、 AWS はエフェメリスデータを使用してトラブルシューティングサポートを提供します。
カスタム OEM エフェメリスをアップロードすると、追跡の品質が向上し、[Space-Track](https://www.space-track.org/) エフェメリスが利用できない早期オペレーションを処理し AWS Ground Station、操作を考慮できます。
**注記**
衛星に衛星カタログ番号が割り当てられる前にカスタムエフェメリスを提供する場合、OEM の `satelliteId` `OBJECT_ID` 部分に を使用できます。
OEMs「」を参照してください[OEM エフェメリス形式](#oem-ephemeris-format)。
## OEM エフェメリス形式
AWS Ground Station は、[CCSDS 標準](https://ccsds.org/Pubs/502x0b3e1.pdf)に従って OEM カスタマー提供のエフェメリスを処理しますが、追加の制限があります。OEM ファイルは KVN 形式である必要があります。次の表は、OEM のさまざまなフィールドと、 と CCSDS 標準 AWS Ground Station の違いの概要を示しています。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ground-station/latest/ug/providing-oem-ephemeris-data.html)
\$1 でサポートされていない行 AWS Ground Station が提供された OEM に含まれている場合、OEM は検証に失敗します。
の CCSDS 標準からの重要な逸脱 AWS Ground Station は次のとおりです。
+ `CCSDS_OEM_VERS` は である必要があります`2.0`。
+ `REF_FRAME` は、 `EME2000` または のいずれかである必要があります` ITRF2000`。
+ `REF_FRAME_EPOCH` は ではサポートされていません AWS Ground Station。
+ `CENTER_NAME` は である必要があります`Earth`。
+ `TIME_SYSTEM` は である必要があります`UTC`。
+ `INTERPOLATION` と `INTERPOLATION_DEGREE`はどちらも、 AWS Ground Station お客様が提供したエフェメリスに必要です。
## KVN 形式の OEM エフェメリスの例
以下は、JPSS-1 パブリックブロードキャスター衛星の KVN 形式の OEM エフェメリスの切り捨てられた例です。
```
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
```
## OEM エフェメリスの作成
OEM エフェメリスは、 API の [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) アクション AWS Ground Station を使用して作成できます。このアクションによって、リクエスト本文または指定された S3 バケットのデータを使用してエフェメリスがアップロードされます。
エフェメリスがアップロードされると、エフェメリスが ` VALIDATING` に設定されて非同期ワークフローが開始されることに注意してください。このワークフローでは、エフェメリスを検証し、そのエフェメリスを基に潜在的なコンタクトを生成します。エフェメリスは、このワークフローを実施して `ENABLED` になって初めて、コンタクトに使用されます。[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) をポーリングしてエフェメリスステータスを確認するか、CloudWatch イベントを使用してエフェメリスのステータスの変化を追跡する必要があります。
無効なエフェメリスのトラブルシューティングについては、以下を参照してください。 [無効なエフェメリスのトラブルシューティング](troubleshooting-invalid-ephemerides.md)
## 例: S3 バケットから OEM エフェメリスデータをアップロードする
バケットとオブジェクトキーを指すことで、S3 バケットから直接 OEM エフェメリスファイルをアップロードすることもできます。 AWS Ground Station はユーザーに代わってオブジェクトを取得します。の保管中のデータの暗号化の詳細については AWS Ground Station 、「」を参照してください[の保管中のデータ暗号化 AWS Ground Station](security.encryption-at-rest.md)。
以下は、S3 バケットから OEM エフェメリスファイルをアップロードする例です。
```
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']}")
```
以下は、サンプルコードの前のブロックでアップロードされた OEM エフェメリスに対して呼び出される [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) アクションから返されたデータの例です。
```
{
"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"
}
}
}
}
```