Всі країни  Білорусь  Гродненська область  Гродненський район  Гродно
Для радіо 
RSS   
XML   
Поділитися       

XML експорт прогнозів погоди


Експорт прогнозів погоди в Гродно виконується у форматі XML з адреси http://rp5.by/xml/84/00000/ua. Якщо необхідно отримати дані для іншого населеного пункту, вкажіть значення його id. Це значення вказано наприкінці адреси сторінки з прогнозом погоди в населеному пункті,що цікавить. Наприклад, вказане вище значення id=84 можна було б взнати на сторінці "Погода в Гродно" http://rp5.by/84/ua.

<?xml version="1.0" encoding="utf-8"?>
<weather created="rp5.by" date="2012-5-17">
	<point id="84">
		<point_id>84</point_id>
		<region_id>5</region_id>
		<country_id>1</country_id>
		<point_name>Гродно</point_name>
		<point_name_trim>Гродно</point_name_trim>
		<point_name2>в Гродно</point_name2>
		<point_timestamp>1337269522</point_timestamp>
		<gmt_add>3</gmt_add>
		<point_date>Thu, 17 May 2012 15:45:22 +0300</point_date>
		<point_date_time>2012-5-17 15:45 </point_date_time>
				<timestep>
					<time_step>24</time_step>
					<datetime>2012-5-18 03:00</datetime>
					<G>3</G>
					<HHii>03:00</HHii>
					<cloud_cover>76</cloud_cover>
					<precipitation>0.4</precipitation>
					<pressure>748</pressure>
					<temperature>5</temperature>
					<humidity>82</humidity>
					<wind_direction>З</wind_direction>
					<wind_velocity>4</wind_velocity>
					<falls>1</falls>
					<drops>0.5</drops>
				</timestep>
				<timestep>
					<time_step>36</time_step>
					<datetime>2012-5-18 15:00</datetime>
					<G>15</G>
					<HHii>15:00</HHii>
					<cloud_cover>45</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>752</pressure>
					<temperature>13</temperature>
					<humidity>42</humidity>
					<wind_direction>З</wind_direction>
					<wind_velocity>3</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
				<timestep>
					<time_step>48</time_step>
					<datetime>2012-5-19 03:00</datetime>
					<G>3</G>
					<HHii>03:00</HHii>
					<cloud_cover>0</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>754</pressure>
					<temperature>5</temperature>
					<humidity>87</humidity>
					<wind_direction>Пн-С</wind_direction>
					<wind_velocity>3</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
				<timestep>
					<time_step>60</time_step>
					<datetime>2012-5-19 15:00</datetime>
					<G>15</G>
					<HHii>15:00</HHii>
					<cloud_cover>81</cloud_cover>
					<precipitation>0.0</precipitation>
					<pressure>755</pressure>
					<temperature>16</temperature>
					<humidity>44</humidity>
					<wind_direction>Пд-С</wind_direction>
					<wind_velocity>2</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
	</point>
</weather>

Вивантажувані дані представляють собою прогнози на 4 моменти місцевого часу.

З 00:00 до 12:00 UTC вивантажуються прогнози на:
сьогодні > день,
завтра > ніч,
завтра > день,
післязавтра > ніч.

З 12:00 до 00:00 UTC:
завтра > ніч,
завтра > день,
післязавтра > ніч,
післязавтра > день.

Обов'язкові умови експорту

Ця послуга безкоштовна. Вільно беріть дані за вказаною вище адресою і використовуйте на своєму сайті. НІЧИЙ дозвіл на це не потрібний. На сайті-імпортері поряд з візуалізованими прогнозами повинна розміщуватись назва і/або адреса ("Розклад Погоди" і/або rp5.by ) і відповідне посилання. На сторінці, де візуалізуються наші прогнози, згадка інших погодних сайтів не допускається. Дані повинні надаватися користувачам виключно як візуалізація на сайті-імпортері, доступному зовні 24 години на добу 7 днів на тиждень. Не допускається ніяка подальша передача даних з сайту-імпортера у вигляді власних погодних інформерів, електроних повідомлень, SMS, ftp і всіх інших типів передач.

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

На сайті, який приймає прогнози, потрібно:

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

2. Поруч з відображеними прогнозами розмістити назву і/або адресу ("Розклад Погоди" і/або rp5.by ) і гіперпосилання на наш сайт. Для прогнозів в Гродно гіперпосилання має бути http://rp5.by/84/ua

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 - UTC-зміщення у годинах з врахуванням переходу на літньо-зимовий час
point_date - місцевий час в НП у момент створення файла з даними із зазнеченням gmt_add. Наприклад, "Sun, 12 Dec 2004 13:00:25 +0300"
point_date_time - місцевий час в НП у момент створення файла з даними. Використовується менш докладний формат. Наприклад, "2004-12-12 13:00"
time_step - часовий крок прогнозу в годинах від півночі (00:00 UTC) поточної доби. Наприклад, time_step = 48 означає прогноз на 48 годин вперед щодо 00:00 UTC поточної доби.
datetime - момент прогнозу за місцевим часом (дата година:хвилина)
G - момент прогноза за місцевим часом у годинах. Наприклад, "15".
Hhii - момент прогноза за місцевим часом у годинах і хвилинах. Наприклад, "15:00"
cloud_cover - хмарність (%)
precipitation - товщина опадів, накопичених протягом 6 годин перед вказаним вище моментом часу. Наприклад, якщо G = 15 годин, то опади накопичувались з 9 до 15 години. Таким чином, при візуалізації значення опадів - на відміну від усіх інших параметрів - краще розташовувати між сусідніми моментами часу.
pressure - атмосферний тиск
temperature - температура повітря
humidity - відносна вологість повітря (%)
wind_direction - напрямок вітру (Пн-північний, ПнС-північно-східний і т.д.). Напрямок вказує ЗВІДКИ дме вітер. Наприклад, північний вітер дме з півночі.
wind_velocity - швидкість вітру
falls - тип опадів (0 - відсутність опадів, 1 - дощ, 2 - дощ зі снігом, 3 - сніг)
drops - коефіцієнт кількості сніжинок або крапель дощу для візуалізації. Можливі значення: 0.5, 1, 2, 3, 4, 5, 6, 7, 8. Чим більше це значення, тим кількість або розмір крапель або сніжинок повинні бути більше.

Запитання WEB-розробників

1) Як часто відбувається оновлення прогнозів, і в який час це відбувається?

Див. відповідь на сторінці Найчастіші запитання (FAQ).

2) Коли краще забирати (імпортувати) прогнози?

Для того, щоб на вашому сайті були найактуальніші прогнози, достатньо імпортувати дані 4 рази на добу після:
00:15 UTC
04:15 UTC
12:15 UTC,
16:15 UTC

З 00:00 і 12:00 UTC у експорті змінюється набір переданих моментів часу:
сьогодні день (12:00 UTC), завтра ніч (00:00 UTC), завтра день (12:00 UTC), післязавтра ніч (00:00 UTC) і
завтра ніч (00:00 UTC), завтра день (12:00 UTC), післязавтра ніч (00:00 UTC), післязавтра день (12:00 UTC) відповідно.

До 04:00 і 16:00 UTC у нашій базі оновлюються прогнози на найближчі дві доби.

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

3) Чи можна отримувати повний, а не скорочений набір прогнозів?

Так, це можливо. По любому з населених пунктів Ви можете отримувати повний набір прогнозів, оновлюваних двічі на добу. Ці дані надаються на платній основі по ціні один долар за один населений пункт на місяць.

Якщо бесплатний набір - це 4 прогностичних момента часу, то платний - 24 моментів часу. Платний набір включає все, що представлено в таблицях на нашому сайті по даному населеному пункту. Див. наприклад, http://rp5.by/84/ua 24 моментів часу відповідають 24 колонкам таблиці. Вранці до 06:00 UTC у таблиці відкрито усі 24 колонки. Протягом доби неактуальні (час яких минув) колонки закриваються. Тому в той момент, коли Ви подивитеся, то, можливо, побачите в таблиці не 24, а 23 або 22 колонки.

Прогнози повністю оновлюються двічі на добу: к 05:00 і 17:00 UTC.

Важливе зауваження. Умови експорту, вказані вище, однаково обов'язкові і для скороченого, і для повного (платного) набору прогнозів.

Додатково див. Параметри і Найчастіші запитання (FAQ)