Navigation and service

Web services

The IERS Central Bureau provides the following Web services. For more Web services see website of Earth Orientation Centre.

Please note: These Web services are in an experimental status. Access cannot be guaranteed. Failure treatment may take some hours or even days, especially during weekends. If you would like to use one of these Web services on a regular basis, please write to central_bureau@iers.org.

EOP Web service

The EOP Web service returns a single EOP value for a specified parameter, series and date (MJD):

WSDL file: https://data.iers.org/eris/webservice/eop/eop.wsdl

Valid input parameters:
for param: "x_pole", "sigma_x_pole", "y_pole", "sigma_y_pole", "UT1-UTC", "sigma_UT1-UTC", "LOD", "sigma_LOD", "dPsi", "sigma_dPsi", "dEpsilon", "sigma_dEpsilon", "dX", "sigma_dX", "dY", "sigma_dY
for series: "Finals All (IAU2000)", "Finals Daily (IAU2000)", "Finals Data (IAU2000)", "Finals All (IAU1980)","Finals Daily (IAU1980)","Finals Data (IAU1980)","EOP 08 C04 (IAU1980)","EOP 08 C04 (IAU2000)","EOP 14 C04 (IAU1980)","EOP 14 C04 (IAU2000)","GPS Rapid","GPS Rapid Daily","Bulletin A","Bulletin B","EOP C01"
for mjd: a modified julian day

Unit of return value: msec for "UT1-UTC", "sigma_UT1_UTC","LOD" and "sigma_LOD"; marcsec for all other parameters

Examples how to use the EOP Web service:

  • Build a client with php and nusoap

    Notice: You need to have a web server with php installed.

    1. Download nusoap library (e.g. https://sourceforge.net/projects/nusoap/?source=typ_redirect).

    2. Download eopClient.php and eop.wsdl as zip file from our server.

    3. Unzip the nusoap classes and copy the folder into a public directory of your web server.

    4. Copy eopClient.php and eop.wsdl from the downloaded zip file into the same public directory of your web server.

    If you now access eopClient.php on your web server with a browser, you will get the response of our EOP Web service. You may change the parameters by changing the line
    $result = $client->call("readEOP", array("param" => "x_pole", "series" => "Bulletin A", "mjd" => "56300"));
    in eopClient.php.

  • Build a client with php and soap extension

    If you have php soap extension installed and enabled on your web server, you can build a client even more easily:

    Download eopClient12.zip, unpack it and copy it into a public directory of your web server.

    If you now access eopClient12.php on your web server with a browser, you will get the response of our EOP Web service. You may change the parameters by changing the line
    $result = $client->__soapCall('readEOP', array("x_pole", "Bulletin A", "56345"));
    in eopClient12.php.

  • Build a client with java

    Download EOPClient.java, compile and execute it. You can change the parameters by changing the line
    String result = getEOPValue("x_pole", "Bulletin A", "56000");.

  • Test the EOP Web service online

    http://www.soapclient.com/soaptest.html
    Fill in the address of the wsdl file (https://data.iers.org/eris/webservice/eop/eop.wsdl) and test ...


Time scales and leap second Web service

The time scales Web service returns a single value for a specified parameter and datetime:

WSDL file: https://data.iers.org/eris/webservice/timescales/timescales.wsdl

Valid input parameters:
for param:"leapseconds" (returns the number of leap seconds introduced until the given date), "mjd" (Modified Julian Date), "UT1-UTC" (returns the difference in seconds), "UT1", "TAI", "TT"
for datetime:a datetime string (yyyy-mm-dd HH:MM:SS) for any date since 1972 (e.g. "2012-03-14 14:23:31")

Return value: datetime as string for "UT1", "TAI" and "TT", number of leap seconds introduced until the given date for "leapseconds", difference in seconds for "UT1-UTC"

Examples how to use the time scales and leap second Web service:

  • Build a client with php and nusoap

    Notice: You need to have a web server with php installed.

    1. Download nusoap library (e.g. https://sourceforge.net/projects/nusoap/?source=typ_redirect).

    2. Download timescalesClient.php and timescales.wsdl as zip file from our server.

    3. Unzip the nusoap classes and copy the folder into a public directory of your web server.

    4. Copy timescalesClient.php and timescales.wsdl from the downloaded zip file into the same public directory of your web server.

    If you now access timescalesClient.php on your web server with a browser, you will get the response of our EOP Web service. You may change the parameters by changing the line
    $result = $client->call("getTimescale", array("param" => "leapseconds", "datetime" => "2012-03-14 14:23:31"));
    in timescalesClient.php.

  • Build a client with php and soap extension

    If you have php soap extension installed and enabled on your web server, you can build a client even more easily:

    Download timescalesClient12.zip, unpack it and copy it into a public directory of your web server.

    If you now access timescalesClient12.php on your web server with a browser, you will get the response of our EOP Web service. You may change the parameters by changing the line
    $result = $client->__soapCall('getTimescale', array("leapseconds", "2012-03-14 14:23:31"));
    in timescalesClient12.php.

  • Build a client with java

    Download TimescalesClient.java, compile and execute it. You can change the parameters by changing the line
    String result = getTimescalesValue("leapseconds", "2012-03-14 14:23:31");.

  • Test the EOP Web service online

    http://www.soapclient.com/soaptest.html
    Fill in the address of the wsdl file (https://data.iers.org/eris/webservice/timescales/timescales.wsdl) and test ...


This Page

© 2013 - Federal Agency for Cartography and Geodesy. All rights Reserved