systeme-solaire / api-rest Goto Github PK

View Code? Open in Web Editor NEW

29.0 1.0 0.0 806 KB

API - The Solar System OpenData

Home Page: https://api.le-systeme-solaire.net/rest/

License: MIT License

PHP 100.00%

astronomy solar-system planets planetary-satellites opendata-api

api-rest's Introduction

The Solar System OpenData

An open Rest API for querying all Solar System data.

https://api.le-systeme-solaire.net

Features

Main bodies

All planets and their moons, all dwarfs planets and the main asteroids.

Physical characteristics

Dimensions, mass, flattening, gravity, inclination and temperature.

Orbital parameters

Semimajor axis, perihelion, aphelion, eccentricity, orbital period and orbital speed.

History

Discovery circumstances, discoverer(s), year discovered and provisional designation.

Family

For every body, all its satellites and the ability to navigate between satellites and the star.

Known objects count

Known count of each object type : planets, moons, asteroids, comets.

Documentation

How to use the API?

All bodies in one request

An URL returns all bodies in the database with all data: https://api.le-systeme-solaire.net/rest/bodies/

Boby by body

An URL returns all data of one body: https://api.le-systeme-solaire.net/rest/bodies/{id}

All known count

An URL returns all known count for each object type : https://api.le-systeme-solaire.net/rest/knowncount/

Known count, object type by object type

An URL returns known count for the object type : https://api.le-systeme-solaire.net/rest/knowncount/{id}

API parameters for /bodies

#	Parameter	Action
1	data	The data you want to retrieve (comma separated).
2	exclude	One or more data you want to exclude (comma separated).
3	order	The sort order data you want to use and the sort direction (comma separated).
4	page	Page number (number>=1) and page size (size>=1 with 20 as default) (comma separated).
5	rowData	Transform the objects in records.
6	filter[]	Filters to be applied. Each filter consists of a data, an operator and a value (comma separated).
7	satisfy	Should all filters match (default).

API parameters /knowncount

#	Parameter	Action
1	rowData	Transform the objects in records.

License

Distributed under MIT license.

api-rest's People

Contributors

Stargazers

Watchers

api-rest's Issues

Add a way to know the bodies position

Hello,

First, thanks a lot for the great work here.

It would be very nice if we had a way to know the position of the bodies (for instance : by date), like it's possible here : https://en.tutiempo.net/astronomy/sun-earth-moon-3d.html or here : https://solarsystem.nasa.gov/resources/2515/real-time-real-data/

Asc and desc use (may be a bug)

Hi!

I'm making the following request:

https://api.le-systeme-solaire.net/rest/bodies/?data=id,meanRadius&order=meanRadius,desc&filter[]=isPlanet,eq,-1

expecting to see the planets listed in decreasing meanRadius order. However, they appear listed in increasing meanRadius order.

I've tried using different keywords instead of "desc" but none appears to be working.

Please, let me know if I'm doing something wrong, or it's a bug to be fixed.

Great job, thank you!

Jupiters moon 'S/2011 J 1' returns invalid JSON

# works
>>> req = cURL.get('https://api.le-systeme-solaire.net/rest/bodies/eirene')

>>> json.loads(req.text)
{'id': 'eirene', 'name': 'Eiréné', 'englishName': 'Eirene', 'isPlanet': False, 'moons': None, 'semimajorAxis': 23493000, 'perihelion': 0, 'aphelion': 0, 'eccentricity': 0.22, 'inclination': 163.1, 'mass': {'massValue': 9.0, 'massExponent': 13}, 'vol': {'volValue': 0.0, 'volExponent': 0}, 'density': 1.0, 'gravity': 0, 'escape': 0, 'meanRadius': 2.0, 'equaRadius': 0, 'polarRadius': 0, 'flattening': 0, 'dimension': '', 'sideralOrbit': 759.7, 'sideralRotation': 0, 'aroundPlanet': {'planet': 'jupiter', 'rel': 'https://api.le-systeme-solaire.net/rest/bodies/jupiter'}, 'discoveredBy': 'Scott S. Sheppard, David C. Jewitt', 'discoveryDate': '2003', 'alternativeName': 'S/2003 J 5', 'axialTilt': 0}

>>> req.text
'{"id":"eirene","name":"Eiréné","englishName":"Eirene","isPlanet":false,"moons":null,"semimajorAxis":23493000,"perihelion":0,"aphelion":0,"eccentricity":0.22000,"inclination":163.10000,"mass":{"massValue":9.00000, "massExponent":13},"vol":{"volValue":0.00000, "volExponent":0},"density":1.00000,"gravity":0,"escape":0,"meanRadius":2.00000,"equaRadius":0,"polarRadius":0,"flattening":0,"dimension":"","sideralOrbit":759.70000,"sideralRotation":0,"aroundPlanet":{"planet":"jupiter", "rel":"https://api.le-systeme-solaire.net/rest/bodies/jupiter"},"discoveredBy":"Scott S. Sheppard, David C. Jewitt","discoveryDate":"2003","alternativeName":"S/2003 J 5","axialTilt":0}'

# fails
>>> req = cURL.get('https://api.le-systeme-solaire.net/rest/bodies/s2011j1')

>>> req.text
'{"id":"s2011j1","name":"S/2011 J 1","englishName":"S/2011 J 1","isPlanet":false,"moons":null,"semimajorAxis":20 155 290,"perihelion":0,"aphelion":0,"eccentricity":0.29600,"inclination":162.80000,"mass":{"massValue":2.40000, "massExponent":16},"vol":{"volValue":0.00000, "volExponent":0},"density":1.00000,"gravity":0,"escape":0,"meanRadius":0.50000,"equaRadius":0,"polarRadius":0,"flattening":0,"dimension":"","sideralOrbit":580.70000,"sideralRotation":0,"aroundPlanet":{"planet":"jupiter", "rel":"https://api.le-systeme-solaire.net/rest/bodies/jupiter"},"discoveredBy":"Scott S. Sheppard","discoveryDate":"29/01/2012","alternativeName":"S/2011 J 1","axialTilt":0}'

>>> json.loads(req.text)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Applications/Blender.app/Contents/Resources/2.81/python/lib/python3.7/json/__init__.py", line 348, in loads
    return _default_decoder.decode(s)
  File "/Applications/Blender.app/Contents/Resources/2.81/python/lib/python3.7/json/decoder.py", line 337, in decode
    obj, end = self.raw_decode(s, idx=_w(s, 0).end())
  File "/Applications/Blender.app/Contents/Resources/2.81/python/lib/python3.7/json/decoder.py", line 353, in raw_decode
    obj, end = self.scan_once(s, idx)
json.decoder.JSONDecodeError: Expecting ',' delimiter: line 1 column 113 (char 112)

The semimajorAxis values are not properly quoted "semimajorAxis":20 155 290

i checked around bodies.php, but it looks right, could the data source possibly have an errant entry?

Cannot parse JSON for specific URL's

Example : I can't parse data from this url : https://api.le-systeme-solaire.net/rest/bodies/deimos

Volume of Sun is missing

Volume of Sun is missing : {'volValue': 0.0, 'volExponent': 0}

Some Sideral Orbit inconsistencies I noticed

Chariklo sideralOrbit listed as 23, should be 22987.
https://api.le-systeme-solaire.net/rest/bodies/chariklo

Cleoselene should be 1.8 (according to Wikipedia).
https://api.le-systeme-solaire.net/rest/bodies/cleoselene

Weywot to be 12.438.
https://api.le-systeme-solaire.net/rest/bodies/weywot

Dwarf Planets are considered planets ("isPlanet":true) when they're not

The Dwarf planets: Ceres, Eris, Pluto, Makemake & Haumea are considered as planets in "isPlanet":true. This should be changed to false, as they're not actually planets. The IAU doesn't consider Pluto (and other dwarf planets) as planets.

67 bodies has sideralOrbit =2.74

For example "id": "hygie",
It's probably some bug in data

Using the filter isPlanet,eq,true

I expect using the above filter would give me back just the records where isPlanet is true however it's bringing back only the records where is planet is false.

https://api.le-systeme-solaire.net/rest/bodies?data=id,englishName,isPlanet&filter[]=isPlanet,eq,true&order=englishName,asc

Discovery Data for some planets don't exist.

Discovered By / Discovery Date data doesn't exist for some of the major 9 planets in our solar system.

Deimos mass value is off

The mass value for Deimos is listed as 2.4 with the exponent being 15. According to https://en.wikipedia.org/wiki/Deimos_(moon) the mass is 1.4762 * 10^15. The exponent is correct but the mass value is wrong.

Some field-related issues I spotted

NEOWISE is missing an englishName. Should be C/2020 F3 (NEOWISE)"
https://api.le-systeme-solaire.net/rest/bodies/c2020f3-neowise

Junon's englishName should be 3 Juno.
https://api.le-systeme-solaire.net/rest/bodies/junon

Venus, Uranus and Pluto have negative numbers as their sideralRotation, but I'm unsure if this is intentional.
https://api.le-systeme-solaire.net/rest/bodies/venus
https://api.le-systeme-solaire.net/rest/bodies/uranus
https://api.le-systeme-solaire.net/rest/bodies/pluton

Average Temperature is 0 for all bodies.

The average temperature for all bodies is 0. {..., avgTemp: 0}

Vanth/Orcus data incorrect, and Quaoar listed as having no moons.

Orcus looks like it should have a single moon named 'Vanth' (the data for this exists in the API).
Likewise, Quaoar should also have its single moon 'Weywot' linked in the data.

Ceres is classified as an asteroid while the IAU classifies it as a Dwarf Planet

Ceres is classified as an asteroid in the API: "bodyType": "Asteroid"

This should not be the case, it should be classified as "bodyType":"Dwarf Planet" as the IAU does consider Ceres as a Dwarf Planet.

Encoded characters in 'discoveredBy'

Hi, looks like some of the 'discoveredBy' keys contain an encoded character.
https://api.le-systeme-solaire.net/rest/bodies/methone

This issue seems to be happening for:

Methone
Pallene
Anthe
Remus
Haumea

Add images to every planet/moon

Really awesome API! Love the data. There is only one thing i'm missing. It would be nice to have images of every object. In an ideal world there would be a transparent png and jpeg.

Quaoar listed as 'Asteroid'

It should be Dwarf Planet.
https://api.le-systeme-solaire.net/rest/bodies/quaoar

S/2003 J 24 missing from the Jupiter moon data.

It's one of the many moons, but while parsing them for my own personal project I noticed this one is missing.
https://en.wikipedia.org/wiki/S/2003_J_24

The API seems to return no record of this particular entity.

Were there any contribution instructions? I'd love to be able to contribute some updates for this.

S/2003 J 24 set as 'moon' instead of 'Moon'

I noticed the object "S/2003 J 24" bodyType property is set as "moon", when every other moon's bodyType is set as "Moon".

Cheers, Luca.

Syntax error in Saturn's moon

Hi,
In S2004S41 Saturn's moon, property axialTilt has no value (not even null or blank string), so JSON is "axialTilt":,. This causes a syntax error.

Cheers,

Alex

englishName fields for Saturn's moons seem to have gone missing

https://api.le-systeme-solaire.net/rest/bodies/
Looks like the englishNames went missing recently for:

S/2004 S 22
S/2004 S 21
S/2004 S 20
S/2004 S 23
S/2004 S 24
S/2004 S 25
S/2004 S 26
S/2004 S 27
S/2004 S 28
S/2004 S 29
S/2004 S 30
S/2004 S 31
S/2004 S 32
S/2004 S 33
S/2004 S 34
S/2004 S 35
S/2004 S 36
S/2004 S 37
S/2004 S 38
S/2004 S 39

Also one for Jupiter:

S/2003 J 24