As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Obtenha as efemérides atuais de um satélite
As efemérides atuais em uso AWS Ground Station por um satélite específico podem ser recuperadas chamando as ações ou. [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 os métodos retornarão metadados para as efemérides atualmente em uso. Esses metadados de efemérides são diferentes para efemérides personalizadas enviadas para e efemérides padrão. AWS Ground Station
**nota**
As efemérides de elevação de azimute não estão associadas a satélites e, portanto, não são retornadas por ou. [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 informações sobre efemérides de elevação de azimute, use a [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)API com o ID de efemérides específico ou use [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)para ver todas as efemérides disponíveis para sua conta.
As efemérides padrão incluirão apenas campos `source` e `epoch`. Essa `epoch` é a [época](https://en.wikipedia.org/wiki/Epoch_(astronomy)) do [conjunto de elementos de duas linhas](https://en.wikipedia.org/wiki/Two-line_element_set) que foi retirado do [Space-Track](https://www.space-track.org/) e atualmente está sendo usado para calcular a trajetória do satélite.
Uma efeméride personalizada terá um valor `source` de `CUSTOMER_PROVIDED` e incluirá um identificador exclusivo no campo `ephemerisId`. Esse identificador exclusivo pode ser usado para consultar as efemérides por meio da ação [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html). Um `name` campo opcional será retornado se a efeméride receber um nome durante o upload AWS Ground Station por meio da ação. [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)
É importante observar que as efemérides são atualizadas dinamicamente, AWS Ground Station portanto, os dados retornados são apenas um instantâneo das efemérides que estão sendo usadas no momento da chamada para a API.
## Exemplo de retorno [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) para um satélite usando uma efeméride padrão
```
{
"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
}
}
```
## Exemplo de retorno [GetSatellite](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_GetSatellite.html) para um satélite usando uma efeméride personalizada
```
{
"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"
}
}
```
## Listando efemérides de elevação de azimute
Como as efemérides de elevação de azimute não estão associadas a satélites, você precisa usar diferentes APIs para descobrir e recuperar informações sobre elas:
1. Use [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)para listar todas as efemérides em sua conta, incluindo efemérides de elevação de azimute. Você pode filtrar por status e tipo de efeméride.
1. Use [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)com um ID de efeméride específico para obter informações detalhadas sobre uma efeméride de elevação de azimute.
1. Use [DescribeContact](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeContact.html)com uma ID de contato específica para obter informações detalhadas sobre uma efeméride usada para o contato.
Exemplo de [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)resposta incluindo uma efeméride de elevação de azimute:
```
{
"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**
Na [ListEphemerides](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListEphemerides.html)resposta, as efemérides de elevação de azimute terão um `groundStation` campo em vez de um `satelliteId` campo, facilitando sua identificação.