Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Proporcione datos de efemérides OEM
**importante**
La API de efemérides se encuentra actualmente en estado de previsualización.
El acceso a la API de Efemérides solo se proporciona en función de las necesidades. Si necesita poder cargar datos de efemérides personalizados, abra un AWS Support ticket a través del. [AWS Support Center Console](https://console.aws.amazon.com/support) Nuestro equipo trabajará con usted para habilitar esta capacidad para sus requisitos específicos.
## Descripción general de
El mensaje de efemérides en órbita (OEM) es un formato estandarizado para representar los datos de trayectoria de las naves espaciales. La API de efemérides permite cargar efemérides OEM para usarlas con un satélite. AWS Ground Station [Estas efemérides anulan las efemérides predeterminadas de Space-Track (consulte:).](https://www.space-track.org/) [Datos de efemérides predeterminados](default-ephemeris-data.md)
AWS Ground Station trata [las efemérides como datos](https://aws.amazon.com/service-terms) de uso individualizados. Si utiliza esta función opcional, AWS utilizará sus datos de efemérides para proporcionar asistencia en la resolución de problemas.
La carga de efemérides OEM personalizadas permite mejorar la calidad del seguimiento, gestionar las primeras operaciones en las que no se dispone de efemérides de [Space-Track](https://www.space-track.org/) y tener en cuenta las maniobras. AWS Ground Station
**nota**
Al proporcionar efemérides personalizadas antes de asignar un número de catálogo de satélites al satélite, puede utilizarlas para la parte del OEM. `satelliteId` `OBJECT_ID`
Para obtener más información sobre el formato de OEMs, consulte. [Formato de efemérides OEM](#oem-ephemeris-format)
## Formato de efemérides OEM
AWS Ground Station procesa las efemérides OEM proporcionadas por el cliente de acuerdo con el estándar [CCSDS](https://ccsds.org/Pubs/502x0b3e1.pdf) con algunas restricciones adicionales. Los archivos OEM deben estar en formato KVN. La siguiente tabla describe los diferentes campos de un OEM y en qué AWS Ground Station se diferencian del estándar CCSDS.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/ground-station/latest/ug/providing-oem-ephemeris-data.html)
\$1 Si en el OEM proporcionado AWS Ground Station se incluye alguna fila que no sea compatible, el OEM no pasará la validación.
Las desviaciones importantes con respecto al estándar de la CCSDS son las AWS Ground Station siguientes:
+ `CCSDS_OEM_VERS`se requiere que sea. `2.0`
+ `REF_FRAME`se requiere que sea uno `EME2000` de los dos` ITRF2000`.
+ `REF_FRAME_EPOCH`no es compatible con AWS Ground Station.
+ `CENTER_NAME`se requiere que lo sea`Earth`.
+ `TIME_SYSTEM`se requiere que lo sea`UTC`.
+ `INTERPOLATION`y ambos `INTERPOLATION_DEGREE` son obligatorios para las efemérides proporcionadas por el AWS Ground Station cliente.
## Ejemplo de efemérides OEM en formato KVN
A continuación se presenta un ejemplo truncado de una efeméride OEM en formato KVN para el satélite de radiodifusión pública 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
```
## Creación de una efeméride OEM
Se puede crear una efeméride OEM mediante la [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)acción de la API. AWS Ground Station Esta acción cargará una efeméride utilizando los datos del cuerpo de la solicitud o de un bucket de S3 específico.
Es importante tener en cuenta que al cargar una efeméride ésta se establece en ` VALIDATING` e inicia un flujo de trabajo asíncrono que validará y generará contactos potenciales a partir de la efeméride. Solo se podrá utilizar para contactos cuando la efeméride haya superado este flujo de trabajo y esté `ENABLED`. Deberías sondear el estado de las efemérides o usar CloudWatch eventos [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)para hacer un seguimiento de los cambios de estado de las efemérides.
Para solucionar problemas relacionados con una efeméride no válida, consulta: [Solucionar problemas de efemérides no válidas](troubleshooting-invalid-ephemerides.md)
## Ejemplo: cargar datos de efemérides OEM desde un bucket de S3
También es posible cargar un archivo de efemérides OEM directamente desde un depósito de S3 apuntando al depósito y a la clave del objeto. AWS Ground Station recuperará el objeto en tu nombre. La información sobre el cifrado de los datos en reposo AWS Ground Station se detalla en:[Cifrado de datos en reposo para AWS Ground Station](security.encryption-at-rest.md).
A continuación se muestra un ejemplo de cómo cargar un archivo de efemérides OEM desde un bucket de 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']}")
```
A continuación se muestra un ejemplo de los datos devueltos por la acción [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) a la que se llama para las efemérides OEM cargadas en el bloque anterior de código de ejemplo.
```
{
"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"
}
}
}
}
```