XML экспорт прогнозов погоды
Экспорт прогнозов погоды в Болбасово выполняется в формате XML с адреса http://rp5.by/xml/151228/00000/ru. Если необходимо получить данные для другого населённого пункта, укажите значение его id. Это значение указано в конце адреса страницы с прогнозом погоды в интересующем населённом пункте. Например, указанное выше значение id=151228 можно было бы узнать на странице "Погода в Болбасово" http://rp5.by/151228/ru.
<?xml version="1.0" encoding="utf-8"?> <weather created="rp5.by" date="2012-2-04"> <point id="151228"> <point_id>151228</point_id> <region_id>3</region_id> <country_id>1</country_id> <point_name>Болбасово</point_name> <point_name_trim>Болбасово</point_name_trim> <point_name2>в Болбасово</point_name2> <point_timestamp>1328354506</point_timestamp> <gmt_add>3</gmt_add> <point_date>Sat, 4 Feb 2012 11:21:46 +0300</point_date> <point_date_time>2012-2-04 11:21 </point_date_time> <timestep> <time_step>12</time_step> <datetime>2012-2-04 15:00</datetime> <G>15</G> <HHii>15:00</HHii> <cloud_cover>81</cloud_cover> <precipitation>2.0</precipitation> <pressure>762</pressure> <temperature>-16</temperature> <humidity>76</humidity> <wind_direction>Ю</wind_direction> <wind_velocity>3</wind_velocity> <falls>3</falls> <drops>2</drops> </timestep> <timestep> <time_step>24</time_step> <datetime>2012-2-05 03:00</datetime> <G>3</G> <HHii>03:00</HHii> <cloud_cover>37</cloud_cover> <precipitation>1.6</precipitation> <pressure>759</pressure> <temperature>-17</temperature> <humidity>89</humidity> <wind_direction>Ю</wind_direction> <wind_velocity>2</wind_velocity> <falls>3</falls> <drops>2</drops> </timestep> <timestep> <time_step>36</time_step> <datetime>2012-2-05 15:00</datetime> <G>15</G> <HHii>15:00</HHii> <cloud_cover>81</cloud_cover> <precipitation>2.8</precipitation> <pressure>757</pressure> <temperature>-10</temperature> <humidity>85</humidity> <wind_direction>С</wind_direction> <wind_velocity>3</wind_velocity> <falls>3</falls> <drops>3</drops> </timestep> <timestep> <time_step>48</time_step> <datetime>2012-2-06 03:00</datetime> <G>3</G> <HHii>03:00</HHii> <cloud_cover>37</cloud_cover> <precipitation>1.8</precipitation> <pressure>758</pressure> <temperature>-13</temperature> <humidity>94</humidity> <wind_direction>В</wind_direction> <wind_velocity>2</wind_velocity> <falls>3</falls> <drops>2</drops> </timestep> </point> </weather>
Выгружаемые данные представляют собой прогнозы на 4 момента местного времени.
С 4 до 16 час летнего московского времени выгружаются прогнозы на:
сегодня > день,
завтра > ночь,
завтра > день,
послезавтра > ночь.
С 16 до 4 час летнего московского времени:
завтра > ночь,
завтра > день,
послезавтра > ночь,
послезавтра > день.
Обязательные условия экспорта
Эта услуга бесплатная. Свободно берите данные с указанного выше адреса и используйте на своём сайте. НИКОГО не нужно спрашивать или уведомлять об этом. На сайте-импортере вблизи от визуализированных прогнозов должно размещаться название и/или адрес ("Расписание Погоды" и/или rp5.by ) и соответствующая гиперссылка. На странице, где визуализируются наши прогнозы, упоминание других погодных сайтов не допускается. Данные должны предоставляться пользователям исключительно как визуализация на сайте-импортере, доступном снаружи 24 часа в сутки 7 дней в неделю. Не допускается никакая дальнейшая передача данных с сайта-импортера в виде собственных погодных информеров, электронных сообщений, SMS, ftp и всех остальных видов передач.
Один сайт и/или один IP-адрес может использовать прогнозы не более чем по 50 (пятидесяти) населённым пунктам.
На сайте, который принимает прогнозы, нужно:
1. На любом из доступных вам языков программирования (PHP, ASP, JSP и т. п.) написать парсер получаемых данных. То есть скрипт, выполняемый на вашем сервере, должен запросить данные с нашего сайта (GET запрос). После этого скрипт должен преобразовать данные, полученные в XML-формате, в HTML-код для вывода на одной из страниц вашего сайта.
2. Рядом с отображаемыми прогнозами разместить название и/или адрес ("Расписание Погоды" и/или rp5.by ) и гиперссылку на наш сайт. Для прогнозов в Болбасово гиперссылка должна быть http://rp5.by/151228/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) Как часто происходит обновление прогнозов, и в какое время это происходит?
См. ответ на странице Частые вопросы (FAQ).
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 минут добавлены на случай, если по каким-то причинам произойдёт задержка или время на нашем сайте и сайте-импортёре окажется несинхронизированным.
3) Можно ли получать полный, а не сокращённый, набор прогнозов?
Да, это возможно. По любому из населённых пунктов Вы можете получать полный набор прогнозов, обновляемый дважды в сутки. Эти данные предоставляются на платной основе по цене один доллар за один населённый пункт в месяц.
Если бесплатный набор - это 4 прогностических момента времени, то платный - 24 момента времени. Платный набор включает всё, что представлено в таблицах на нашем сайте по данному населённому пункту. См. Например, http://rp5.by/151228/ru 24 момента времени соответствуют 24 колонкам таблицы. Утром до 10 часов по летнему московскому времени в таблице открыты все 24 колонки. В течение суток неактуальные (время которых прошло) колонки закрываются. Поэтому в тот момент, когда Вы посмотрите, то, возможно, увидите в таблице не 24, а 23 или 22 колонки.
Прогнозы полностью обновляются дважды в сутки: к 9 и 21 час по летнему московскому времени.
Важное замечание. Условия экспорта, указанные выше, в равной мере обязательны и для сокращённого, и для полного (платного) набора прогнозов.
Дополнительно см. Параметры и Частые вопросы (FAQ)