PHPackages                             designerdigital/climalivre - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. designerdigital/climalivre

ActiveLibrary[API Development](/categories/api)

designerdigital/climalivre
==========================

a sua api do tempo

v2.0.0(1y ago)03MITPHP

Since Apr 18Pushed 1y ago1 watchersCompare

[ Source](https://github.com/DesignerDigital/climalivre)[ Packagist](https://packagist.org/packages/designerdigital/climalivre)[ RSS](/packages/designerdigital-climalivre/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

🌦️ API de Clima - Lumen
=======================

[](#️-api-de-clima---lumen)

Esta API fornece informações meteorológicas em tempo real utilizando a **Open-Meteo API** para geolocalização de cidades.

📌 Requisitos
------------

[](#-requisitos)

- PHP 8+
- Composer
- Lumen 10+
- Extensões **cURL** e **JSON** habilitadas

🚀 Instalação
------------

[](#-instalação)

Clone o repositório e instale as dependências:

```
# Clonar o projeto
git clone https://github.com/DesignerDigital/climalivre.git
cd climalivre

# Instalar dependências
composer install

## 🔥 Como Usar

Inicie o servidor local:

```sh
php -S localhost:8000 -t public
```

Agora, a API pode ser acessada via ****

🌍 Endpoints Disponíveis
-----------------------

[](#-endpoints-disponíveis)

### Testar a API

[](#testar-a-api)

```
GET /
```

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição)

```
curl -X GET "http://localhost:8000"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta)

```
{
	"status": "ok",
	"message": "Bem vindo ao Clima Livre a sua api do tempo.",
	"about": "credits from https://open-meteo.com/"
}
```

### Buscar o clima local busca por IP

[](#buscar-o-clima-local-busca-por-ip)

Observação: Este endpoint não retorna resultados se executado em servidor local.

porém você pode alterar o ClimaV1Controller.php:19 $response = $this->client->requisition('[http://ip-api.com/json/'.$request->ip()](http://ip-api.com/json/'.$request-%3Eip()), \[\], false); substituindo $request->ip() pelo seu ip [http://ip-api.com/json/{seu-ip}](http://ip-api.com/json/%7Bseu-ip%7D)'

```
GET /clima-local
```

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-1)

```
curl -X GET "http://localhost:8000/clima-local"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-1)

```
{
	"message": "Hoje o céu está limpo ou com poucas nuvens em Birigui, com 23°C e umidade de 60%. Aproveite a noite!",
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Buscar Clima Atual

[](#-buscar-clima-atual)

```
GET /climalivre/v1/hoje?city=birigui
```

```
GET /climalivre/v1/hoje?lat=-20.0&lng=15.5
```

Observações: Enviando a cidade, lat e lng, será priorizado a busca pela cidade, é necessário enviar valor da lat e lng para que a busca por coordenadas seja retornada com exito, caso falte um dos dois parametros a busca sera confirmada pela cidade padrão ou seja 'Brasilia'

#### 📥 Parâmetros:

[](#-parâmetros)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `city` | string | ❌ Não | Brasilia | Nome da cidade a ser consultada |
| `lat` | string | ❌ Não | null | Latitude a ser consultada |
| `lng` | string | ❌ Não | null | Longitude a ser consultada |

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-2)

```
curl -X GET "http://localhost:8000/climalivre/v1/hoje?city=birigui"

curl -X GET "http://localhost:8000/climalivre/v1/hoje?lat=-20.0&lng=15.5"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-2)

```
{
	"locate": "Birigui São Paulo - BR",
	"clima": {
		"temperature_2m": "22.8°C",
		"relative_humidity_2m": "60%",
		"is_day": false,
		"description": "Céu limpo",
		"weather_code": 0,
		"icon": "☀️",
		"cloud_cover": "o céu está limpo ou com poucas nuvens"
	},
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Previsão do tempo para os próximos 7 dias

[](#-previsão-do-tempo-para-os-próximos-7-dias)

```
GET /climalivre/v1/semana?city=birigui
```

#### 📥 Parâmetros:

[](#-parâmetros-1)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `city` | string | ❌ Não | Brasilia | Nome da cidade a ser consultada |

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-3)

```
curl -X GET "http://localhost:8000/climalivre/v1/semana?city=birigui"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-3)

```
{
	"locate": "Birigui São Paulo - BR",
	"results": [
		{
			"dia": "sexta-feira",
			"temperatura_2m_min": "18.9°C",
			"temperatura_2m_max": "32.2°C",
			"temperatura_aparente_min": "19°C",
			"temperatura_aparente_max": "35.7°C",
			"descricao_clima": "Parcialmente nublado",
			"icone_clima": "⛅",
			"duracao_sol": "11h 8min",
			"duracao_luz_dia": "12h 5min",
			"porcentagem_duracao_sol": "92.9%",
			"soma_precipitacao": "0mm",
			"probabilidade_precipitacao_valor_max": "5%",
			"precipitation_probability_max": "☀️ Sem chuva esperada",
			"precipitacao_horas": "0h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "25.28MJ/m²",
			"nascer_do_sol": "06:25",
			"por_do_sol": "18:31",
			"indice_uv_max": 8.4,
			"pancadas_chuva": "0mm",
			"velocidade_vento_10m_max": "17.4km/h",
			"direcao_vento_10m_dominante": "124°",
			"evotranspiracao": "5.61mm",
			"soma_neve": "0cm"
		},
		{
			"dia": "sábado",
			"temperatura_2m_min": "20.9°C",
			"temperatura_2m_max": "32.7°C",
			"temperatura_aparente_min": "22.5°C",
			"temperatura_aparente_max": "37.1°C",
			"descricao_clima": "Nublado",
			"icone_clima": "☁️",
			"duracao_sol": "11h 5min",
			"duracao_luz_dia": "12h 4min",
			"porcentagem_duracao_sol": "92.4%",
			"soma_precipitacao": "0.1mm",
			"probabilidade_precipitacao_valor_max": "35%",
			"precipitation_probability_max": "🌥️ Pode chover",
			"precipitacao_horas": "1h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "21.93MJ/m²",
			"nascer_do_sol": "06:26",
			"por_do_sol": "18:30",
			"indice_uv_max": 8.35,
			"pancadas_chuva": "0.1mm",
			"velocidade_vento_10m_max": "12.5km/h",
			"direcao_vento_10m_dominante": "73°",
			"evotranspiracao": "5mm",
			"soma_neve": "0cm"
		},
		{
			"dia": "domingo",
			"temperatura_2m_min": "22.3°C",
			"temperatura_2m_max": "30°C",
			"temperatura_aparente_min": "26.1°C",
			"temperatura_aparente_max": "34.7°C",
			"descricao_clima": "Tempestade",
			"icone_clima": "⛈️",
			"duracao_sol": "6h 0min",
			"duracao_luz_dia": "12h 3min",
			"porcentagem_duracao_sol": "50%",
			"soma_precipitacao": "12.8mm",
			"probabilidade_precipitacao_valor_max": "70%",
			"precipitation_probability_max": "🌧️ Provável chuva",
			"precipitacao_horas": "13h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "16.02MJ/m²",
			"nascer_do_sol": "06:26",
			"por_do_sol": "18:29",
			"indice_uv_max": 8.3,
			"pancadas_chuva": "12.8mm",
			"velocidade_vento_10m_max": "11.3km/h",
			"direcao_vento_10m_dominante": "46°",
			"evotranspiracao": "3.34mm",
			"soma_neve": "0cm"
		},
		{
			"dia": "segunda-feira",
			"temperatura_2m_min": "22.4°C",
			"temperatura_2m_max": "29.3°C",
			"temperatura_aparente_min": "25.8°C",
			"temperatura_aparente_max": "33.9°C",
			"descricao_clima": "Tempestade com granizo",
			"icone_clima": "⛈️",
			"duracao_sol": "10h 46min",
			"duracao_luz_dia": "12h 1min",
			"porcentagem_duracao_sol": "89.8%",
			"soma_precipitacao": "11.3mm",
			"probabilidade_precipitacao_valor_max": "83%",
			"precipitation_probability_max": "⛈️ Alta chance de chuva",
			"precipitacao_horas": "21h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "15.94MJ/m²",
			"nascer_do_sol": "06:26",
			"por_do_sol": "18:28",
			"indice_uv_max": 8.25,
			"pancadas_chuva": "11.3mm",
			"velocidade_vento_10m_max": "12.7km/h",
			"direcao_vento_10m_dominante": "38°",
			"evotranspiracao": "3.27mm",
			"soma_neve": "0cm"
		},
		{
			"dia": "terça-feira",
			"temperatura_2m_min": "21.4°C",
			"temperatura_2m_max": "30.4°C",
			"temperatura_aparente_min": "25.3°C",
			"temperatura_aparente_max": "34.7°C",
			"descricao_clima": "Nublado",
			"icone_clima": "☁️",
			"duracao_sol": "10h 45min",
			"duracao_luz_dia": "12h 0min",
			"porcentagem_duracao_sol": "89.7%",
			"soma_precipitacao": "2.3mm",
			"probabilidade_precipitacao_valor_max": "73%",
			"precipitation_probability_max": "🌧️ Provável chuva",
			"precipitacao_horas": "10h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "17.4MJ/m²",
			"nascer_do_sol": "06:26",
			"por_do_sol": "18:27",
			"indice_uv_max": 6.45,
			"pancadas_chuva": "2.3mm",
			"velocidade_vento_10m_max": "12.1km/h",
			"direcao_vento_10m_dominante": "337°",
			"evotranspiracao": "3.63mm",
			"soma_neve": "0cm"
		},
		{
			"dia": "quarta-feira",
			"temperatura_2m_min": "22.5°C",
			"temperatura_2m_max": "29.8°C",
			"temperatura_aparente_min": "26.9°C",
			"temperatura_aparente_max": "34.5°C",
			"descricao_clima": "Tempestade",
			"icone_clima": "⛈️",
			"duracao_sol": "8h 47min",
			"duracao_luz_dia": "11h 59min",
			"porcentagem_duracao_sol": "73.3%",
			"soma_precipitacao": "11.7mm",
			"probabilidade_precipitacao_valor_max": "67%",
			"precipitation_probability_max": "🌧️ Provável chuva",
			"precipitacao_horas": "23h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "17.38MJ/m²",
			"nascer_do_sol": "06:27",
			"por_do_sol": "18:26",
			"indice_uv_max": 7.65,
			"pancadas_chuva": "12mm",
			"velocidade_vento_10m_max": "10.5km/h",
			"direcao_vento_10m_dominante": "261°",
			"evotranspiracao": "3.59mm",
			"soma_neve": "0cm"
		},
		{
			"dia": "quinta-feira",
			"temperatura_2m_min": "21.9°C",
			"temperatura_2m_max": "31.1°C",
			"temperatura_aparente_min": "22.1°C",
			"temperatura_aparente_max": "36.3°C",
			"descricao_clima": "Pancadas de chuva fraca",
			"icone_clima": "🌦️",
			"duracao_sol": "11h 13min",
			"duracao_luz_dia": "11h 58min",
			"porcentagem_duracao_sol": "93.6%",
			"soma_precipitacao": "0.9mm",
			"probabilidade_precipitacao_valor_max": "41%",
			"precipitation_probability_max": "🌥️ Pode chover",
			"precipitacao_horas": "4h",
			"soma_chuva_continua": "0 mm",
			"soma_radiação_onda_curta": "19.67MJ/m²",
			"nascer_do_sol": "06:27",
			"por_do_sol": "18:25",
			"indice_uv_max": 7.65,
			"pancadas_chuva": "0.9mm",
			"velocidade_vento_10m_max": "26km/h",
			"direcao_vento_10m_dominante": "146°",
			"evotranspiracao": "4.18mm",
			"soma_neve": "0cm"
		}
	],
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Previsão do tempo de ontem

[](#-previsão-do-tempo-de-ontem)

```
GET /climalivre/v1/ontem?city=birigui
```

#### 📥 Parâmetros:

[](#-parâmetros-2)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `city` | string | ❌ Não | Brasilia | Nome da cidade a ser consultada |

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-4)

```
curl -X GET "http://localhost:8000/climalivre/v1/ontem?city=birigui"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-4)

```
{
	"locate": "Birigui São Paulo - BR",
	"date": "2025-03-19",
	"temperatura_media": "25.35°C",
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Conversão de temperatura

[](#-conversão-de-temperatura)

```
GET /climalivre/v1/temperature-conversion?temperature=50&option=fahrenheit_kelvin
```

Observação: valores permitidos para o parametro option: 'celsius\_fahrenheit', 'celsius\_kelvin', 'fahrenheit\_celsius', 'fahrenheit\_kelvin', 'kelvin\_celsius', 'kelvin\_fahrenheit'

#### 📥 Parâmetros:

[](#-parâmetros-3)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `temperature` | float | ✅ Sim | Não | Valor da temperatura a ser convertida |
| `option` | string | ❌ Não | Celsius\_fahrenheit | Opção de conversão do parametro `temperature`

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-5)

```
curl -X GET "http://localhost:8000/climalivre/v1/temperature-conversion?temperature=50&option=Celsius_fahrenheit"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-5)

```
{
	"result": {
		"option": "fahrenheit para kelvin",
		"temperature": "50°F",
		"conversion": "283.15°K"
	},
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Informações sobre o nascer e o por do Sol na cidade pesquisada

[](#-informações-sobre-o-nascer-e-o-por-do-sol-na-cidade-pesquisada)

Observação: A cidade será passada diretamente na URL

```
GET /climalivre/v1/sol/birigui
```

#### 📥 Parâmetros:

[](#-parâmetros-4)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `city` | string | ❌ Não | Brasilia | Nome da cidade a ser consultada |

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-6)

```
curl -X GET "http://localhost:8000/climalivre/v1/sol/birigui"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-6)

```
{
	"locate": "Birigui São Paulo - BR",
	"results": [
		{
			"nascer_do_sol": "06:25",
			"por_do_sol": "18:32"
		}
	],
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Previsão de chuva nos proximos 3 dias por cidade pesquisada

[](#-previsão-de-chuva-nos-proximos-3-dias-por-cidade-pesquisada)

Observação: A cidade será passada diretamente na URL

```
GET /climalivre/v1/chuva/birigui
```

#### 📥 Parâmetros:

[](#-parâmetros-5)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `city` | string | ❌ Não | Brasilia | Nome da cidade a ser consultada |

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-7)

```
curl -X GET "http://localhost:8000/climalivre/v1/chuva/birigui"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-7)

```
{
	"locate": "Birigui São Paulo - BR",
	"can_rain": "Pode haver chuva moderada nos próximos 3 dias! (Total: 12.9 mm)",
	"about": "credits from https://open-meteo.com/"
}
```

### 🔎 Comparação da Temperatura Média emtre o dia de hoje e o dia de ontem, busca por cidade

[](#-comparação-da-temperatura-média-emtre-o-dia-de-hoje-e-o-dia-de-ontem-busca-por-cidade)

Observação: A cidade será passada diretamente na URL

```
GET /climalivre/v1/comparar-temperatura/birigui
```

#### 📥 Parâmetros:

[](#-parâmetros-6)

| Parâmetro | Tipo | Obrigatório | Default | Descrição |
| `city` | string | ❌ Não | Brasilia | Nome da cidade a ser consultada |

#### 📤 Exemplo de Requisição:

[](#-exemplo-de-requisição-8)

```
curl -X GET "http://localhost:8000/climalivre/v1/comparar-temperatura/birigui"
```

#### 📥 Exemplo de Resposta:

[](#-exemplo-de-resposta-8)

```
{
	"locate": "Birigui São Paulo - BR",
	"compare": "Ontem o dia foi mais quente que hoje",
	"temperature_yesterday": "25.75°C",
	"temperature_today": "25.55°C",
	"about": "credits from https://open-meteo.com/"
}
```

📜 Licença
---------

[](#-licença)

Este projeto é distribuído sob a licença MIT.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance50

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

2

Last Release

382d ago

Major Versions

v1.0.0 → v2.0.02025-04-22

### Community

Maintainers

![](https://www.gravatar.com/avatar/127927cea1efeb65aafc6f7aeaf51d60e8c16d35289c6d2dc7affb79fa46f116?d=identicon)[DesignerDigital](/maintainers/DesignerDigital)

---

Top Contributors

[![DesignerDigital](https://avatars.githubusercontent.com/u/58917373?v=4)](https://github.com/DesignerDigital "DesignerDigital (15 commits)")

### Embed Badge

![Health badge](/badges/designerdigital-climalivre/health.svg)

```
[![Health](https://phpackages.com/badges/designerdigital-climalivre/health.svg)](https://phpackages.com/packages/designerdigital-climalivre)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.2M719](/packages/statamic-cms)[ashallendesign/laravel-exchange-rates

A wrapper package for interacting with the exchangeratesapi.io API.

485677.8k](/packages/ashallendesign-laravel-exchange-rates)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[vluzrmos/slack-api

Wrapper for Slack.com WEB API.

102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1221.1k](/packages/codebar-ag-laravel-docuware)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)