Let's say you have an object you are interested most, a star, a galaxy or a cluster. And you would like to know what objects appear around that. This is why you would want a cone search. A cone search is defined by a point with coordinates right ascension and declination on the sky and a search radius. The Cone search API follows the VO specification.
On Gaia@AIP, there are two ways to perform cone searches: through the query interface or using the cone search API.
The Cone search from Gaia@AIP is available through the Query interface. You'll have to select the Cone search form under New query job on the left side of the page.
Cone search interface
Through the form, you can enter the right ascension and the declination in degrees and the search radius in arcsecs, defining a cone on the sky. Your input is then, translated into a ADQL query with the same parameters and the results are served as a result table and stored in your private database. The PostgresQL query is of the form:
SELECT ra, dec, DISTANCE( POINT('ICRS', ra, dec), POINT('ICRS', INPUT_RA, INPUT_DEC) ) AS dist FROM gaiaedr3.gaia_source WHERE 1 = CONTAINS( POINT('ICRS', ra, dec), CIRCLE('ICRS', INPUT_RA, INPUT_DEC, INPUT_RADIUS) )
Cone search API
The Cone Search API is one of the first and most successful protocols recommended by IVOA. The API for the
gaiadr3.gaia_source table is located at
https://gaia.aip.de/conesearch/api/gaiadr3.gaia_source/ - link to the Cone Search API and expects the parameters: RA (in degree), DEC (in degree), SR (in degree). An optional verbosity parameter VERB set to 1,2, or 3, can be provided, with VERB=1 selecting only
source_id for every object, VERB=2 selecting the most important columns, and VERB=3 selecting all columns.
You will retrieve a VOTABLE document by visiting an URL like
https://gaia.aip.de/conesearch/api/gaiadr3.gaia_source/?RA=245.89675&DEC=-26.52575&SR=0.01 - E.g. for a radius of one degree around M4.
You can use the Cone search API for scripted access using your favorite HTTP command line client, e.g.:
wget 'https://gaia.aip.de/conesearch/api/gaiadr3.gaia_source/?RA=245.89675&DEC=-26.52575&SR=0.01&VERB=1' curl 'https://gaia.aip.de/conesearch/api/gaiadr3.gaia_source/?RA=245.89675&DEC=-26.52575&SR=0.01&VERB=1' http 'https://gaia.aip.de/conesearch/api/gaiadr3.gaia_source/?RA=245.89675&DEC=-26.52575&SR=0.01&VERB=1'
Topcat is a Tool for Operations on Catalogues And Tables. The Cone search interface in topcat can be accessed from the VO menu. In the Cone search interface enter our API endpoint
https://gaia.aip.de/conesearch/api/gaiadr3.gaia_source/ under Cone URL. (We will add our service to the VO registry to be selected through the search window soon.). You can then choose RA, DEC and SR and retrieve the results of your request directly in topcat.
Cone search with Topcat
Cone search results