The best friendly way to get SSO properties from SsODNet.datacloud
is to use the
“rocks
”
API. This is a command-line Python software allowing to request properties with simple and
natural commands. Read the documentation for
more information and tutorials.
Another way to get properties is to use the SsODNet.datacloud
Webservice.
To query the properties of a given solar system object you must provide a name or a pattern which can
be resolved by the SsODNet.resolver
method. See the section "How to name objects"
of the resolver
method.
Examples:
The datacloud
service may also accept a list of target names to retrieve their data in
a single request. The list of targets must be provided as a text file (unicode UTF-8 format) containing
a name per line (example) or a JSON array (example).
This file may be downloadable by the SsODNet server from an URL provided through the -name
argument
of the datacloud HTTP request, or may be submitted
to the SsODNet server through a POST request (parameter = targets
). In that case, the -name
argument must be left empty.
Examples to retrieve the diameters and albedos of a list of targets:
curl -F "targets=@target_list.json" \
"https://ssp.imcce.fr/webservices/ssodnet/api/datacloud.php?-name=&-resource=diamalbedo&-mime=json&-from=SsODNetDoc" \
-o diamalbedo.json
Each property refers to a dataset which has been aggregated in SsODNet database. This can be an original
dataset (e.g. ASTORB), or a home-made dataset built from many articles (e.g. diamalbedo). Each dataset
contains the most comprehensive list of estimates and measurements of dynamical and physical properties of SSOs,
and is defined by a unique collection name.
To discover the collections that make up SsODNet.datacloud
, you must use the reserved keyword
collection
.
Examples:
To know which bibliographic references have been used to populate the collections or a given collection, you must use the reserved keyword
bibref
.
Examples:
To list the collections that contain properties for a given SSO, you must use the reserved keyword list
.
Examples:
To get the properties of a given SSO, you must provide the name of the collection, or use the optional reserved
keyword all
to get all its properties.
Examples: