PHPackages                             rafaelduarte/olhovivo - 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. rafaelduarte/olhovivo

ActiveLibrary[API Development](/categories/api)

rafaelduarte/olhovivo
=====================

Minha biblioteca para a API olho vivo.

2.0(2y ago)5111MITPHPPHP ^8.1

Since Apr 6Pushed 2y ago2 watchersCompare

[ Source](https://github.com/RafaelDuarteF/lib-api-olhoVivo)[ Packagist](https://packagist.org/packages/rafaelduarte/olhovivo)[ RSS](/packages/rafaelduarte-olhovivo/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

[![Testes](https://camo.githubusercontent.com/948f35df3a53644a01d127dc0ce252835c538ba1f0760512cfed516c9f4b5630/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5465737465732d70617373696e672d627269676874677265656e)](https://github.com/r3c4-d3v/lib-api-olhoVivo/actions/workflows/tests.yml)

Biblioteca para a API olho vivo
-------------------------------

[](#biblioteca-para-a-api-olho-vivo)

Biblioteca para consumir a API olho vivo da SP Trans.
Obtenha todas as informações sobre os ônibus de São Paulo através dessa API. LIB em PHP para consumi-lá facilmente.

Certifique-se de que você possui o composer em seu projeto e tenha um token de aplicativo da SP Trans.

```
composer require rafaelduarte/olhovivo
```

Você pode registrar sua chave de api no site da [SpTrans](https://www.sptrans.com.br/desenvolvedores/)

Com sua chave em mãos adicione as seguintes chaves em seu arquivo .env

```
SP_TRANS_API_KEY=SUA_CHAVE
SP_TRANS_API_ENDPOINT=http://api.olhovivo.sptrans.com.br/
SP_TRANS_API_VERSION=v2.1/
```

Importe no arquivo que deseja usar com: use RafaelDuarte\\OlhoVivo\\OlhoVivo;

### Exemplo de uso

[](#exemplo-de-uso)

```
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use RafaelDuarte\SpTrans\OlhoVivo\Classes;

class UserController extends Controller
{
   public function index() {
       # Instanciar um novo client
       $olhoVivo = new OlhoVivo();

       # Realiza uma busca das linhas do sistema por denominação ou número da linha
       $olhoVivo->getManyBusLines();

       # Realiza uma busca das linhas do sistema por denominação ou número da linha.
       $olhoVivo->getBusLinesByDirection();

       # Realiza uma busca fonética das paradas de ônibus do sistema com base no parâmetro informado.
       $olhoVivo->getManyBusStopByAddress();

       # Realiza uma busca por todos os pontos de parada atendidos por uma determinada linha.
       $olhoVivo->getManyBusStopByLineCode();

       # Retorna a lista detalhada de todas as paradas que compõem um determinado corredor com base no código do corredor.
       $olhoVivo->getManyBusStopsByLane();

       # Retorna uma lista com todos os corredores inteligentes
       $olhoVivo->getAllBusLanes();

       # Retorna uma lista com todos as empresas operadoras relacionadas por área de operação
       $olhoVivo->getAllBusCompanies();

       #Retorna uma lista completa com a última localização de todos os veículos mapeados com suas devidas posições lat / long
       $olhoVivo->getAllBusesPosition();

       # Retorna uma lista com todos os veículos de uma determinada linha com suas devidas posições lat / long
       $olhoVivo->getAllBusesByLineCode();

       # Retorna uma lista completa de todos os veículos mapeados que estejam transmitindo em uma garagem da empresa informada.
       $olhoVivo->getManyBusesInGarageFromCompany();

       # Retorna uma lista com a previsão de chegada dos veículos da linha informada que atende ao ponto de parada informado.
       $olhoVivo->getArrivalPredictionByLineAndStop();

       # Retorna uma lista com a previsão de chegada dos veículos de cada uma das linhas que atendem ao ponto de parada informado.
       $olhoVivo->getArrivalPredictionByStop();

       # Retorna o mapa completo da cidade.
       $olhoVivo->getKmzMapFile();
   }
}
```

Pré-requisitos para contribuir
==============================

[](#pré-requisitos-para-contribuir)

Certifique-se de ter o Docker e o Docker Compose instalados em seu sistema.
Se ainda não os tiver, você pode instalá-los seguindo as instruções oficiais: Docker: [Instalação do Docker](https://docs.docker.com/get-docker/)
Docker Compose: [Instalação do Docker Compose](https://docs.docker.com/compose/install/)

### Passos

[](#passos)

1. Clone o repositório do projeto para o seu ambiente local.
2. Navegue até o diretório raiz do projeto.
3. No terminal, execute o seguinte comando para construir as imagens do Docker e iniciar os containers:

```
docker-compose up --build
```

Isso irá construir as imagens e iniciar os containers com base nas configurações definidas no arquivo docker-compose.yml.

- O código fonte do projeto está vinculado ao contêiner e será sincronizado automaticamente.
    Isso significa que qualquer alteração feita nos arquivos locais será refletida no contêiner em tempo real.

### Parar execução do container

[](#parar-execução-do-container)

Para parar a execução do projeto, você pode pressionar `Ctrl + C` no terminal onde o `docker-compose up` foi executado ou executar o seguinte comando no diretório raiz do projeto:

```
docker-compose down
```

Com essas instruções, você poderá executar o projeto utilizando o Docker e o Docker Compose, garantindo um ambiente isolado e facilitando o processo de desenvolvimento e execução.

### Documentação API

[](#documentação-api)

Para verificar os tipos de retorno e funcionamento da API, você pode acessar a documentação oficial da API da OlhoVivo [aqui.](https://www.sptrans.com.br/desenvolvedores/api-do-olho-vivo-guia-de-referencia/documentacao-api/)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 51% 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 ~25 days

Total

3

Last Release

1082d ago

Major Versions

1.3.0 → 2.02023-05-26

PHP version history (2 changes)1.2.0PHP ^8.0

2.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/73c07d27d9c4dd03ca82d8e735b8edf983960ce5e7070952d83f67001d26db34?d=identicon)[Rafael Duarte](/maintainers/Rafael%20Duarte)

---

Top Contributors

[![vinicius-rech](https://avatars.githubusercontent.com/u/32982163?v=4)](https://github.com/vinicius-rech "vinicius-rech (49 commits)")[![RafaelDuarteF](https://avatars.githubusercontent.com/u/103393497?v=4)](https://github.com/RafaelDuarteF "RafaelDuarteF (47 commits)")

---

Tags

olho-vivoolhovivophpsptranssptrans-api

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/rafaelduarte-olhovivo/health.svg)

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

###  Alternatives

[netflie/whatsapp-cloud-api

The first PHP SDK to send and receive messages using a cloud-hosted version of the WhatsApp Business Platform

640431.7k4](/packages/netflie-whatsapp-cloud-api)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1344.8k1](/packages/jasara-php-amzn-selling-partner-api)[hardcastle/xrpl_php

PHP SDK / Client for the XRP Ledger

129.7k5](/packages/hardcastle-xrpl-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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