The IERS Central Bureau provides the following Web services. For more Web services see website of Earth Orientation Centre.
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"
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 ...
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", "isAvailable" (to test the availability of the web service)
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", "available" for "isAvailable"
Note: You may test the availability of the web service by giving "isAvailable" as param and "00:00:00" as datetime. This will return "available", if the web service is working correctly.
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 ...