XML экспорт прогнозов погоды
Экспорт прогнозов погоды в Курчатове выполняется в формате XML с адреса http://rp5.kz/xml/13883/ru. Если необходимо получить данные для другого населённого пункта, укажите значение его id. Это значение указано в конце адреса страницы с прогнозом погоды в интересующем населённом пункте. Например, указанное выше значение id=13883 можно было бы узнать на странице "Погода в Курчатове" http://rp5.kz/13883/ru.
<?xml version="1.0" encoding="utf-8"?> <weather created="rp5.kz" date="2010-9-07"> <point id="13883"> <point_id>13883</point_id> <region_id>12</region_id> <country_id>2</country_id> <point_name>Курчатов</point_name> <point_name_trim>Курчатов</point_name_trim> <point_name2>в Курчатове</point_name2> <point_timestamp>1283845112</point_timestamp> <gmt_add>6</gmt_add> <point_date>Tue, 7 Sep 2010 07:38:32 +0600</point_date> <point_date_time>2010-9-07 07:38 </point_date_time> <timestep> <time_step>12</time_step> <datetime>2010-9-07 18:00</datetime> <G>18</G> <HHii>18:00</HHii> <cloud_cover>5</cloud_cover> <precipitation>0.0</precipitation> <pressure>740</pressure> <temperature>32</temperature> <humidity>14</humidity> <wind_direction>Ю-В</wind_direction> <wind_velocity>5</wind_velocity> <falls>0</falls> <drops>0</drops> </timestep> <timestep> <time_step>24</time_step> <datetime>2010-9-08 06:00</datetime> <G>6</G> <HHii>06:00</HHii> <cloud_cover>0</cloud_cover> <precipitation>0.0</precipitation> <pressure>737</pressure> <temperature>17</temperature> <humidity>15</humidity> <wind_direction>Ю</wind_direction> <wind_velocity>5</wind_velocity> <falls>0</falls> <drops>0</drops> </timestep> <timestep> <time_step>36</time_step> <datetime>2010-9-08 18:00</datetime> <G>18</G> <HHii>18:00</HHii> <cloud_cover>7</cloud_cover> <precipitation>0.0</precipitation> <pressure>732</pressure> <temperature>34</temperature> <humidity>7</humidity> <wind_direction>Ю-З</wind_direction> <wind_velocity>8</wind_velocity> <falls>0</falls> <drops>0</drops> </timestep> <timestep> <time_step>48</time_step> <datetime>2010-9-09 06:00</datetime> <G>6</G> <HHii>06:00</HHii> <cloud_cover>92</cloud_cover> <precipitation>0.0</precipitation> <pressure>747</pressure> <temperature>7</temperature> <humidity>49</humidity> <wind_direction>С-З</wind_direction> <wind_velocity>4</wind_velocity> <falls>0</falls> <drops>0</drops> </timestep> </point> </weather>
Выгружаемые данные представляют собой прогнозы на 4 момента местного времени.
С 4 до 16 час летнего московского времени выгружаются прогнозы на
сегодня > день,
завтра > ночь,
завтра > день,
послезавтра > ночь.
С 16 до 4 час летнего московского времени:
завтра > ночь,
завтра > день,
послезавтра > ночь,
послезавтра > день.
Обязательные условия экспорта
Эта услуга бесплатная. Свободно берите данные с указанного выше адреса и используйте на своём сайте. НИКОГО не нужно спрашивать или уведомлять об этом. На сайте-импортере вблизи от визуализированных прогнозов должно размещаться название и/или адрес ("Расписание Погоды" и/или rp5.kz) и соответствующая гиперссылка. На странице, где визуализируются наши прогнозы, упоминание других погодных сайтов не допускается. Данные должны предоставляться пользователям исключительно как визуализация на сайте-импортере, доступном снаружи 24 часа в сутки 7 дней в неделю. Не допускается никакая дальнейшая передача данных с сайта-импортера в виде собственных погодных информеров, электронных сообщений, SMS, ftp и всех остальных видов передач.
Один сайт и/или один IP-адрес может использовать прогнозы не более чем по 50 (пятидесяти) населённым пунктам.
На сайте, который принимает прогнозы, нужно:
1. На любом из доступных вам языков программирования (PHP, ASP, JSP и т. п.) написать парсер получаемых данных. То есть скрипт, выполняемый на вашем сервере, должен запросить данные с нашего сайта (GET запрос). После этого скрипт должен преобразовать данные, полученные в XML-формате, в HTML-код для вывода на одной из страниц вашего сайта.
2. Рядом с отображаемыми прогнозами разместить название и/или адрес ("Расписание Погоды" и/или rp5.kz) и гиперссылку на наш сайт. Для прогнозов в Курчатове гиперссылка должна быть http://rp5.kz/13883/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 час по летнему московскому времени.
Важное замечание. Условия экспорта, указанные выше, в равной мере обязательны и для сокращённого, и для полного (платного) набора прогнозов.
Дополнительно см. Параметры и Частые вопросы