Экспорт прогнозов погоды в Коломые выполняется в формате XML с адреса http://rp5.ua/xml/416/ru. Если необходимо получить данные для другого населённого пункта, укажите значение его id. Это значение указано в конце адреса страницы с прогнозом погоды в интересующем населённом пункте. Например, указанное выше значение id=416 можно было бы узнать на странице "Погода в Коломые" http://rp5.ua/416/ru.
<?xml version="1.0" encoding="windows-1251"?> <weather created="rp5.ua" date="2010-9-03"> <point id="416"> <point_id>416</point_id> <region_id>121</region_id> <country_id>4</country_id> <point_name>Коломыя</point_name> <point_name_trim>Коломыя</point_name_trim> <point_name2>в Коломые</point_name2> <point_timestamp>1283491658</point_timestamp> <gmt_add>3</gmt_add> <point_date>Fri, 3 Sep 2010 05:27:38 +0300</point_date> <point_date_time>2010-9-03 05:27 </point_date_time> <timestep> <time_step>12</time_step> <datetime>2010-9-03 15:00</datetime> <G>15</G> <HHii>15:00</HHii> <cloud_cover>54</cloud_cover> <precipitation>0.6</precipitation> <pressure>738</pressure> <temperature>17</temperature> <humidity>60</humidity> <wind_direction>З</wind_direction> <wind_velocity>3</wind_velocity> <falls>1</falls> <drops>1</drops> </timestep> <timestep> <time_step>24</time_step> <datetime>2010-9-04 03:00</datetime> <G>3</G> <HHii>03:00</HHii> <cloud_cover>77</cloud_cover> <precipitation>0.1</precipitation> <pressure>739</pressure> <temperature>11</temperature> <humidity>98</humidity> <wind_direction>С</wind_direction> <wind_velocity>2</wind_velocity> <falls>1</falls> <drops>0.5</drops> </timestep> <timestep> <time_step>36</time_step> <datetime>2010-9-04 15:00</datetime> <G>15</G> <HHii>15:00</HHii> <cloud_cover>54</cloud_cover> <precipitation>0.3</precipitation> <pressure>738</pressure> <temperature>17</temperature> <humidity>64</humidity> <wind_direction>В</wind_direction> <wind_velocity>4</wind_velocity> <falls>1</falls> <drops>0.5</drops> </timestep> <timestep> <time_step>48</time_step> <datetime>2010-9-05 03:00</datetime> <G>3</G> <HHii>03:00</HHii> <cloud_cover>89</cloud_cover> <precipitation>5.5</precipitation> <pressure>737</pressure> <temperature>13</temperature> <humidity>99</humidity> <wind_direction>С</wind_direction> <wind_velocity>3</wind_velocity> <falls>1</falls> <drops>6</drops> </timestep> </point> </weather>
Выгружаемые данные представляют собой прогнозы на 4 момента местного времени.
С 3 до 15 час летнего киевского времени выгружаются прогнозы на
сегодня > день,
завтра > ночь,
завтра > день,
послезавтра > ночь.
С 15 до 3 час летнего киевского времени:
завтра > ночь,
завтра > день,
послезавтра > ночь,
послезавтра > день.
Обязательные условия экспорта
Эта услуга бесплатная. Свободно берите данные с указанного выше адреса и используйте на своём сайте. НИКОГО не нужно спрашивать или уведомлять об этом. На сайте-импортере вблизи от визуализированных прогнозов должно размещаться название и/или адрес ("Расписание Погоды" и/или rp5.ua) и соответствующая гиперссылка. На странице, где визуализируются наши прогнозы, упоминание других погодных сайтов не допускается. Данные должны предоставляться пользователям исключительно как визуализация на сайте-импортере, доступном снаружи 24 часа в сутки 7 дней в неделю. Не допускается никакая дальнейшая передача данных с сайта-импортера в виде собственных погодных информеров, электронных сообщений, SMS, ftp и всех остальных видов передач.
Один сайт и/или один IP-адрес может использовать прогнозы не более чем по 50 (пятидесяти) населённым пунктам.
На сайте, который принимает прогнозы, нужно:
1. На любом из доступных вам языков программирования (PHP, ASP, JSP и т. п.) написать парсер получаемых данных. То есть скрипт, выполняемый на вашем сервере, должен запросить данные с нашего сайта (GET запрос). После этого скрипт должен преобразовать данные, полученные в XML-формате, в HTML-код для вывода на одной из страниц вашего сайта.
2. Рядом с отображаемыми прогнозами разместить название и/или адрес ("Расписание Погоды" и/или rp5.ua) и гиперссылку на наш сайт. Имеется в виду, что если на вашем сайте визуализируются прогнозы, например, по Форосу, то гиперссылка должна быть http://rp5.ua/178/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.ua drops умножается на 2. Тогда при drops = 0.5 нужно изобразить одну каплю или снежинку, при drops = 8 - шестнадцать капель или снежинок.
Вопросы WEB-разработчиков
1) Как часто происходит обновление прогнозов, и в какое время это происходит?
См. ответ на странице Частые вопросы.
2) Когда лучше забирать (импортировать) прогнозы?
Для того, чтобы на вашем сайте были самые актуальные прогнозы, достаточно импортировать данные 4 раза в сутки после:
3 час 15 мин,
7 час 15 мин,
15 час 15 мин и
19 час 15 мин по летнему киевскому времени.
В 3 и 15 часов в экспорте изменяется набор передаваемых моментов времени:
сегодня день (15:00), завтра ночь (03:00), завтра день (15:00), послезавтра ночь (03:00) и
завтра ночь (03:00), завтра день (15:00), послезавтра ночь (03:00), послезавтра день (15:00) соответственно
К 7 и 19 часам в нашей базе обновляются прогнозы на ближайшие двое суток.
15 минут добавлены на случай, если по каким-то причинам произойдёт задержка или время на нашем сайте и сайте-импортёре окажется несинхронизированным.
3) Можно ли получать полный, а не сокращённый, набор прогнозов?
Да, это возможно. По любому из населённых пунктов Вы можете получать полный набор прогнозов, обновляемый дважды в сутки. Эти данные предоставляются на платной основе по цене один доллар за один населённый пункт в месяц.
Если бесплатный набор - это 4 прогностических момента времени, то платный - 18 моментов времени. Платный набор включает всё, что представлено в таблицах на нашем сайте по данному населённому пункту. См. например, Киев. 18 моментов времени соответствуют 18 колонкам таблицы. Утром до 9 часов по летнему киевскому времени в таблице открыты все 18 колонок. В течение суток неактуальные (время которых прошло) колонки закрываются. Поэтому в тот момент, когда Вы посмотрите, то, возможно, увидите в таблице не 18, а 17 или 16 колонок.
Прогнозы полностью обновляются дважды в сутки: к 8 и 20 час по летнему киевскому времени.
Важное замечание. Условия экспорта, указанные выше, в равной мере обязательны и для сокращённого, и для полного (платного) набора прогнозов.
Дополнительно см. Параметры и Частые вопросы