Dados da Previsão de Tempo, IUV e Ondas do CPTEC/INPE no formato XML puro
Os dados da Previsão de Tempo, IUV e Ondas em XML possibilita a recuperação de informações atualizadas do CPTEC/INPE para sua localidade. Através deles é possível incorporá-los em seu web site ou aplicação cliente.
Os dados em XML do CPTEC/INPE são gerados dinamicamente, baseados no código de identificação da localidade e, em alguns casos, na especificação da localização geográfica (latitude e longitude) da localidade.
Esta página descreve o formato da URL para requisição dos dados do CPTEC/INPE e a resposta em XML, para desenvolvedores. Está detalhada nas seguintes seções:
Sumário
A requisição dos dados em XML do CPTEC/INPE é feita através de uma URL, que na maioria das vezes deve ter o código da localidade desejada embutido em seu conteúdo. Porém, existem exceções a essa regra, que serão detalhadas nas próximas seções.
Busca de localidades
A requisição dos dados de localidades do CPTEC/INPE abrange todos os municípios brasileiros e outros locais que têm importância econômica ou turística no qual o CPTEC/INPE cobre com previsão de tempo e outros produtos relacionados. A URL base para a requisição é a seguinte:
http://servicos.cptec.inpe.br/XML/listaCidades
e adicionalmente à URL, deve-se utilizar o parâmetro city. O parâmetro city corresponde ao nome da localidade desejada, sem acentos, caso existam e mantendo os espaços do nome, caso existam também. Por exemplo, a busca pela cidade de São Paulo e outras cidades que seu nome comece com o prefixo "São Paulo" ficaria assim na URL de requisição:
http://servicos.cptec.inpe.br/XML/listaCidades?city=sao paulo
ou ainda utilizando o caracter espaço codificado no formato de URL (%20)
http://servicos.cptec.inpe.br/XML/listaCidades?city=sao%20paulo
O retorno dessa requisição será uma lista de localidades que forem localizadas com o prefixo passado no parâmetro, em um arquivo em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Busca de Localidades.
Parâmetro da requisição
| Parâmetro |
Descrição |
Exemplo |
| city |
Localidade(s) a ser(em) buscada(s) |
city=rio de janeiro |
Topo
Situação nas Estações de Superfície dos Aeroportos
A requisição dos dados de estações de superfície dos aeroportos (Metar), codificados e disponibilizados pela rede de meteorologia do comando da aeronáutica − REDEMET − é feita através de uma URL que deve ter o código da estação fazendo parte deste endereço.
Estes dados são coletados de uma em uma hora e ou horários intermediários (caso esteja ocorrendo algum evento especial). A URL para realizar essa requisição é tal como se segue:
http://servicos.cptec.inpe.br/XML/estacao/codigo_da_estacao/condicoesAtuais.xml
onde o codigo_da_estacao deve ser substituído pelo código da estação meteorológica de superfície desejada. A lista das estações meteorológicas de superfície está disponível na seção Estações de Superfície dos Aeroportos. Abaixo segue um exemplo prático de uma requisição de dados Metar:
http://servicos.cptec.inpe.br/XML/estacao/SBGR/condicoesAtuais.xml
Essa requisição trará dados da estação de superfície do Aeroporto de Cumbica, em Guarulhos/SP, representado pela sigla SBGR.
Em geral, o retorno dessa requisição será as informações mais recentes relativas à estação meteorológica de superfície desejadada, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Situação nas Estações de Superfície dos Aeroportos.
Topo
Condições meteorológicas atuais das capitais
A requisição dos dados das condições meteorológicas atuais das capitais dos estados brasileiros retorna uma lista de informações atualizadas de hora em hora, relativas aos dados das Estações de Superfície dos Aeroportos, semelhantes à seção anterior, porém, listando apenas os dados Metar dos aeroportos localizados nas capitais.
A URL para requisição dos dados das condições meteorológicas atuais das capitais é a seguinte:
http://servicos.cptec.inpe.br/XML/capitais/condicoesAtuais.xml
O retorno dessa requisição será as informações mais recentes relativas à estação meteorológica de superfície, nas capitais brasileiras, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Condições atuais das capitais.
Topo
Previsão de tempo para 4 dias
Os dados da Previsão de tempo para os próximos 4 dias do CPTEC/INPE está disponível para todos os munípios brasileiros e outros locais que têm importância econômica ou turística no qual o CPTEC/INPE cobre com a previsão de tempo.
Para realizar a requisição desses dados se faz necessário conhecer o código do município ou localidade que se deseja consultar.
O código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo, no qual recomendamos o uso do mecanismo de Busca de localidades para o levantamento desta informação.
Tendo posse do código da localidade é possível formar a URL para requisição dos dados, da forma que se segue:
http://servicos.cptec.inpe.br/XML/cidade/codigo_da_localidade/previsao.xml
onde o codigo_da_localidade deve ser substituído pelo código do município ou localidade desejado. Como exemplo, usaremos a cidade de São Paulo/SP, que tem como código identificador o número 244. A URL da requisição ficará assim:
http://servicos.cptec.inpe.br/XML/cidade/244/previsao.xml
O retorno dessa requisição será as informações acerca da previsão de tempo para os próximos 4 dias (pode variar de acordo com o horário do dia, podendo apresentar a previsão para o dia atual e os próximos 3 dias) para a localidade escolhida, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Previsão de tempo.
Topo
Previsão de tempo para 7 dias
Os dados da Previsão de tempo para os próximos 7 dias do CPTEC/INPE está disponível para todos os munípios brasileiros e outros locais que têm importância econômica ou turística no qual o CPTEC/INPE cobre com a previsão de tempo.
Para realizar a requisição desses dados se faz necessário conhecer o código do município ou localidade que se deseja consultar.
O código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo, no qual recomendamos o uso do mecanismo de Busca de localidades para o levantamento desta informação.
Tendo posse do código da localidade é possível formar a URL para requisição dos dados, da forma que se segue:
http://servicos.cptec.inpe.br/XML/cidade/7dias/codigo_da_localidade/previsao.xml
onde o codigo_da_localidade deve ser substituído pelo código do município ou localidade desejado. Como exemplo, usaremos a cidade de São Paulo/SP, que tem como código identificador o número 244. A URL da requisição ficará assim:
http://servicos.cptec.inpe.br/XML/cidade/7dias/244/previsao.xml
Existe também a possibilidade de obter os dados da Previsão de tempo para os próximos 7 dias do CPTEC/INPE através da especificação das medidas geográficas, latitude e longitude. Assim, os dados retornados serão referentes aos dados da localidade ou município mais próxima da latitude e longitude especificada. Vale ressaltar que para que a requisição funcione corretamente é necessário especificar valores válidos para a latitude
(de 0° a 90° para norte [+] ou para sul [-], tendo como ponto de referência a linha do Equador) e para a longitude(de 0° a 180° para leste [+] ou para oeste [-], tendo como ponto de referência o meridiano de Greenwich). Como o Brasil localiza-se no hemisfério sul e no ocidente, tanto a latitude quanto a longitude das localidades têm valores negativos. Por exemplo, se requisitarmos os dados para a latitude 22°90'S (-22.90) e longitude 47°06'W (-47.06) serão obtidos os dados da cidade de Campinas/SP. Assim, URL dessa requisição ficaria como se segue:
http://servicos.cptec.inpe.br/XML/cidade/7dias/-22.90/-47.06/previsaoLatLon.xml
O retorno dessa requisição será as informações acerca da previsão de tempo para os próximos 7 dias (pode variar de acordo com o horário do dia, podendo apresentar a previsão para o dia atual e os próximos 6 dias) para a localidade escolhida, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Previsão de tempo.
Topo
Previsão de tempo estendida
Os dados da Previsão de tempo estendida do CPTEC/INPE está disponível para todos os munípios brasileiros e outros locais que têm importância econômica ou turística no qual o CPTEC/INPE cobre com a previsão de tempo.
A previsão estendida é estimada automaticamente pelo modelo numérico Ensemble, que faz uma previsão para os 7 dias posteriores aos 7 próximos dias previstos pelos meteorologistas. Ou seja, é uma previsão que alcança 2 semanas após o dia atual.
Para realizar a requisição desses dados se faz necessário conhecer o código do município ou localidade que se deseja consultar.
O código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo, no qual recomendamos o uso do mecanismo de Busca de localidades para o levantamento desta informação.
Tendo posse do código da localidade é possível formar a URL para requisição dos dados, da forma que se segue:
http://servicos.cptec.inpe.br/XML/cidade/codigo_da_localidade/estendida.xml
onde o codigo_da_localidade deve ser substituído pelo código do município ou localidade desejado. Como exemplo, usaremos a cidade de São Paulo/SP, que tem como código identificador o número 244. A URL da requisição ficará assim:
http://servicos.cptec.inpe.br/XML/cidade/244/estendida.xml
Existe também a possibilidade de obter os dados da Previsão de tempo para os próximos 7 dias do CPTEC/INPE através da especificação das medidas geográficas, latitude e longitude. Assim, os dados retornados serão referentes aos dados da localidade ou município mais próxima da latitude e longitude especificada. Vale ressaltar que para que a requisição funcione corretamente é necessário especificar valores válidos para a latitude
(de 0° a 90° para norte [+] ou para sul [-], tendo como ponto de referência a linha do Equador) e para a longitude(de 0° a 180° para leste [+] ou para oeste [-], tendo como ponto de referência o meridiano de Greenwich). Como o Brasil localiza-se no hemisfério sul e no ocidente, tanto a latitude quanto a longitude das localidades têm valores negativos. Por exemplo, se requisitarmos os dados para a latitude 22°71'S (-22.71) e longitude 45°11'W (-45.11) serão obtidos os dados da cidade de Lorena/SP. Assim, URL dessa requisição ficaria como se segue:
http://servicos.cptec.inpe.br/XML/cidade/-22.71/-45.11/estendidaLatLon.xml
O retorno dessa requisição será as informações acerca da previsão de tempo para os 7 dias após os próximos 7 dias (pode variar de acordo com o horário do dia, podendo apresentar a previsão para os próximos 6 dias) para a localidade escolhida, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Previsão de tempo.
Topo
Condições atuais de incidência de radiação UV
Os dados das condições atuais de incidência de radiação UV do CPTEC/INPE está disponível para todos os munípios brasileiros e outros locais que têm importância econômica ou turística no qual o CPTEC/INPE cobre com o monitoramento da incidência da radiação UV.
Para realizar a requisição desses dados se faz necessário conhecer o código do município ou localidade que se deseja consultar.
O código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo, no qual recomendamos o uso do mecanismo de Busca de localidades para o levantamento desta informação.
Tendo posse do código da localidade é possível formar a URL para requisição dos dados, da forma que se segue:
http://servicos.cptec.inpe.br/XML/cidade/codigo_da_localidade/condicoesAtuaisUV.xml
onde o codigo_da_localidade deve ser substituído pelo código do município ou localidade desejado. Como exemplo, usaremos a cidade de São Paulo/SP, que tem como código identificador o número 244. A URL da requisição ficará assim:
http://servicos.cptec.inpe.br/XML/cidade/244/condicoesAtuaisUV.xml
O retorno dessa requisição será as informações acerca das últimas informações sobre o índice UV para a localidade escolhida, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Condições atuais de UV.
Topo
Previsão de Ondas para localidades litorâneas (dia atual, manhã, tarde e noite)
Os dados da previsão de ondas para o dia atual, do CPTEC/INPE, está disponível para todos os municípios litorâneos brasileiros outras e localidades que tenham importância econômica ou turística, no qual o CPTEC/INPE cobre com a previsão oceânica.
Para realizar a requisição desses dados, se faz necessário conhecer o código do município ou localidade litorânea que se deseja consultar.
O código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo, no qual recomendamos o uso do mecanismo de Busca de localidades para o levantamento desta informação.
No entanto, na Resposta XML > Busca de Localidades não traz nenhuma informação que indique se determinado munícipio ou localidade é ou não é uma cidade litorânea, devendo essa informação ser de conhecimento prévio do usuário.
Tendo posse do código da localidade é possível formar a URL para requisição dos dados, da forma que se segue:
http://servicos.cptec.inpe.br/XML/cidade/codigo_da_localidade/dia/dia/ondas.xml
onde o codigo_da_localidade deve ser substituído pelo código do município ou localidade desejado. Como exemplo, usaremos a cidade do Rio de Janeiro/RJ, que tem como código identificador o número 241. O parâmetro dia também deve ser trocado, por um valor inteiro, que vai de 0 a 2; o valor do parâmetro "0" equivale ao dia atual, "1" para a previsão de ondas para amanhã e "2" para a previsão de depois de amanhã. A URL da requisição ficará assim:
http://servicos.cptec.inpe.br/XML/cidade/241/dia/0/ondas.xml
O retorno dessa requisição será as informações acerca da previsão de ondas para o dia atual da localidade escolhida, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Previsão de Ondas para o dia atual em localidades litorâneas.
Topo
Previsão de Ondas para localidades litorâneas (6 dias, 8 horários por dia)
Os dados da previsão de ondas do CPTEC/INPE está disponível para todos os municípios litorâneos brasileiros outras e localidades que tenham importância econômica ou turística, no qual o CPTEC/INPE cobre com a previsão oceânica.
Para realizar a requisição desses dados, se faz necessário conhecer o código do município ou localidade litorânea que se deseja consultar.
O código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo, no qual recomendamos o uso do mecanismo de Busca de localidades para o levantamento desta informação.
No entanto, na Resposta XML > Busca de Localidades não traz nenhuma informação que indique se determinado munícipio ou localidade é ou não é uma cidade litorânea, devendo essa informação ser de conhecimento prévio do usuário.
Tendo posse do código da localidade é possível formar a URL para requisição dos dados, da forma que se segue:
http://servicos.cptec.inpe.br/XML/cidade/codigo_da_localidade/todos/tempos/ondas.xml
onde o codigo_da_localidade deve ser substituído pelo código do município ou localidade desejado. Como exemplo, usaremos a cidade do Rio de Janeiro/RJ, que tem como código identificador o número 241. A URL da requisição ficará assim:
http://servicos.cptec.inpe.br/XML/cidade/241/todos/tempos/ondas.xml
O retorno dessa requisição será as informações acerca da previsão de ondas para o dia atual e os próximos 5 dias da localidade escolhida, com saída em XML puro. Veja os elementos contidos no XML de resposta e outros dados adicionais na seção Resposta XML > Previsão de Ondas para 6 dias em localidades litorâneas.
Topo
Busca de localidades
Elementos 'Cidades'
A resposta da requisição de Busca de localidades traz informações acerca da(s) localidade(s) desejada(s), tal como seu nome, a UF que essa(s) localidade(s) pertence(m) e o código da(s) localidade(s). A resposta vem no formato de um arquivo em XML puro. Na tabela a seguir é possível visualizar detalhes de cada ítem existente no nó 'cidades' do arquivo XML de retorno:
| Elemento |
Descrição |
| nome |
Nome do munícipio ou localidade encontrada |
| uf |
Sigla da Unidade da Federação a qual o município/localidade pertence. Exemplo: RS (Rio Grande do Sul). |
| id |
Código do município ou localidade que são cobertos pelo CPTEC/INPE é representado por um número inteiro positivo. |
Topo
Situação nas Estações Meteorológicas
A resposta da requisição da Situação nas Estações Meteorológicas tem como retorno os dados das estações de superfície dos aeroportos (Metar), codificados e disponibilizados pela rede de meteorologia do comando da aeronáutica − REDEMET. Os ítens contidos na resposta da requisição, dentro do nó principal <metar> do arquivo XML estão detalhados na tabela a seguir:
| Elemento |
Descrição |
| codigo |
Sigla de quatro letras que representa a estação meteorológica de superfície. Veja Estações de Superfície dos Aeroportos. |
| atualizacao |
Data e hora da última atualização dos dados da estação meteorológica de superfície, no formato dd/mm/aaaa hh:mm:ss. |
| pressao |
Pressão atmosférica medida na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| temperatura |
Temperatura (em graus celsius) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| tempo |
Sigla que representa a condição de tempo na estação meteorológica de superfície do aeroporto no momento da última atualização. O próximo elemento do arquivo XML complementa essa informação. |
| tempo_desc |
Descrição da sigla que representa a condição de tempo na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| umidade |
Umidade relativa do ar (em %) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| vento_dir |
Direção do vento em graus (de 0° a 360°) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| vento_int |
Intensidade do vento (em km/h) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| visibilidade |
Condição atual de visibilidade na estação (em metros). |
Topo
Condições meteorológicas atuais das capitais
A resposta da requisição das condições atuais das capitais traz como resposta os dados das estações meteorológicas de superfície de aeroportos das capitais dos estados brasileiros. Esses dados são os mesmos da Situação nas Estações Meteorológicas, diferenciando desse na organização e disposição, exibindo as estações dos aeroportos das capitais das UF do Brasil.
Elementos 'metar'
Os dados das condições meteorológicas atuais das capitais estão contidos dentro de nós <metar></metar> que, por sua vez, estão hierarquicamente abaixo do nó principal <capitais></capitais>. Na tabela abaixo segue a explicação de cada ítem componente dos nós <metar></metar>, que representa cada capital no arquivo XML.
| Elemento |
Descrição |
| codigo |
Sigla de quatro letras que representa a estação meteorológica de superfície. Veja Estações de Superfície dos Aeroportos. |
| atualizacao |
Data e hora da última atualização dos dados da estação meteorológica de superfície, no formato dd/mm/aaaa hh:mm:ss. |
| pressao |
Pressão atmosférica medida na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| temperatura |
Temperatura (em graus celsius) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| tempo |
Sigla que representa a condição de tempo na estação meteorológica de superfície do aeroporto no momento da última atualização. O próximo elemento do arquivo XML complementa essa informação. |
| tempo_desc |
Descrição da sigla que representa a condição de tempo na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| umidade |
Umidade relativa do ar (em %) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| vento_dir |
Direção do vento em graus (de 0° a 360°) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| vento_int |
Intensidade do vento (em km/h) na estação meteorológica de superfície do aeroporto no momento da última atualização. |
| visibilidade |
Condição atual de visibilidade na estação (em metros). |
Topo
Previsão de tempo para 4 dias
A resposta da requisição da Previsão de tempo para 4 dias tem como retorno as informações acerca da previsão de tempo para
os próximos 4 dias (pode variar de acordo com o horário do dia, podendo apresentar a previsão para o dia atual e os próximos 3 dias) para a localidade escolhida. Os elementos
do 1º. nível do arquivo XML apresentam informações sobre o município ou localidade selecionado(a) e o horário de atualização dos dados da previsão.
O conjunto de elementos 'previsao' dispõe os dados da previsão de tempo para cada dia, dispondo a condição de tempo, as temperaturas máxima e miníma e o IUV.
Todos estes estão detalhados na tabela a seguir:
Elementos do 1º nível
| Elemento |
Descrição |
| nome |
Nome do município ou localidade selecionado(a). |
| uf |
Sigla da Unidade da Federação a qual o município/localidade pertence. Exemplo: SP (São Paulo). |
| atualizacao |
Data da última atualização dos dados da previsão de tempo e índice ultravioleta do município ou localidade selecionado(a), no formato aaaa-mm-dd. |
Elementos 'previsao'
| Elemento |
Descrição |
| dia |
Dia referente aos dados da previsão de tempo e índice ultravioleta, no formato aaaa-mm-dd. |
| tempo |
Sigla que representa a condição de tempo na data referente no município ou localidade selecionado(a). Mais detalhes sobre as siglas que representam as condições do tempo você encontra na tabela de Siglas das condições do tempo. |
| maxima |
Temperatura máxima (em graus celsius) prevista para o município ou localidade selecionado(a) na data referente, representada por um valor inteiro. |
| minima |
Temperatura mínima (em graus celsius) prevista para o município ou localidade selecionado(a) na data referente, representada por um valor inteiro. |
| iuv |
O IUV representa o valor máximo diário da radiação ultravioleta, isto é, no período referente ao meio-dia solar, o horário de máxima intensidade de radiação solar. É representado por um valor real (número de ponto flutuante). |
Topo
Previsão de tempo para 7 dias
A resposta da requisição da Previsão de tempo para 7 dias tem como retorno as informações acerca da previsão de tempo para
os próximos 7 dias (pode variar de acordo com o horário do dia, podendo apresentar a previsão para o dia atual e os próximos 6 dias) para a localidade escolhida. Os elementos
do 1º nível do arquivo XML apresentam informações sobre o município ou localidade selecionado(a) e o horário de atualização dos dados da previsão.
O conjunto de elementos 'previsao' dispõe os dados da previsão de tempo para cada dia, dispondo a condição de tempo, as temperaturas máxima e miníma e o IUV.
Todos estes estão detalhados na tabela a seguir:
Elementos do 1º nível
| Elemento |
Descrição |
| nome |
Nome do município ou localidade selecionado(a). |
| uf |
Sigla da Unidade da Federação a qual o município/localidade pertence. Exemplo: MG (Minas Gerais). |
| atualizacao |
Data da última atualização dos dados da previsão de tempo e índice ultravioleta do município ou localidade selecionado(a), no formato aaaa-mm-dd. |
Elementos 'previsao'
| Elemento |
Descrição |
| dia |
Dia referente aos dados da previsão de tempo e índice ultravioleta, no formato aaaa-mm-dd. |
| tempo |
Sigla que representa a condição de tempo na data referente no município ou localidade selecionado(a). Mais detalhes sobre as siglas que representam as condições do tempo você encontra na tabela de Siglas das condições do tempo. |
| maxima |
Temperatura máxima (em graus celsius) prevista para o município ou localidade selecionado(a) na data referente, representada por um valor inteiro. |
| minima |
Temperatura mínima (em graus celsius) prevista para o município ou localidade selecionado(a) na data referente, representada por um valor inteiro. |
| iuv |
O IUV representa o valor máximo diário da radiação ultravioleta, isto é, no período referente ao meio-dia solar, o horário de máxima intensidade de radiação solar. É representado por um valor real (número de ponto flutuante). |
Topo
Previsão de tempo estendida
A resposta da requisição da Previsão de tempo estendida tem como retorno as informações acerca da previsão de tempo para os 7 dias
após os próximos 7 dias (pode variar de acordo com o horário do dia, podendo apresentar a previsão para os próximos 6 dias) para a localidade escolhida. Os elementos
do 1º nível do arquivo XML apresentam informações sobre o município ou localidade selecionado(a) e o horário de atualização dos dados da previsão.
O conjunto de elementos 'previsao' dispõe os dados da previsão de tempo para cada dia, dispondo a condição de tempo, as temperaturas máxima e miníma e o IUV.
Todos estes estão detalhados na tabela a seguir:
Elementos do 1º nível
| Elemento |
Descrição |
| nome |
Nome do município ou localidade selecionado(a). |
| uf |
Sigla da Unidade da Federação a qual o município/localidade pertence. Exemplo: MG (Minas Gerais). |
| atualizacao |
Data da última atualização dos dados da previsão de tempo e índice ultravioleta do município ou localidade selecionado(a), no formato aaaa-mm-dd. |
Elementos 'previsao'
| Elemento |
Descrição |
| dia |
Dia referente aos dados da previsão de tempo e índice ultravioleta, no formato aaaa-mm-dd. |
| tempo |
Sigla que representa a condição de tempo na data referente no município ou localidade selecionado(a). Mais detalhes sobre as siglas que representam as condições do tempo você encontra na tabela de Siglas das condições do tempo. |
| maxima |
Temperatura máxima (em graus celsius) prevista para o município ou localidade selecionado(a) na data referente, representada por um valor inteiro. |
| minima |
Temperatura mínima (em graus celsius) prevista para o município ou localidade selecionado(a) na data referente, representada por um valor inteiro. |
| iuv |
O IUV representa o valor máximo diário da radiação ultravioleta, isto é, no período referente ao meio-dia solar, o horário de máxima intensidade de radiação solar. É representado por um valor real (número de ponto flutuante). |
Topo
Condições atuais de incidência de radiação UV
A resposta da requisição das condições atuais do IUV traz como resposta os dados da incidência da radiação ultravioleta para o município ou localidade selecionado(a). Esses dados são atualizados de 15 em 15 minutos,
podendo assim transmitir a real situação da radiação UV na localidade. O arquivo XML de retorno exibe dentro do elemento principal <uv></uv> informações como o nome da localidade, a UF, a data, o horário da última atualização e o índice UV no momento. A tabela a seguir detalha cada um dos ítens descritos:
| Elemento |
Descrição |
| nome |
Nome do município ou localidade selecionado(a). |
| data |
Data referente aos dados da incidência da radiação ultravioleta, no formato dd/mm/aaaa. |
| uf |
Sigla da Unidade da Federação a qual o município/localidade pertence. Exemplo: PR (Paraná). |
| hora |
Horário da última atualização dos dados da sobre a radiação ultravioleta do município ou localidade selecionado(a). |
| iuv |
O IUV representa o valor da radiação ultravioleta no momento da última atualização. É representado por um valor numérico inteiro. |
Topo
Previsão de Ondas para localidades litorâneas (dia atual, manhã, tarde e noite)
A resposta da requisição da Previsão de Ondas para localidades litorâneas (dia atual, manhã, tarde e noite) tem como retorno as informações acerca da previsão de ondas para o dia atual da localidade litorânea escolhida. Os elementos
do 1º nível do arquivo XML apresentam informações sobre o município ou localidade litorânea(o) selecionado(a) e a data de atualização dos dados da previsão oceânica.
O conjunto de elementos 'manhã', 'tarde' e 'noite' mostra os dados da previsão de ondas para cada um desses períodos do dia, exibindo a data da previsão de ondas juntamente com o horário UTC (Zulu) da mesma, a agitação do mar, a altura das ondas em metros, a direção das ondas, a velocidade do vento (em km/h) e a direção do vento.
Todos estes estão detalhados na tabela a seguir:
Elementos do 1º nível
| Elemento |
Descrição |
| nome |
Nome do município ou localidade litorâneo(a) selecionado(a). |
| uf |
Sigla da Unidade da Federação a qual o município/localidade litorâneo(a) pertence. Exemplo: RJ (Rio de Janeiro). |
| atualizacao |
Data da última atualização dos dados da previsão oceânica do município ou localidade litorâneo(a) selecionado(a), no formato dd-mm-aaaa. |
Elementos 'manhã', 'tarde' e 'noite'
| Elemento |
Descrição |
| dia |
Dia e hora referente aos dados da previsão oceânica, no formato dd-mm-aaaa 12|18|21h Z, dependendo do elemento em questão. |
| agitacao |
Texto que exibe a agitação do mar no determinado período do dia. Pode ser Fraco, Moderado ou Forte. |
| altura |
Altura em metros das ondas no município ou localidade litorâneo(a) selecionado(a) no determinado período do dia, representada por um número decimal. |
| direcao |
Sigla do ponto cardeal, colateral ou subcolateral que indica a direção das ondas no município ou localidade litorâneo(a) selecionado(a) no determinado período do dia. |
| vento |
Velocidade do vento em km/h no determinado período do dia, no município ou localidade litorâneo(a) selecionado(a). |
| vento_dir |
Sigla do ponto cardeal, colateral ou subcolateral que indica a direção do vento no município ou localidade litorâneo(a) selecionado(a) no determinado período do dia. |
Você pode também ver a estrutura do XML em Exemplos > Estrutura arquivo XML previsão dia atual.
Topo
Previsão de Ondas para localidades litorâneas (6 dias, 8 horários por dia)
A resposta da requisição da Previsão de Ondas para localidades litorâneas (6 dias, 8 horários por dia) tem como retorno as informações acerca da previsão oceânica (ondas) para o dia atual e para
os próximos 5 dias para a localidade litorânea escolhida. Os elementos
do 1º nível do arquivo XML apresentam informações sobre o município ou localidade litorânea(o) selecionado(a) e a data de atualização dos dados da previsão oceânica.
O conjunto de elementos 'previsão' mostra os dados da previsão de ondas para cada um desses horários do dia, exibindo a data da previsão de ondas juntamente com o horário UTC (Zulu) da mesma, a agitação do mar, a altura das ondas em metros, a direção das ondas, a velocidade do vento (em km/h) e a direção do vento.
Todos estes estão detalhados na tabela a seguir:
Elementos do 1º nível
| Elemento |
Descrição |
| nome |
Nome do município ou localidade litorâneo(a) selecionado(a). |
| uf |
Sigla da Unidade da Federação a qual o município/localidade litorâneo(a) pertence. Exemplo: RJ (Rio de Janeiro). |
| atualizacao |
Data da última atualização dos dados da previsão oceânica do município ou localidade litorâneo(a) selecionado(a), no formato aaaa-mm-dd. |
Elementos 'previsão'
| Elemento |
Descrição |
| dia |
Dia e hora referente aos dados da previsão oceânica, no formato dd-mm-aaaa 00|03|06|09|12|15|18|21h Z, dependendo do horário em questão. |
| agitacao |
Texto que exibe a agitação do mar no determinado período do dia. Pode ser Fraco, Moderado ou Forte. |
| altura |
Altura em metros das ondas no município ou localidade litorâneo(a) selecionado(a) no determinado período do dia, representada por um número decimal. |
| direcao |
Sigla do ponto cardeal, colateral ou subcolateral que indica a direção das ondas no município ou localidade litorâneo(a) selecionado(a) no determinado período do dia. |
| vento |
Velocidade do vento em km/h no determinado período do dia, no município ou localidade litorâneo(a) selecionado(a). |
| vento_dir |
Sigla do ponto cardeal, colateral ou subcolateral que indica a direção do vento no município ou localidade litorâneo(a) selecionado(a) no determinado período do dia. |
Você pode também ver a estrutura do XML em Exemplos > Estrutura arquivo XML previsão 6 dias.
Topo
Siglas das condições do tempo
| Sigla |
Descrição |
| ec |
Encoberto com Chuvas Isoladas |
| ci |
Chuvas Isoladas |
| c |
Chuva |
| in |
Instável |
| pp |
Poss. de Pancadas de Chuva |
| cm |
Chuva pela Manhã |
| cn |
Chuva a Noite |
| pt |
Pancadas de Chuva a Tarde |
| pm |
Pancadas de Chuva pela Manhã |
| np |
Nublado e Pancadas de Chuva |
| pc |
Pancadas de Chuva |
| pn |
Parcialmente Nublado |
| cv |
Chuvisco |
| ch |
Chuvoso |
| t |
Tempestade |
| ps |
Predomínio de Sol |
| e |
Encoberto |
| n |
Nublado |
| cl |
Céu Claro |
| nv |
Nevoeiro |
| g |
Geada |
| ne |
Neve |
| nd |
Não Definido |
| pnt |
Pancadas de Chuva a Noite |
| psc |
Possibilidade de Chuva |
| pcm |
Possibilidade de Chuva pela Manhã |
| pct |
Possibilidade de Chuva a Tarde |
| pcn |
Possibilidade de Chuva a Noite |
| npt |
Nublado com Pancadas a Tarde |
| npn |
Nublado com Pancadas a Noite |
| ncn |
Nublado com Poss. de Chuva a Noite |
| nct |
Nublado com Poss. de Chuva a Tarde |
| ncm |
Nubl. c/ Poss. de Chuva pela Manhã |
| npm |
Nublado com Pancadas pela Manhã |
| npp |
Nublado com Possibilidade de Chuva |
| vn |
Variação de Nebulosidade |
| ct |
Chuva a Tarde |
| ppn |
Poss. de Panc. de Chuva a Noite |
| ppt |
Poss. de Panc. de Chuva a Tarde |
| ppm |
Poss. de Panc. de Chuva pela Manhã |
Topo
Exemplos
Busca de localidades
O código abaixo é um exemplo da resposta da requisição de Busca de localidades, com base na URL http://servicos.cptec.inpe.br/XML/listaCidades?city=sao%20paulo.
<cidades>
<cidade>
<nome>São Paulo</nome>
<uf>SP</uf>
<id>244</id>
</cidade>
<cidade>
<nome>São Paulo das Missões</nome>
<uf>RS</uf>
<id>5019</id>
</cidade>
<cidade>
<nome>São Paulo de Olivença</nome>
<uf>AM</uf>
<id>5020</id>
</cidade>
<cidade>
<nome>São Paulo do Potengi</nome>
<uf>RN</uf>
<id>5021</id>
</cidade>
</cidades>
METAR
http://servicos.cptec.inpe.br/XML/estacao/SBGR/condicoesAtuais.xml
<metar>
<codigo>SBGR</codigo>
<atualizacao>08/08/2011 16:00:00</atualizacao>
<pressao>1017</pressao>
<temperatura>30</temperatura>
<tempo>cl</tempo>
<tempo_desc>Céu Claro</tempo_desc>
<umidade>35</umidade>
<vento_dir>300</vento_dir>
<vento_int>18</vento_int>
<visibilidade>>10000</visibilidade>
</metar>
Capitais
http://servicos.cptec.inpe.br/XML/capitais/condicoesAtuais.xml
<capitais>
<metar>
<codigo>SBAR</codigo>
<atualizacao>09/08/2011 11:00:00</atualizacao>
<pressao>1017</pressao>
<temperatura>28</temperatura>
<tempo>pn</tempo>
<tempo_desc>Parcialmente Nublado</tempo_desc>
<umidade>51</umidade>
<vento_dir>110</vento_dir>
<vento_int>20</vento_int>
<intensidade>>10000</intensidade>
</metar>
<metar>
<codigo>SBBE</codigo>
<atualizacao>09/08/2011 11:00:00</atualizacao>
<pressao>1013</pressao>
<temperatura>30</temperatura>
<tempo>n</tempo>
<tempo_desc>Nublado</tempo_desc>
<umidade>70</umidade>
<vento_dir>330</vento_dir>
<vento_int>9</vento_int>
<intensidade>>10000</intensidade>
</metar>
</capitais>
Previsão
http://servicos.cptec.inpe.br/XML/cidade/244/previsao.xml
<cidade>
<nome>São Paulo</nome>
<uf>SP</uf>
<atualizacao>2011-08-09</atualizacao>
<previsao>
<dia>2011-08-10</dia>
<tempo>n</tempo>
<maxima>18</maxima>
<minima>15</minima>
<iuv>6.0</iuv>
</previsao>
<previsao>
<dia>2011-08-11</dia>
<tempo>n</tempo>
<maxima>20</maxima>
<minima>13</minima>
<iuv>5.0</iuv>
</previsao>
<previsao>
<dia>2011-08-12</dia>
<tempo>ps</tempo>
<maxima>24</maxima>
<minima>11</minima>
<iuv>6.0</iuv>
</previsao>
<previsao>
<dia>2011-08-13</dia>
<tempo>ps</tempo>
<maxima>26</maxima>
<minima>14</minima>
<iuv>6.0</iuv>
</previsao>
</cidade>
Condições UV
http://servicos.cptec.inpe.br/XML/cidade/244/condicoesAtuaisUV.xml
<uv>
<nome>São Paulo</nome>
<uf>SP</uf>
<data>10/08/2011</data>
<hora>09h30</hora>
<iuv>1</iuv>
</uv>
Previsão Oceânica (Ondas) - dia atual
http://servicos.cptec.inpe.br/XML/cidade/241/dia/0/ondas.xml
<cidade>
<nome>Rio de Janeiro</nome>
<uf>RJ</uf>
<atualizacao>14-11-2013</atualizacao>
<manha>
<dia>14-11-2013 12h Z</dia>
<agitacao>Fraco</agitacao>
<altura>1.1</altura>
<direcao>SSW</direcao>
<vento>3.4</vento>
<vento_dir>S</vento_dir>
</manha>
<tarde>
<dia>14-11-2013 18h Z</dia>
<agitacao>Fraco</agitacao>
<altura>1.1</altura>
<direcao>SSW</direcao>
<vento>4.1</vento>
<vento_dir>SE</vento_dir>
</tarde>
<noite>
<dia>14-11-2013 21h Z</dia>
<agitacao>Fraco</agitacao>
<altura>1.1</altura>
<direcao>S</direcao>
<vento>4.5</vento>
<vento_dir>ESE</vento_dir>
</noite>
</cidade>
Previsão Oceânica (Ondas) - 6 dias, 8 horários por dia
http://servicos.cptec.inpe.br/XML/cidade/241/dia/0/ondas.xml
<cidade>
<nome>Rio de Janeiro</nome>
<uf>RJ</uf>
<atualizacao>2013-11-18</atualizacao>
<previsao>
<dia>18-11-2013 00h Z</dia>
<agitacao>Fraco</agitacao>
<altura>0.8</altura>
<direcao>E</direcao>
<vento>2.5</vento>
<vento_dir>SW</vento_dir>
</previsao>
<previsao>
<dia>18-11-2013 03h Z</dia>
<agitacao>Fraco</agitacao>
<altura>0.9</altura>
<direcao>ESE</direcao>
<vento>2.5</vento>
<vento_dir>WSW</vento_dir>
</previsao>
<previsao>
<dia>18-11-2013 06h Z</dia>
<agitacao>Fraco</agitacao>
<altura>0.9</altura>
<direcao>ESE</direcao>
<vento>2.9</vento>
<vento_dir>WSW</vento_dir>
</previsao>
<previsao>
<dia>18-11-2013 12h Z</dia>
<agitacao>Fraco</agitacao>
<altura>1.0</altura>
<direcao>SE</direcao>
<vento>2.5</vento>
<vento_dir>WSW</vento_dir>
</previsao>
(continua...)
</cidade>
Topo
Termos de uso
Os produtos apresentados nesta página não podem ser usados para propósitos comerciais, copiados integral ou parcialmente para a reprodução em meios de divulgação, sem a expressa autorização do CPTEC/INPE.
Os usuários deverão sempre mencionar a fonte das informações e dados como "CPTEC/INPE".
A geração e a divulgação de produtos operacionais obedecem critérios sistêmicos de controle de qualidade, padronização e periodicidade de disponibilização. Em nenhum caso o CPTEC/INPE pode ser responsabilizado por
danos especiais, indiretos ou decorrentes, ou nenhum dano vinculado ao que provenha do uso destes produtos.
Topo