For radio 
RSS   
XML   
Share       

XML export of weather forecasts


Export of weather forecasts is performed in XML format from the address http://rp5.kz/xml/99799/00000/en. If you need to get data for another location, please specify its id value. This value is indicated at the end of the address of the page with the weather forecast at the required location. For example, the above mentioned id value = 99799 could be found on the page "Weather "http://rp5.kz/99799/en.

<?xml version="1.0" encoding="utf-8"?>
<weather created="rp5.kz" date="2012-5-17">
	<point id="99799">
		<point_id>99799</point_id>
		<region_id>9</region_id>
		<country_id></country_id>
		<point_name></point_name>
		<point_name_trim></point_name_trim>
		<point_name2></point_name2>
		<point_timestamp>1337278892</point_timestamp>
		<gmt_add>5</gmt_add>
		<point_date>Thu, 17 May 2012 18:21:32 +0500</point_date>
		<point_date_time>2012-5-17 18:21 </point_date_time>
				<timestep>
					<time_step>24</time_step>
					<datetime>2012-5-18 05:00</datetime>
					<G>5</G>
					<HHii>05:00</HHii>
					<cloud_cover>28</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>748</pressure>
					<temperature>10</temperature>
					<humidity>46</humidity>
					<wind_direction>NE</wind_direction>
					<wind_velocity>2</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
				<timestep>
					<time_step>36</time_step>
					<datetime>2012-5-18 17:00</datetime>
					<G>17</G>
					<HHii>17:00</HHii>
					<cloud_cover>28</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>749</pressure>
					<temperature>24</temperature>
					<humidity>19</humidity>
					<wind_direction>NE</wind_direction>
					<wind_velocity>6</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
				<timestep>
					<time_step>48</time_step>
					<datetime>2012-5-19 05:00</datetime>
					<G>5</G>
					<HHii>05:00</HHii>
					<cloud_cover>0</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>753</pressure>
					<temperature>12</temperature>
					<humidity>34</humidity>
					<wind_direction>E</wind_direction>
					<wind_velocity>5</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
				<timestep>
					<time_step>60</time_step>
					<datetime>2012-5-19 17:00</datetime>
					<G>17</G>
					<HHii>17:00</HHii>
					<cloud_cover>0</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>755</pressure>
					<temperature>24</temperature>
					<humidity>19</humidity>
					<wind_direction>E</wind_direction>
					<wind_velocity>7</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
	</point>
</weather>

Uploaded data are the forecasts for 4 local time points.

From 00:00 to 12:00 UTC forecasts are uploaded for:
today > daytime,
tomorrow > night,
tomorrow > daytime,
the day after tomorrow > night.

From 12:00 to 00:00 UTC forecasts are uploaded for:
tomorrow > night,
tomorrow > daytime,
the day after tomorrow > night,
the day after tomorrow > daytime.

Terms and conditions of export

This service is free. Simply take data from the address above and use it on your website. You don’t have to ask or notify ANYONE about it. The name and /or address ("Reliable Prognosis" and/or rp5.kz ) and the appropriate hyperlink shall be displayed near the visualized forecasts on the website-importer. Please note that it is not allowed to mention other weather websites on the pages where our forecasts are visualized. The data are provided solely for visualization on the website-importer that has IP address and / or is located on the demilitarized zone ( DMZ) 24 hours a day, 7 days a week. There shall be no further transfer of data from the website - importer in the form of one’s own weather sticker, e-mail messages, SMS, ftp and other types of transmissions.

One website and/or one IP-address can use weather forecasts for maximum fifty (50) locations.

The following tasks have to be performed on the website, that receives weather forecast:

1. To write a parser of receiving data in any programming language (PHP, ASP, JSP, etc.) available to you. That is a script running on your server must request the data from our website (GET request). Then the script must convert the received data into XML-format, into HTML-code for output to one of the pages on your website.

2. To place the name and/or address ("Reliable Prognosis" and/or rp5.kz ) and the appropriate hyperlink to our website near the forecasts displayed. That is if your website displays forecasts, for example,, the hyperlink must be http://rp5.kz/99799/en

3. To delete references to other weather websites from the page displaying our forecasts.

Data description

Parameter transmission method: GET.
GET-parameters of script: id - ID value of a location.

Description of fields with data

point_id - location ID in the website base
region_id - region ID where the location is situated
country_id - country ID where the location is situated
point_name - full location name. For example, "Dubrovka (Dubrovskiy District)"
point_name_trim - short location name without brackets. For example, "Dubrovka". point_name_trim corresponds to point_name before opening bracket. If there is no bracket, point_name_trim = point_name
point_name2 - location name used with preposition. For example, "in Dubrovka". It is used in headings like "The Weather in Dubrovka" ("weather"+ point_name2)
point_timestamp - unix- timestamp of a date in the location
gmt_add - UTC- shift in hours, taking into account day-light saving time
point_date - local time in a location at the moment of creating a file with data indicating gmt_add. For example, "Sun, 12 Dec 2004 13:00:25 +0300"
point_date_time - local time in a location at the moment of creating a file with data. A less detailed format is used. For example, "2004-12-12 13:00"
time_step - forecast time step in hours from midnight (00:00 UTC) of the current day. For example, time_step = 48 means the forecast for the next 48 hours relative to 00:00 UTC of the current day.
datetime - forecast moment according to the local time (date hour:minute)
G - forecast moment according to the local time in hours. For example, "15"
HHii - forecast moment according to the local time in hours and minutes. For example, "15:00"
cloud_cover - cloudiness (%)
precipitation - precipitation thickness, accumulated within 4 hours prior to the above mentioned point in time. For example, if G = 15 o’clock, precipitation was accumulated from 11 to 15 o’clock. Thus, when rendering the value of deposits - in contrast to all other parameters – it is better to locate it between neighboring time points
pressure - atmospheric pressure
temperature - air temperature
humidity - relative humidity (%)
wind_direction - direction of the wind (N-north, NE-North-East, etc.). Direction shows where the wind is blowing FROM. For example, north wind blows from the North
wind_velocity - wind speed
falls - type of precipitation (0 – lack of precipitation, 1 - rain, 2 – rain and snow, 3 - snow)
drops - the coefficient of the amount of snowflakes or raindrops for visualization. Possible values: 0.5, 1, 2, 3, 4, 5, 6, 7, 8.The more the value, the more quantity and the larger size the raindrops and snowflakes have.

Questions from WEB-developers

1) How often are forecasts updated and what time does it happen?

See the answer on page FAQ.

2) When is the best time to take (import) the forecasts?

If you want to have the latest weather forecast on your website, it is enough to import data 4 times a day after:
00:15 UTC
04:15 UTC
12:15 UTC
16:15 UTC

At 00:00 and 12:00 UTC a set of transmission time points is changed in export:
today daytime (12:00 UTC ), tomorrow night (00:00 UTC), tomorrow daytime (12:00 UTC), the day after tomorrow night (00:00 UTC) and
tomorrow night (00:00 UTC), tomorrow daytime (12:00 UTC), the day after tomorrow night (00:00 UTC), the day after tomorrow daytime (12:00 UTC) correspondingly.

Forecasts for the next two days are updated in our database by 04:00 and 16:00 UTC.

15 minutes have been added as any delays may occur or unsynchronized time may appear on our website or website-importer.

3) Can I get full, not shorten set of forecasts?

Yes, it is possible. For any of the locations, you can get a full set of forecasts, updated twice a day. This information is provided on a paid basis at a price of one dollar for one location per month.

If a free set contains 4 prognostic points in time, the paid one - 24. The paid set has everything that is presented in the tables on our website for a certain location. See http://rp5.kz/99799/en as an example. 24 points in time correspond to 24 columns of the table. In the morning until 06:00 UTC all 24 columns are open in the table. During the day irrelevant columns (the time of which has passed) are closed. Therefore, when you look, you may see not 24, but 23 or 22 columns in the table.

Forecasts are completely renewed twice a day: at 05:00 and 17:00 UTC.

Important note. Terms of exports mentioned above, are equally compulsory both for shorten and full (paid) set of forecasts.

For more information see Definitions and FAQ