Parameter | Definition | Limits or value |
---|---|---|
-ep=<dateTime> | Requested epoch, expressed in Julian day, ISO format, or formatted as any English textual datetime |
2433647.0 .. 2460676.0 (1951-01-01 12h .. 2024-12-31 12h) |
-body=<integer> | The number (or a comma separated list of numbers) of the requested solar system body | c.f. the list of recognized bodies |
-nbd=<integer> | The number of dates to compute (default 1) | 1 ≤ nbd < 731 |
-step=<integer> | Step between dates, in day (default 1) | 1 ≤ step ≤ 100 |
-long=<real> | Longitude of the observer location, negative toward east, in decimal degrees | -180° ≤ long ≤ 180° |
-lat=<real> | Latitude of the observer location, negative toward south, in decimal degrees | -90° < lat < 90° |
-tz=<real> | Timezone of the observer location, in hours | - |
-mime=<string> | Mime type of the results | votable | html | text | text/csv |
-extrap=<int> | Number of significant decimal digits of output parameters | default = 1 |
-from=<string> | Word which definite the name of the caller application, or which describes the request (optional) | any short string (without space) |
The output is described in the following table and is available in VOTable, HTML, CSV or plain text format (cf. examples).
The -mime parameter is optional and its value can be omitted (just write nothing or &-mime= without value). In this case, the output is displayed in VOTable.
The -extrap parameter is optional and its value can be omitted. This parameter applies on the second of time of the rise, transit and set events, and the values of the local coordinates (azimut and altitude) of the body at the time of events. Its default value is 0 (e.g. time and coordinates are truncated, respectively, at second and degree levels).
(*) Note that you should preferably leave the header field 'hostip' empty.
The input parameters of the method is an array which must contained the following parameters:Variable | Type | Units | Limits or values | Default | Comment |
---|---|---|---|---|---|
body | integer | - | 1,2,4,5,6,7,8,10,11 | 11 | The number (or a comma separated list of numbers) of the requested solar system body |
epoch | string | epoch | 2433647.0 .. 2460676.0 (1951-01-01 12h .. 2024-12-31 12h) |
none | Requested epoch (julian day, ISO format, English textual datetime) |
nbd | integer | - | 1 .. 730 | 1 | The number of date of computation |
longitude | double | degree | -180° .. 180° (decimal) | none | Longitude of the observer location, negative toward east |
latitude | double | degree | -90° .. +90° (decimal) | none | Latitude of the observer location, negative toward south |
tz | double | hour | - | 0 | Timezone of the observer location |
mime | string | - | votable | html | text | text/csv | votable | Mime type of the results |
extrap | int | - | Positive integer | 1 | Number of significant decimal digits of output parameters |
No. | Definition | Units | Comment |
---|---|---|---|
1 | Name of the Solar system body | - | |
2 | Date of the event | yyyy-mm-dd | |
3 | Rise time | hh:mm:ss.s | (*) |
4 | Azimut of the rising | deg. | (*) |
5 | Transit time | hh:mm:ss.s | (*) |
6 | Elevation of the transit | deg. | (*) |
7 | Set time | hh:mm:ss | (*) |
8 | Azimut of the setting | deg. | (*) |
9 | Astronomical down | hh:mm:ss | for the Sun only |
10 | Nautical down | hh:mm:ss | for the Sun only |
11 | Civil down | hh:mm:ss | for the Sun only |
12 | Civil twilight | hh:mm:ss | for the Sun only |
13 | Nautical twilight | hh:mm:ss | for the Sun only |
14 | Astronomical twilight | hh:mm:ss | for the Sun only |
(*) The number of significant digits is defined by the parameter 'extrap'. The default value is 0 (time and coordinates are truncated, respectively, at second and degree levels). The number of digits does not define, in any case, the true accuracy of the computed values. It has to be taken as a computational precision.
Depending on the selected mime type, the output is formatted as:In order to help you to invoke the Miriade web service, we provide some clients written in differents languages. Here are some detailed explanations to see how to write a client with PHP and SOAP which invokes the rts method:
1/ Provide the input parameters which are mandatory for the service:
2/ Define the SOAP options, the namespace and the WSDL URI of Miriade Web service:
3/ Create a SoapClient object in WSDL mode, set the SOAP header, then call the method and catch exceptions: