Miriade

💡 The answer in PDF or VOTable format.

https://ssp.imcce.fr/webservices/miriade/api/vision.php?[parameters]

The output parameters are described in the following section, and are available in VOTable (default), HTML, or PDF format (see examples). The parameters with a default value are optionnal, and they can be omitted (just left blank the value, e.g. ...&-mime=&...). The other input parameters are mandatory.

Web Service URI:

https://ssp.imcce.fr/webservices/miriade/miriade.php

Namespace:

https://ssp.imcce.fr/webservices/miriade

WSDL:

https://ssp.imcce.fr/webservices/miriade/miriade.php?wsdl

SOAP header:

name of the SOAP header element: clientID

SOAP header's content: array('from' => 'YourName', 'hostip'=>'', 'lang'=>'en|fr')

Method:

vision (inputArray)

The output of the method is an object containing the following attributes:

'flag'

the status of the response: flag=1 means ok; flag=0 or flag=-1 mean that an error occured

'status'

the HTTP status-code of the response (e.g. 400: bad request, 422: Unprocessable Entity, 500: internal error)

'ticket'

the Unix timestamp of the response which can be useful to stamp the request

'result'

a string containing the result of the request, as a PDF or a VOTable document.

votable

the data are written in the IVOA standard VOTable format

html

the data are transformed from VOTable to HTML by XSLT processing (Miriade XSL style sheet)

pdf

the data are returned as a PDF document (application/pdf)

• mime=pdf
• mime=html
• mime=votable

The output result of the vision method is composed of a table and two figures per date of computation. The meaning of the displayed quantities is given in the following table. For each target, the values are reported at the time of the highest elevation.

$> curl "<URL>"

$> wget "<URL>"

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 write a client with PHP and SOAP which invokes the vision method:

1/ Provide the input parameters which are mandatory for the service:

// Client's ID: provide the name of your project or organisation or yourself
$from = 'MyName';
// Input parameters
$param = array('name' => 'p:4,a:107,c:67P,u:HIP_87937,u:M_70,e:13.15-72.80=SMC"',
               'epoch' => 2455886.5,
               'nbd' => 1,
               'step' => 1,
               'observer' => 809,
               'cuts' => '',
               'sort' => '',
               'mime' => 'pdf'
);

2/ Define the SOAP options, the namespace and the WSDL URI of Miriade web service:

// Enables or disables the WSDL caching feature
ini_set('soap.wsdl_cache_enabled', 1);
// Miriade namespace
$namespace = 'https://ssp.imcce.fr/webservices/miriade';
// Miriade WSDL
$uriwsdl = $namespace.'/miriade.wsdl';

3/ Create a SoapClient object in WSDL mode, set the SOAP header, then call the method and catch exceptions:

try {
   // Constructs the client
   $client = new SoapClient($uriwsdl, array('exceptions'=>1));
   // SOAP header
   $header = array('from'=>$from, 'hostip'=>'', 'lang'=>'en');
   $client->__setSoapHeaders(array(new SOAPHeader($namespace, 'clientID', $header)));  
   // Call the resolver method
   $response = $client->__soapCall('vision',array($param));
   // Display the results
   if ($param['mime'] == 'pdf') {
      header("HTTP/1.0 ".$response->status);
      header("Content-Type: application/pdf");
      echo file_get_contents($response->result);
   } else {
      header("HTTP/1.0 ".$response->status);
      header("Content-Type: text/xml;content=x-votable");
      echo $response->result;
   }
} 
catch (SoapFault $fault) 
{
   trigger_error("SOAP Fault: {$fault->getTraceAsString()} (faultcode: {$fault->faultcode}, 
                               faultstring: {$fault->faultstring})", E_USER_ERROR);
}