Referência da API
Três APIs com uma só chave. Comece pelo primeiro cartão se ainda não fez nenhuma chamada; os outros três são a referência dos endpoints, separada por produto para que cada uma continue pesquisável por si.
URL de base. Meteorologia e Clima são servidos a partir de https://api.climatememory.com, os Graus-dia a partir de https://api.climatememory.com. Autentique-se com um cabeçalho X-API-Key em cada pedido; todos os endpoints são GET.
Começar
Faça a sua primeira chamada à API Climate Memory em menos de um minuto: obtenha uma chave, autentique-se, perceba os créditos e os limites de ritmo, e trate os erros. Meteorologia, graus-dia e clima com uma só chave.
11 secções →API Meteorologia
Referência completa da API Meteorologia: previsão e condições atuais para qualquer coordenada ou cidade, todos os campos com a sua unidade, a cascata de modelos de 1,3 km a 28 km, mais ensembles, qualidade do ar, neve, mar e rios.
10 secções →API Graus-dia
Referência completa da API Graus-dia: graus-dia de aquecimento e de arrefecimento a partir do ERA5-Land desde 1950, qualquer temperatura de base, quatro métodos de cálculo incluindo a norma francesa Costic, exportação CSV e o arquivo horário.
12 secções →API Clima
Referência completa da API Clima: 87 anos de clima diário para cada ponto de terra firme do planeta desde 1940, agregados mensais, normais OMM 1991–2020 e 1961–1990, recordes, tendências de aquecimento e Köppen-Geiger, na grelha ERA5.
6 secções →Todos os endpoints
Uma só tabela, todos os caminhos dos dois anfitriões, com o que custam e onde estão documentados. Ctrl+F aqui, ou / para a paleta de pesquisa.
| Caminho | Função | Scope | Créditos | Documentado em | Anfitrião |
|---|---|---|---|---|---|
/v1/geocode | Resolve um nome de lugar em coordenadas, altitude e fuso horário. | qualquer chave | 0 | Geocodificação | api.climatememory.com |
/v1/cities/search | Pesquisa de nomes antiga. Corresponde apenas ao nome ASCII e ordena por população. | qualquer chave | 0 | Consulta de cidades | api.climatememory.com |
/v1/cities/nearest | A cidade catalogada mais próxima de uma coordenada. | qualquer chave | 0 | Consulta de cidades | api.climatememory.com |
/v1/attribution | A formulação exigida, exata e legível por máquina. Sem chave. | — | 0 | Atribuição e licenciamento | api.climatememory.com |
/v1/licensing | A tabela de licenças por trás de cada conjunto de dados. Sem chave. | — | 0 | Atribuição e licenciamento | api.climatememory.com |
/v1/forecast | Previsão horária e diária para uma coordenada arbitrária. | meteo | 1 | Previsão | api.climatememory.com |
/v1/forecast/city/{country}/{slug} | A mesma resposta, resolvida através do catálogo de cidades. | meteo | 1 | Previsão por cidade | api.climatememory.com |
/v1/current | As condições neste momento para uma coordenada, interpoladas entre passos do modelo. | meteo | 1 | Condições atuais | api.climatememory.com |
/v1/current/city/{country}/{slug} | O mesmo, através do catálogo de cidades. | meteo | 1 | Condições atuais | api.climatememory.com |
/v1/fields | A mesma tabela em JSON, com as unidades e quais os campos por omissão. Sem chave. | — | 0 | Referência dos campos | api.climatememory.com |
/v1/models | Que modelos estão em serviço, o que cada um cobre e quão fresco é. Sem chave. | — | 0 | Modelos e resolução | api.climatememory.com |
/v1/probability | Percentis e probabilidades de chuva a partir do ensemble de 51 membros do ECMWF. | meteo | 1 | Probabilidades de ensemble | api.climatememory.com |
/v1/air-quality | Partículas, ozono, NO₂, SO₂, CO e poeiras do Sara, do Copernicus CAMS. | meteo | 1 | Qualidade do ar | api.climatememory.com |
/v1/marine | Altura, direção e período das ondas a partir do modelo de ondas do ECMWF, em todo o mundo, até 10 dias. | meteo | 1 | Mar — estado do mar | api.climatememory.com |
/v1/hydrology | Caudal dos rios a partir do Copernicus GloFAS numa rede hidrográfica de 0,05°, até 10 dias. | meteo | 1 | Rios | api.climatememory.com |
/v1/degree-days | Graus-dia de aquecimento e de arrefecimento para uma coordenada. | dju | 2, +1 por cada período completo de 365,25 dias do intervalo | Graus-dia | api.climatememory.com |
/v1/degree-days?base=15,15.5,18,18.5,20 | Até 60 temperaturas de base numa só chamada, ao preço de uma. | dju | same as one base | Muitas bases, um pedido, um preço | api.climatememory.com |
/v1/degree-days/compare-methods | Os quatro métodos sobre o mesmo período, lado a lado. | dju | 2, +1 por cada período completo de 365,25 dias do intervalo | Métodos de cálculo | api.climatememory.com |
/v1/methods | As definições dos métodos e as suas predefinições. Sem chave. | — | 0 | Métodos de cálculo | api.climatememory.com |
/v1/degree-days/city/{country}/{slug} | O mesmo, com o fuso horário da cidade e a sua correção de ilha de calor urbana. | dju | 2, +1 por cada período completo de 365,25 dias do intervalo | Graus-dia por cidade | api.climatememory.com |
/v1/degree-days?elevation={metres} | Correção de gradiente térmico da altitude da célula para a sua. | dju | same | Graus-dia para o seu edifício, não para a célula da grelha | api.climatememory.com |
/v1/cells/resolve | Que célula responderia por um ponto, e a que distância está. | dju | 1 | Fixar uma célula, para que uma referência continue comparável | api.climatememory.com |
/v1/degree-days/cell/{cell_id} | Graus-dia para uma célula nomeada — sem procura da célula mais próxima, nunca. | dju | 2, +1 por cada período completo de 365,25 dias do intervalo | Fixar uma célula, para que uma referência continue comparável | api.climatememory.com |
/v1/degree-days?breakdown={daily|weekly|monthly|yearly} | Agregar o mesmo pedido ao período em que o seu contrato se liquida. | dju | same | Períodos de detalhe | api.climatememory.com |
/v1/degree-days/monthly | Doze totais mensais de um ano de calendário, sem série diária. | dju | 2 | Totais mensais de um ano | api.climatememory.com |
/v1/coverage | O que o arquivo tem: primeiro e último dia com dados, e o eixo em que vai crescer. Sem chave. | — | 0 | Totais mensais de um ano | api.climatememory.com |
/v1/degree-days?format=csv | As linhas do detalhe como ficheiro CSV. Só planos pagos. | dju | 4× the JSON call | Exportação CSV | api.climatememory.com |
/v1/historical | O arquivo de reanálise servido em cru: meteorologia horária desde 1950. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Histórico horário | api.climatememory.com |
/v1/historical/city/{country}/{slug} | Idêntico, com o fuso horário da cidade e a correção de ilha de calor. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Histórico por cidade | api.climatememory.com |
/v1/historical/variables | O que o arquivo tem neste momento, com unidades, e quais os campos derivados. Sem chave. | — | 0 | Variáveis disponíveis | api.climatememory.com |
/v1/climate/daily | Treze campos diários para qualquer coordenada de terra firme, de 1940 à semana passada. | climate | 2, +1 por cada período completo de 365,25 dias do intervalo | Clima diário | api.climatememory.com |
/v1/climate/monthly | Os mesmos campos agregados por mês de calendário. | climate | 2, +1 por cada período completo de 365,25 dias do intervalo | Agregados mensais | api.climatememory.com |
/v1/climate/summary | Normais mensais, série anual, recordes, tendências e Köppen — sem limite de intervalo. | climate | 3, +1 por cada período completo de 365,25 dias do intervalo | O clima de um lugar, numa só chamada | api.climatememory.com |
/v1/climate/normals | Uma média de trinta anos sobre um período de referência da OMM. | normals | 3 | Normais OMM | api.climatememory.com |
/v1/climate/normals/compare | Os dois períodos OMM e a variação entre eles, numa só chamada. | normals | 6 | Comparar duas normais | api.climatememory.com |
/v1/climate/coverage | O run que está a ser servido e as datas que abrange. Sem chave. | — | 1 | Cobertura, campos e células | api.climatememory.com |
/v1/climate/fields | A que este run sabe responder, com unidades, e quais os campos derivados. Sem chave. | — | 1 | Cobertura, campos e células | api.climatememory.com |
/v1/climate/cells/resolve | Que célula responde por um ponto, e a que distância está. | climate | 1 | Cobertura, campos e células | api.climatememory.com |
/v1/climate/licensing | Os termos de licença deste arquivo. Sem chave. | — | 0 | Cobertura, campos e células | api.climatememory.com |
Para agentes e assistentes de código
Dois ficheiros, gerados a partir da mesma fonte que estas páginas, pelo que não podem divergir do que está a ler:
- /llms.txt — a orientação curta: a que responde cada produto, e quando recorrer a qual.
- /llms-full.txt — toda esta referência num único ficheiro Markdown, com todos os endpoints, parâmetros e ressalvas.
Cada serviço publica também um esquema OpenAPI 3.1 e uma interface navegável: /v1/openapi-weather.json e /v1/docs/weather, /v1/openapi-degree-days.json e /v1/docs/degree-days, /v1/openapi-climate.json e /v1/docs/climate, /v1/openapi-geocoding.json e /v1/docs/geocoding. Gere a partir deles um cliente tipado em qualquer linguagem, em vez de escrever um à mão.