XML ауа райы болжамдарының экспортау

Ауа райы болжамдарының экспортау XML форматында http://rp5.kz/xml/10196/kz адресінен жүзеге асырылады. Егер басқа елді мекен үшін мағлұматтарды алу керек болса, оның id мәнін көрсетіңіз. Id мәні ауа райы болжамы бар WEB-бетінің соңында көрсетілген. Мысалы, "Ауа райы Қатонқарағай а." http://rp5.kz/10196/kz келесіні білдіреді: бұл елді мекен үшін Id мәні - 10196.

<?xml version="1.0" encoding="utf-8"?>
<weather created="rp5.kz" date="2010-9-07">
	<point id="10196">
		<point_id>10196</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>1283845857</point_timestamp>
		<gmt_add>6</gmt_add>
		<point_date>Tue, 7 Sep 2010 07:50:57 +0600</point_date>
		<point_date_time>2010-9-07 07:50 </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>14</cloud_cover>
			<precipitation>0.0</precipitation>
			<pressure>669</pressure>
			<temperature>24</temperature>
			<humidity>46</humidity>
			<wind_direction>О-Б</wind_direction>
			<wind_velocity>2</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>668</pressure>
			<temperature>10</temperature>
			<humidity>75</humidity>
			<wind_direction>Ш</wind_direction>
			<wind_velocity>4</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>14</cloud_cover>
			<precipitation>0.0</precipitation>
			<pressure>665</pressure>
			<temperature>22</temperature>
			<humidity>28</humidity>
			<wind_direction>О</wind_direction>
			<wind_velocity>5</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>8</cloud_cover>
			<precipitation>0.0</precipitation>
			<pressure>668</pressure>
			<temperature>9</temperature>
			<humidity>70</humidity>
			<wind_direction>О-Ш</wind_direction>
			<wind_velocity>4</wind_velocity>
			<falls>0</falls>
			<drops>0</drops>
		</timestep>
	</point>
</weather>

Ұсынылатын мағлұматтар жергілікті уақытының 4 кезіне болжамдар болып табылады.

Москва жазғы уақытымен сағат 4-тен 16-ке дейін болжамдар шығады
бүгінге > күндіз,
ертең > түн,
ертең > күн,
бүрсiгүнi > түн.

Москва жазғы уақытымен сағат 16-тен 4-ке дейін: :
ертең > түн,
ертең > күн,
бүрсiгүнi > түн,
бүрсiгүнi > күн.

Экспорттың міндетті шарттары

Бұл қызмет төлем ақысыз. Жоғарыда көрсетілген адрестен мағлұматты еркін алыңыз да, өз сайтыңызда қолдаңыңыз. Бұл туралы ЕШКІМДІ сұрау немесе хабардар ету қажет емес. Импортер-сайтында визуализацияланған болжамдардың қасында аттың және/немесе адрестің («Ауа райы кестесі» және/немесе rp5.kz) және керекті гиперсілтеменің орналасуы керек. Біздің болжамдар визуализацияланған бетте басқа ауа райы сайттардың аттары болуына жол берілмейді. Мағлұматтар тәулікте 24 сағат, аптада 7 күн сыртында жетімді импортер-сайтында тек визуализация ретінде пайдаланушыларға ұсынылуы тиіс. Импортер-сайтынан мағлұматтарды келесі жіберуге өз ауа райы информерлер, электронды хабарламалар, SMS, ftp және жіберудің қалған басқа түрлері күйінде жол берілмейді.

Бір сайт және/немесе бір IP-адрес 50-ден (елуден) артық емес елді мекендер бойынша болжамдарды пайдалана алады.

Болжамдарда қабылдайтын сайтта:

1. Сіз қолдана алатын кез келген бағдарламалау тілінде (PHP, ASP, JSP және т.б.) алатын мағлұматтардың парсерін жазу керек. Іздің серверіңізде орындалатын скриптің сайтымыздан мағлұматтарды сұрауы керек (GET сұрау салу). Содан кейін скриптің XML-форматында алған мағлұматтарды сайтымыздың бір бетінде шығару үшін HTML-кодына айналдыруы керек.

2. Бейнеленетін болжамдардың қасында атты және/немесе адресті («Ауа райы кестесі» және/немесе rp5.kz) және керекті гиперсілтемені орналастыру керек. Егер сайтыңызда болжамдар мысалы, Астана бойынша визуализацияланса, гиперсілтеменің келесі түрде болуы керек: http://rp5.kz/10196/kz

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 - жазғы-қысқы уақытқа ауысуды есепке алумен сағаттардағы жылжу
point_date - gmt_add көрсетуімен мағлұматтары бар файлды құру кезіндегі ЕМ-дегі жергілікті уақыты. Мысалы, "Sun, 12 Dec 2004 13:00:25 +0300"
point_date_time - мағлұматтары бар файлды құру кезіндегі ЕМ-дегі жергілікті уақыты. Аса толық емес формат қолданылады. Мысалы, "2004-12-12 13:00"
time_step - Болжамды жасау күні Гринвич уақытымен 0 сағатқа қатысты төменде көрсетілген болжам уақытындағы жылжу (datetime). time_step «болжамның күн бұрынғылығы» терминіне сәйкес келеді. Мысалы, егер time_step = 48 – болжамды жасау кезінен (0ГКТ) 48 сағат аралығында болған уақытқа болжам
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.kz сайтында drops 2-ге көбейтіледі. Егер drops = 0.5, бір қар немесе тамшы бейнелеу керек, егер drops = 8 – 16 қар немесе тамшы

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 минут қосылады.

3) Қысқаша емес, ал толық болжамдар жиынтығын алуға бола ма?

Иә, мүмкін. Кез келген елді мекен бойынша Сіз тәулікте екі рет жаңартылатын толық болжамдар жиынтығын ала аласыз. Бұл мағлұматтар төлем ақы негізінде жүзеге асырылады: айына 1 доллар бір елді мекен үшін..

Төлем ақысыз жиынтық – болжамды 4 уақыт кезі, ақылы – 18 уақыт кезі. Төлем ақылы жиынтыққа сайтымыздағы кестелерде ұсынылған берілген елді мекен бойынша барлығы да кіреді. Қатонқарағай а., 18 қараңыз. 18 уақыт кезі кестенің 18 бағанына сәйкес келеді. Таңертең жазғы уақытымен 9 сағатқа дейін кестеде барлық 18 баған ашық. Тәулік ішінде маңызды емес (уақыты шыққан) бағандар жабылады. Сондықтан Сіз қараған кезде кестеде 18 емес, ал 17 немесе 16 бағанды ғана көре аласыз.

Болжамдар толығымен тәулікте екі рет: 8 және 20 сағатқа қарай жаңартылады.

Маңызды ескерту. Жоғарыда айтылып кеткен экспорт шарттары қысқаша және толық болжауды алу үшін екі жағдайда да міндетті.

Қосымша Жиі сұрақтары мен Параметрлерді қараңыз