- Nodejs >= 14 (also you can use docker)
- python (python is used for node-gyp to compile c++ swiss ephemeris library)
-
You need to install dependencies of node-gyp depending on your OS. Follow the instructions to install it depending on your OS https://github.com/nodejs/node-gyp#installation
-
Clone the repo
git clone [email protected]:ryuphi/astrology-api.git
-
Install dependencies
npm install
npm start
Also you can use
npm run dev
, this option run with nodemon to watch changes.
Example: Get the horoscope for date 1993-08-06
, time 16:50:00
with timezone -04:00
at Santiago, Chile (latitude -33.41167
and longitude -70.66647
) using Placidus houses system.
Fist, you need to transform the date & time to ISO8601, for this example 1993-08-06T16:50:00-04:00
.
Second, you must escape the date and time when you make the request.
This is because if the time zone is with a positive sign, for example +05:00,
when sending it through the request, the url will take the + sign as a space and not as the + sign.
For this example it would be 1993-08-06T16%3A50%3A00-04%3A00
. See issue #10
If you don't want to escape the date and time, you can always send it to UTC 🙂
In UTC: 1993-08-06T20:50:00Z
Then, you need to select the house system from the houses system table.. in this case for the placidus system you need to send the P
value in the houseSystem
query param.
Now you can send this...
# escaped
curl --request GET \
--url 'http:https://localhost:3000/horoscope?time=1993-08-06T16%3A50%3A00-04%3A00&latitude=-33.41167&longitude=-70.66647&houseSystem=P'
# in utc
curl --request GET \
--url 'http:https://localhost:3000/horoscope?time=1993-08-06T20:50:00Z&latitude=-33.41167&longitude=-70.66647&houseSystem=P'
The values from each house system is extracted from sweph source code
Code value | House system |
---|---|
A | equal |
B | Alcabitius |
C | Campanus |
D | equal (MC) |
E | equal |
F | Carter poli-equ. |
G | Gauquelin sectors |
H | horizon/azimut |
I | Sunshine |
i | Sunshine/alt. |
K | Koch |
L | Pullen SD |
M | Morinus |
N | equal/1=Aries |
O | Porphyry |
Q | Pullen SR |
R | Regiomontanus |
S | Sripati |
T | Polich/Page |
U | Krusinski-Pisa-Goelzer |
V | equal/Vehlow |
W | equal/ whole sign |
X | axial rotation system/Meridian houses |
Y | APC houses |