Sets latitude, longitude and other data of the current telescope.
- Inputs
-
latitude Latitude of telescope. South is negative, North is positive.
longitude Longitude of telescope. West is negative, East is positive.
targetaltitude Minimum altitude that the telescope can observe in degrees relative to the horizon.
sunaltitude Altitude of sun at dusk and dawn in degrees.
- Outputs
-
latitude Latitude of telescope. South is negative, North is positive.
longitude Longitude of telescope. West is negative, East is positive.
targetaltitude Minimum altitude that the telescope can observe in degrees relative to the horizon.
sunaltitude Altitude of sun at dusk and dawn in degrees.
POST https://targettool.aavso.org/TargetTool/api/v1/telescope
Authentication: Basic (username: your-api-key-here, password: api_token)
Python code:
import requests
API_KEY = "your-api-key-here"
data = {'latitude':36.1661111111,'longitude':-86.7838888889}
entry = requests.post("https://targettool.aavso.org/TargetTool/api/v1/telescope",auth=(API_KEY,"api_token"),data=data)
print(entry.json())
Result:
{'latitude':36.1661111111,'longitude':-86.7838888889,'targetaltitude':20,'sunaltitude':-5}
Get information about targets in the Target Tool database.
- Inputs
-
obs_section An array with observing sections of interest. You may use one or more of: ac,ep,cv,eb,spp,lpv,yso,het,misc,all. Default is ['ac'] (Alerts & Campaigns).
observable If true, filters out targets which are visible at the telescope location during the following nighttime period. Default is false.
orderby Order by any of the output fields below, except for observability_times and solar_conjunction.
reverse If true, reverses the order. Default is false.
latitude Latitude of telescope. South is negative, North is positive. If not provided, the user's settings are assumed.
longitude Longitude of telescope. West is negative, East is positive. If not provided, the user's settings are assumed.
targetaltitude Minimum altitude that the telescope can observe in degrees relative to the horizon. If not provided, the user's settings are assumed.
sunaltitude Altitude of sun at dusk and dawn in degrees. If not provided, the user's settings are assumed.
time Time of interest as a UTC timestamp. If not provided, the current time is assumed.
- Outputs
-
star_name Name of the star as it appears in the Target Tool.
ra Right ascension. Note this returns decimal degrees, not DMS.
dec Declination. Note this returns decimal degrees, not DMS.
var_type Variable type.
min_mag Minimum magnitude.
min_mag_band Minimum magnitude band.
max_mag Maximum magnitude.
min_mag_band Maximum magnitude band.
period Period in days.
obs_cadence Observing cadence in days.
obs_mode Observing mode: Photometry, Visual, Spectroscopy, All
obs_section Observing section: one or more of Alerts / Campaigns, Cataclysmic Variables, Eclipsing Variables, Short Period Pulsators, Long Period Variables, Young Stellar Objects, High Energy Targets, Exoplanets, Miscellaneous, None.
filter Filters: one or more of B, V, R, I, U, J, H, Vis, Visual, Spectroscopy, All
other_info Info manually supplied by AAVSO about this target. Targets may be formatted with a URL, which is enclosed in double brackets along with a description: [[Alert Notice 631 https://www.aavso.org/aavso-alert-notice-631]]
last_data_point Last observation made in UTC.
priority If true, designates a high priority target.
constellation Constellation area where the target is located.
observability_times Visibility events for the target in UTC, given telescope information and assuming target is not near solar conjunction. Provided in pairs of status code and UTC timestamp.
solar_conjunction If true, target is near solar conjunction.
- Status codes
-
TARGET_RISES Time when the target becomes visible.
TARGET_SETS Time when the target is no longer visible.
TARGET_IS_ALWAYS_UP Target will be visible throughout the next nighttime period. If the sun is down, target will be visible for the rest of the current nighttime period.
TARGET_IS_ALWAYS_DOWN Target will not be visible during the next nighttime period.
GET https://targettool.aavso.org/TargetTool/api/v1/targets
Authentication: Basic (username: your-api-key-here, password: api_token)
Python code:
import requests
API_KEY = "your-api-key-here"
entry = requests.get("https://targettool.aavso.org/TargetTool/api/v1/targets",auth=(API_KEY,"api_token"),params={'obs_section':['all']})
print(entry.json())
Result:
{'targets':[
...,
{'constellation': 'Cyg',
'dec': 50.24142,
'filter': '',
'last_data_point': 1518435383,
'max_mag': 5.6,
'max_mag_band': 'V',
'min_mag': 10.1,
'min_mag_band': 'V',
'obs_cadence': 3.0,
'obs_mode': 'All',
'obs_section': ['None'],
'observability_times': [['TARGET_RISES', 1526524965]],
'other_info': '',
'period': None,
'priority': False,
'ra': 291.13779,
'solar_conjunction': False,
'star_name': 'CH Cyg',
'var_type': 'ZAND+SR'},
{'constellation': 'Oph',
'dec': -24.9655,
'filter': 'All',
'last_data_point': 1501308179,
'max_mag': 14.1,
'max_mag_band': 'V',
'min_mag': 22.0,
'min_mag_band': 'V',
'obs_cadence': 3.0,
'obs_mode': 'All',
'obs_section': ['None'],
'observability_times': [['TARGET_RISES', 1526534623],
['TARGET_SETS', 1526551958]],
'other_info': '',
'period': None,
'priority': False,
'ra': 264.94208,
'solar_conjunction': False,
'star_name': 'Nova Oph 2017',
'var_type': 'N'},
...
]
}