

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.

# Obtén las efemérides actuales de un satélite
<a name="getting-current-ephemeris"></a>

 Las efemérides actuales que utiliza un satélite específico se pueden recuperar llamando a las acciones o. AWS Ground Station [GetSatellite[ListSatellites](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListSatellites.html)](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) Ambos métodos proporcionan los metadatos de las efemérides actualmente en uso. Estos metadatos de efemérides son diferentes para las efemérides personalizadas cargadas y para las efemérides predeterminadas. AWS Ground Station 

**nota**  
 Las efemérides de elevación acimutal no están asociadas a los satélites y, por lo tanto, no las devuelven ni. [GetSatellite[ListSatellites](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListSatellites.html)](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) Para recuperar información sobre las efemérides de elevación del acimut, usa la [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)API con el ID de efemérides específico o úsala para ver todas las efemérides disponibles en tu cuenta. [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html) 

 Las Efemérides predeterminadas solo incluyen los campos `source` y `epoch` fields. `epoch`Es la [época](https://en.wikipedia.org/wiki/Epoch_(astronomy)) del [conjunto de elementos de dos líneas](https://en.wikipedia.org/wiki/Two-line_element_set) que se extrajo de [Space-Track, y actualmente se utiliza para calcular la trayectoria](https://www.space-track.org/) del satélite. 

 Una efeméride personalizada tendrá un valor de origen `source` valor de `CUSTOMER_PROVIDED` e incluirá un identificador único en el campo `ephemerisId`. Este identificador único puede utilizarse para consultar las efemérides utilizando la acción [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html). Se devolverá un `name` campo opcional si se asignó un nombre a la efeméride durante la subida a través de la acción. AWS Ground Station [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) 

 Es importante tener en cuenta que las efemérides se actualizan de forma dinámica, por AWS Ground Station lo que los datos devueltos son solo una instantánea de las efemérides que se estaban utilizando en el momento de la llamada a la API. 

## Ejemplo de retorno [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) para un satélite que utiliza una efeméride predeterminada
<a name="w2aac28c23c13"></a>

```
{
    "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
    }
}
```

## Ejemplo [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) para un satélite que utiliza una efeméride predeterminada
<a name="w2aac28c23c15"></a>

```
{
      "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"
      }
  }
```

## Listado de efemérides de elevación azimutal
<a name="w2aac28c23c17"></a>

 Como las efemérides de elevación azimutal no están asociadas a los satélites, es necesario utilizar diferentes para descubrirlas y recuperar información sobre ellas: APIs 

1. Utilízalo [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)para enumerar todas las efemérides de tu cuenta, incluidas las efemérides de elevación azimutal. Puedes filtrar por estado y tipo de efemérides.

1. [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)Utilízalo con un identificador de efemérides específico para obtener información detallada sobre una efeméride de elevación azimutal.

1. Úselo [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)con un ID de contacto específico para obtener información detallada sobre una efeméride utilizada para el contacto.

 Ejemplo de [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)respuesta que incluye una efeméride de elevación acimutal: 

```
{
    "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
        }
    ]
}
```

**nota**  
 En la [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)respuesta, las efemérides de elevación acimutal tendrán un campo en lugar de un `groundStation` campo, lo que facilitará su identificación. `satelliteId` 