Todos os países  Bielorrússia  Hrodna (província)  Hrodna (distrito)  Hrodna
Para rádio 
RSS   
XML   
Partilhar       

Exportação de previsões no formato XML


A exportação de previsões de tempo no formato XML é feita a partir do endereço http://rp5.by/xml/84/00000/pt. Se for necessário obter dados para outra povoaçao, indique o valor do seu ID. Esse valor aparece no fim do endereço da página com previsão do tempo na povoação que interessa. Por exemplo, o valor acima indicado do ID=84 poderia ser encontrado na pagina “Tempo em Hrodna” http://rp5.by/84/pt.

<?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>Hrodna</point_name>
		<point_name_trim>Hrodna</point_name_trim>
		<point_name2>em Hrodna</point_name2>
		<point_timestamp>1337269493</point_timestamp>
		<gmt_add>3</gmt_add>
		<point_date>Thu, 17 May 2012 15:44:53 +0300</point_date>
		<point_date_time>2012-5-17 15:44 </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>O</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>O</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>N-Е</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>S-Е</wind_direction>
					<wind_velocity>2</wind_velocity>
					<falls>0</falls>
					<drops>0</drops>
				</timestep>
	</point>
</weather>

Os dados descarregados são previsões em cada um dos 4 momentos do dia no horário local.

Das 00:00 às 12:00 UTC são descarregadas previsões para:
hoje > dia,
amanhã > noite,
amanhã > dia,
depois de amanhã > noite.

Das 12:00 às 00:00 UTC:
amanhã > noite,
amanhã > dia,
depois de amanhã > noite,
depois de amanhã > dia.

Сondições de exportação obrigatórias

Este serviço é grátis. Pegue livremente os dados do endereço acima indicado e use no seu sítio. Não precisa pedir nem notificá-lo a NINGUÉM. O sítio importador deverá trazer junto das previsões visualizadas o nome e/ou o endereço (“Reliable Prognosis” e/ou rp5.by ) e o respetivo hiperlink. Não se admite menção a outros sítios de tempo na página em que são visualizadas nossas previsões. Os dados hão de ser fornecidos aos usuários somente sob forma de visualização no sítio importador acessível de fora durante as 24 horas por dia nos 7 dias por semana. Não se admite posterior transmissão de dados a partir do sítio importador sob forma de informadores de tempo, mensagens eletrônicas, SMS, ftp e demais modalidades de transmissão.

Um sítio e/ou um endereço IP poderá utilizar previsões para não mais de 50 (cinquenta) povoações.

No sítio receptor de previsões é necessário:

1. Escrever parser dos dados recebidos em qualquer linguagem de programação acessível (PHP, ASP, JSP etc). Ou seja, o script executado no seu servidor deverá pedir dados do nosso sítio (pedido GET). Em seguida, o script deverá converter os dados obtidos no formato XML em código HTML para serem colocados em uma página do seu sítio.

2. Сolocar junto às previsões o nome e/ou o endereço (“Reliable Prognosis” e/ou rp5.by ) e o hiperlink do nosso sítio. O hiperlink para as previsões em Hrodna tem de ser http://rp5.by/84/pt

3. Deletar menções a outros sítios de tempo da página em que são visualizadas nossas previsões.

Descrição dos dados

Método de transmissão dos parâmetros: GET.
Parâmetros GET do script: ID – valor do ID da povoação (P).

Descrição dos campos de dados

point_id – ID P no banco de dados do sítio
region_id – ID da região em que se situa P
country_id – ID do país em que se situa P
point name – nome completo da P. Por exemplo: “Dubrovka (município de Dubrovka)
point-name-trim – nome abreviado da P sem parênteses. Por exemplo, “Dubrovka”. point_name_trim corresponde a point_name até o parêntese aberto. Na ausência de parêntese, point_name_trim = point_name.
point_name2 – nome da P no caso prepositivo com preposição. Porexemplo: “em Dubrovka”. Usado em títulos do tipo “Tempo em Duybrovka” (“Tempo” + point_name2)
point_timestamp – unix-timestamp da data na P
gmt_add – deslocamento do UTC em horas, tendo em vista a passagem ao horário de verão/inverno
point_date – horário local na P na hora de criação do arquivo com indicação do gmt_add. Por exemplo: "Sun, 12 Dec 2004 13:00:25 +0300"
point_date_time – horário local na P na hora de criação do arquivo com os dados. Formato menos detalhado. Por exemplo: "2004-12-12 13:00"
time_step – índice temporal do previsão a partir de meia-noite (00:00 UTC) do dia corrente. Ex., time_step = 48 significam a previsão a 48 horas adiantados relativamente 00:00 UTC do dia corrente.
datetime – momento de previsão no horário local (data, hora, minuto)
G – momento de previsão no horário local. Por exemplo: “15”.
Hhii – momento de previsão em horas e minutos, horário local. Por exemplo: “15:00”
cloud_cover – nebulosidade (%)
precipitation – espessura das precipitações (mm) acumuladas em 4 horas antes do momento acima indicado.Por exemplo, se G = 15 horas, significa que as precipitações estiveram sendo acumuladas das 11 às 15 horas. Portanto, é preferível colocar na visualização o valor das precipitações entre momentos de tempo contíguos, diferentemente dos demais parâmetros.
pressure – pressão atmosférica
temperature – temperatura do ar
humidity – umidade relativa do ar (%)
wind_direction – direção do vento (N – norte, SE – sudeste etc). A indicação mostra DONDE sopra o vento. Por exemplo: o vento norte sopra do Norte.
wind_velocity – velocidade do vento
falls – tipo de precipitação (0 – ausência de precipitação; 2 – chuva com neve); 3 – neve)
drops – coeficiente da quantidade dos flocos de neve ou gotas de chuva para visualização. Valores possíveis: 0.5, 1, 2, 3, 4, 5, 6, 7, 8. Quanto maior este índice, a quantidade ou tamanho das gotas ou cristais de neve deve ser maior.

Perguntas de desenvolvedores WEB

1) Com que frequência são atualizadas as previsões e a que horas?

V. resposta na página Perguntas frequentes.

 Qual a melhor hora para recolher (importar) previsões?

Para que seu sítio mostre as previsões mais atualizadas, basta importar os dados 4 vezes por dia depois das:
00:15 UTC
04:15 UTC
12:15 UTC
16:15 UTC

Às 00:00 e às 12:00 UTC, o esquema de momentos de transmissão muda:
hoje tarde (12:00 UTC); amanhã noite (00:00 UTC); amanhã dia (12:00 UTC); depois de amanhã noite (00:00 UTC);
amanhã noite (00:00 UTC); amanhã dia (12:00 UTC); depois de amanhã noite (00:00 UTC); depois de amanhã dia (12:00 UTC), respetivamente.

Previsões no nosso banco de dados para os próximos dois dias são renovadas às 04:00 e ás 16:00 UTC.

15 minutos são acrescidos para a eventualidade de uma delonga ou dessincronização entre nosso sítio e o sítio importador.

3) Será possível obter um conjunto de previsões completo e não reduzido?

Sim, é possível. Poderá receber para qualquer das povoações desejadas um conjunto completo de previsões renovável duas vezes por dia. Esses dados são disponibilizados a um preço mensal de um dólar por uma povoação.

Enquanto a marcação gratuita oferece 4 oportunidades de previsão, já a paga, 24. A marcação paga abrange tudo quanto aparece nas tabelas no nosso sítio com relação a uma povoação dada. V. por exemplo, http://rp5.by/84/pt correspondendo 24 momentos às 24 colunas da tabela. De manhã, ou seja, até as 06:00 UTC estão abertas na tabela as 24 colunas. Durante o dia, as colunas desatualizadas, ou seja, cuja duração acabou, são fechadas. Por isso, na hora em que o usuário vir consultas, verá, possivelmente na tabela não as 24 e sim 23 ou 22 colunas.

As previsões são completamente renovadas duas vezes por dia: às 05:00 e às 17:00 UTC.

Observação importante: as condições de exportação acima aplicam-se em igual medida à marcação reduzida e à marcação completa (paga) de previsões.

V. adicionalmente Parâmetros e Perguntas frequentes