Внимание! XML-данные по населённым пунктам Украины необходимо брать с сайта rp5.UA, Казахстана - с rp5.KZ, Беларуси - c rp5.BY.

Экспорт прогнозов погоды в Уфе выполняется в формате XML с адреса http://rp5.ru/xml/8667/ru. Если необходимо получить данные для другого населённого пункта, укажите значение его id. Это значение указано в конце адреса страницы с прогнозом погоды в интересующем населённом пункте. Например, указанное выше значение id=8667 можно было бы узнать на странице "Погода в Уфе" http://rp5.ru/8667/ru.

<?xml version="1.0" encoding="windows-1251"?>
<weather created="rp5.ru" date="2010-9-03">
	<point id="8667">
		<point_id>8667</point_id>
		<region_id>25</region_id>
		<country_id>3</country_id>
		<point_name>Уфа</point_name>
		<point_name_trim>Уфа</point_name_trim>
		<point_name2>в Уфе</point_name2>
		<point_timestamp>1283512941</point_timestamp>
		<gmt_add>6</gmt_add>
		<point_date>Fri, 3 Sep 2010 11:22:21 +0600</point_date>
		<point_date_time>2010-9-03 11:22 </point_date_time>
		<timestep>
			<time_step>12</time_step>
			<datetime>2010-9-03 18:00</datetime>
			<G>18</G>
			<HHii>18:00</HHii>
			<cloud_cover>0</cloud_cover>
			<precipitation>0.0</precipitation>
			<pressure>756</pressure>
			<temperature>29</temperature>
			<humidity>15</humidity>
			<wind_direction>Ю</wind_direction>
			<wind_velocity>6</wind_velocity>
			<falls>0</falls>
			<drops>0</drops>
		</timestep>
		<timestep>
			<time_step>24</time_step>
			<datetime>2010-9-04 06:00</datetime>
			<G>6</G>
			<HHii>06:00</HHii>
			<cloud_cover>28</cloud_cover>
			<precipitation>0.2</precipitation>
			<pressure>755</pressure>
			<temperature>17</temperature>
			<humidity>42</humidity>
			<wind_direction>Ю</wind_direction>
			<wind_velocity>5</wind_velocity>
			<falls>1</falls>
			<drops>0.5</drops>
		</timestep>
		<timestep>
			<time_step>36</time_step>
			<datetime>2010-9-04 18:00</datetime>
			<G>18</G>
			<HHii>18:00</HHii>
			<cloud_cover>50</cloud_cover>
			<precipitation>0.0</precipitation>
			<pressure>754</pressure>
			<temperature>29</temperature>
			<humidity>30</humidity>
			<wind_direction>Ю-З</wind_direction>
			<wind_velocity>2</wind_velocity>
			<falls>0</falls>
			<drops>0</drops>
		</timestep>
		<timestep>
			<time_step>48</time_step>
			<datetime>2010-9-05 06:00</datetime>
			<G>6</G>
			<HHii>06:00</HHii>
			<cloud_cover>75</cloud_cover>
			<precipitation>0.2</precipitation>
			<pressure>754</pressure>
			<temperature>14</temperature>
			<humidity>71</humidity>
			<wind_direction>С-З</wind_direction>
			<wind_velocity>2</wind_velocity>
			<falls>1</falls>
			<drops>0.5</drops>
		</timestep>
	</point>
</weather>

Выгружаемые данные представляют собой прогнозы на 4 момента местного времени.

С 4 до 16 час летнего московского времени выгружаются прогнозы на
сегодня > день,
завтра > ночь,
завтра > день,
послезавтра > ночь.

С 16 до 4 час летнего московского времени:
завтра > ночь,
завтра > день,
послезавтра > ночь,
послезавтра > день.

Обязательные условия экспорта

Эта услуга бесплатная. Свободно берите данные с указанного выше адреса и используйте на своём сайте. НИКОГО не нужно спрашивать или уведомлять об этом. На сайте-импортере вблизи от визуализированных прогнозов должно размещаться название и/или адрес ("Расписание Погоды" и/или rp5.ru) и соответствующая гиперссылка. На странице, где визуализируются наши прогнозы, упоминание других погодных сайтов не допускается. Данные должны предоставляться пользователям исключительно как визуализация на сайте-импортере, доступном снаружи 24 часа в сутки 7 дней в неделю. Не допускается никакая дальнейшая передача данных с сайта-импортера в виде собственных погодных информеров, электронных сообщений, SMS, ftp и всех остальных видов передач.

Один сайт и/или один IP-адрес может использовать прогнозы не более чем по 50 (пятидесяти) населённым пунктам.

На сайте, который принимает прогнозы, нужно:

1. На любом из доступных вам языков программирования (PHP, ASP, JSP и т. п.) написать парсер получаемых данных. То есть скрипт, выполняемый на вашем сервере, должен запросить данные с нашего сайта (GET запрос). После этого скрипт должен преобразовать данные, полученные в XML-формате, в HTML-код для вывода на одной из страниц вашего сайта.

2. Рядом с отображаемыми прогнозами разместить название и/или адрес ("Расписание Погоды" и/или rp5.ru) и гиперссылку на наш сайт. Для прогнозов в Уфе гиперссылка должна быть http://rp5.ru/8667/ru

3. Удалить упоминание других погодных сайтов со страницы, где отображаются наши прогнозы.

Описание данных

Метод передачи параметров: GET.
GET-параметры скрипта: id - значение ID населенного пункта (НП).

point_id - ID НП в базе сайта
region_id - ID региона, в котором находится НП
country_id - ID страны, в которой находится НП
point_name - полное наименование НП. Например, "Дубровка (Дубровский р-н)"
point_name_trim - сокращенное наименование НП без скобок. Например, "Дубровка". point_name_trim соответствует point_name до открывающейся скобки. Если скобки нет, то point_name_trim = point_name.
point_name2 - название НП в предложном падеже с предлогом. Например, "в Дубровке". Используется в заголовках вида "Погода в Дубровке" ("Погода " + point_name2)
point_timestamp - unix-таймстамп даты в НП
gmt_add - GMT-смещение в часах с учетом перехода на летнее-зимнее время
point_date - местное время в НП в момент создания файла с данными с указанием gmt_add. Например, "Sun, 12 Dec 2004 13:00:25 +0300"
point_date_time - местное время в НП в момент создания файла с данными. Используется менее подробный формат. Например, "2004-12-12 13:00"
time_step - смещение указанного ниже момента прогноза (datetime) в часах относительно 0 час Гринвичского времени в день составления прогноза. time_step соответствует русскому термину "заблаговременность прогноза". Например, если time_step = 48 - это прогноз на момент времени, отстоящий на 48 часов от момента составления прогноза (0 ГМТ).
datetime - момент прогноза по местному времени (дата час:минута)
G - момент прогноза по местному времени в часах. Например, "15".
HHii - момент прогноза по местному времени в часах и минутах. Например, "15:00"
cloud_cover - облачность (%)
precipitation - толщина осадков (мм), накопленных в течение 4 часов перед указанным выше моментом времени. Например, если G = 15 час, то осадки накапливались с 11 до 15 час. Таким образом, при визуализации значение осадков - в отличие от всех остальных параметров - лучше располагать между соседними моментами времени.
pressure - атмосферное давление (мм. рт. ст.)
temperature - температура воздуха (град. Цельсия)
humidity - относительная влажность воздуха (%)
wind_direction - направление ветра (С-северный, СВ-северо-восточный и т.д.). Направление указывает ОТКУДА дует ветер. Например, северный ветер дует с севера.
wind_velocity - скорость ветра (м/сек)
falls - тип осадков (0 - отсутствие осадков, 1 - дождь, 2 - дождь со снегом, 3 - снег)
drops - коэффициент количества снежинок или капель дождя для визуализации. Возможные значения: 0.5, 1, 2, 3, 4, 5, 6, 7, 8. На сайте rp5.ru drops умножается на 2. Тогда при drops = 0.5 нужно изобразить одну каплю или снежинку, при drops = 8 - шестнадцать капель или снежинок.

Вопросы WEB-разработчиков

1) Как часто происходит обновление прогнозов, и в какое время это происходит?

См. ответ на странице Частые вопросы.

2) Когда лучше забирать (импортировать) прогнозы?

Для того, чтобы на вашем сайте были самые актуальные прогнозы, достаточно импортировать данные 4 раза в сутки после:
4 час 15 мин,
8 час 15 мин,
16 час 15 мин и
20 час 15 мин по летнему московскому времени.

В 4 и 16 часов в экспорте изменяется набор передаваемых моментов времени:
сегодня день (16:00), завтра ночь (04:00), завтра день (16:00), послезавтра ночь (04:00) и
завтра ночь (04:00), завтра день (16:00), послезавтра ночь (04:00), послезавтра день (16:00) соответственно

К 8 и 20 часам в нашей базе обновляются прогнозы на ближайшие двое суток.

15 минут добавлены на случай, если по каким-то причинам произойдёт задержка или время на нашем сайте и сайте-импортёре окажется несинхронизированным.

Внимание! Первый суточный запрос данных лучше делать после 4 час 15 мин не только по летнему, но и по зимнему времени. Дело в том, что каждую ночь приблизительно в 3-3:30 на сервере происходит плановая профилактика, и поэтому не исключены проблемы с исполнением запроса.

3) Можно ли получать полный, а не сокращённый, набор прогнозов?

Да, это возможно. По любому из населённых пунктов Вы можете получать полный набор прогнозов, обновляемый дважды в сутки. Эти данные предоставляются на платной основе по цене тридцать три российских рубля (один доллар) за один населённый пункт в месяц.

Если бесплатный набор - это 4 прогностических момента времени, то платный - 18 моментов времени. Платный набор включает всё, что представлено в таблицах на нашем сайте по данному населённому пункту. См. например, Париж. 18 моментов времени соответствуют 18 колонкам таблицы. Утром до 10 часов по летнему московскому времени в таблице открыты все 18 колонок. В течение суток неактуальные (время которых прошло) колонки закрываются. Поэтому в тот момент, когда Вы посмотрите, то, возможно, увидите в таблице не 18, а 17 или 16 колонок.

Прогнозы полностью обновляются дважды в сутки: к 9 и 21 час по летнему московскому времени.

Важное замечание. Условия экспорта, указанные выше, в равной мере обязательны и для сокращённого, и для полного (платного) набора прогнозов.

Дополнительно см. Параметры и Частые вопросы