# Carris (API) Localizacão em tempo Real

**URL:** <https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749>\
**Category:** Partilha de Projectos\
**Created:** [5 Março , 2023 18:10 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749 "2023-03-05T18:10:59Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![RodolfoVieira](https://forum.cpha.pt/user_avatar/forum.cpha.pt/rodolfovieira/32/14633_2.png) [@RodolfoVieira](https://forum.cpha.pt/u/RodolfoVieira)\
**Post date:** [5 Março , 2023 18:10 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/1 "2023-03-05T18:10:59Z")

</div>

Olá.  
Saber a localização em tempo real dos autocarros da Carris sempre foi algo que muitos clientes da Carris queriam saber e há bem pouco tempo ,foi possível muitos utilizadores terem essa noção através do trabalho fantástico do João de Vasconcelos e de alguns membros do discordd do server **Lisboa para pessoas** que criou a aplicação da GEOBUS.

Eu entrei em contacto com ele recentemente saber em que ponto estava a situação da API, visto que tinha lido que a carris entretanto alterou algo não disponibilizando a API de forma ofical publicamente  
Onde me deu o seu link de [github](https://github.com/joaodcp/Carris-API) onde se encontrar informação útil para se trabalhar.

Qual a ideia?  
A ideia é só mais uma no meio de tantas que já envolveram os membros da CPHA, que é tentarmos saber em tempo real onde andam os autocarros para podermos fazer automações engraçadas no Home Assistant.

Quero aqui servir de ponte, para reunir o máximo de utilizadores com conhecimento em python de forma a que possamos ou pelo menos tentar fazer uma coisa gira com isto.

A titulo pessoal, isto seria fantástico integrar no Home Assistant, para poder colocar a Alexa ou o Google Home a informar que o autocarro estava na paragem X assim a minha filha podia ter uma noção quando devia sair de casa, não estando a perder tempo numa paragem de autocarro quando podia estar a fazer outra coisa.  
Actualmente isso é possível saber tanto quanto sei pelo google maps, como outras apps mas a intencão será mesmo ter essa informação no home assistant.

Deixo então o tema em aberto, para que a malta possa discutir esta ideia aqui.

---

<div class="post-metadata">

**Author:** ![luuuis](https://forum.cpha.pt/user_avatar/forum.cpha.pt/luuuis/32/14755_2.png) [@luuuis](https://forum.cpha.pt/u/luuuis)\
**Post date:** [5 Março , 2023 21:15 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/2 "2023-03-05T21:15:44Z")

</div>

Tanto quanto sei [a Carris não quer abrir o acesso às APIs](https://lisboaparapessoas.pt/2023/01/05/geobus-aplicacao-carris-api-dados-abertos/) portanto embora seja possível fazê-lo contra a vontade deles, na prática pode tornar-se complicado ou pelo menos trabalhoso.

Por outro lado, investir tempo num projecto ao qual a Carris será hostil é capaz de não ser o mais aconselhado. Mas que é possível é. 🙂

---

<div class="post-metadata">

**Author:** ![RuiDias](https://forum.cpha.pt/user_avatar/forum.cpha.pt/ruidias/32/12591_2.png) [@RuiDias](https://forum.cpha.pt/u/RuiDias)\
**Post date:** [6 Março , 2023 12:05 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/3 "2023-03-06T12:05:57Z")

</div>

Bom dia

Esta é uma excelente ideia que gostaria de ver aplicada a outras companhias de transporte, infelizmente para nós em portugal ainda há uma mentalidade do “segredo”. Não se compreende porque é que uma empresa que possui um serviço como este o pode “limitar” e não deixar os seus utilizadores usarem. Aliás, tornar a API pública e acessível só seria vantajoso para eles (ie: clientes satisfeitos, melhores negócios, certo?)

No entanto há aqui alguns incógnitas que me deixam a pensar se vale a pena investir neste “_negócio_”:

1. Embora a API seja oficial, esta “Documentação da API” não o é, o que significa que pode “morrer” a qualquer momento.Ou seja, se surgirem _breaking changes_, será que vamos ter acesso a elas a tempo de actualizar o nosso código? ou só saberemos quando o serviço deixar de funcionar, e ai temos de correr atrás do prejuiso?

2. A API está protegida por JWT Token (e muito bem), o que significa que “alguem” terá que nos fornecer um acesso válido (se a coisa estiver bem montada, deveriamos ter um _clientId_ + _secret_). De quem é a responsabilidade de fornecer esse acesso? será um acesso oficial? (se não for nem vale a pena começar)

Posto isto, caso as respostas a estas questões sejam positivas, eu estou disponível/interessado para (ajudar a) desenvolver a parte do backend (em Python).

Forte Abraço,  
Rui

---

<div class="post-metadata">

**Author:** ![RodolfoVieira](https://forum.cpha.pt/user_avatar/forum.cpha.pt/rodolfovieira/32/14633_2.png) [@RodolfoVieira](https://forum.cpha.pt/u/RodolfoVieira)\
**Post date:** [7 Março , 2023 09:32 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/4 "2023-03-07T09:32:35Z")

</div>

@luuuis @RuiDias obrigado pelo vosso feedback.  
Aprofundei mais o assunto depois de ter lançado a discussão e falei com mais membros de outras comunidades que enfrentam os mesmos problemas de a API estar fechada.  
Uma das soluções que me foram apresentadas é enfrentar o desafio estilo “Rogue” mas isso já vocês me disseram por outras palavras que não estão interessados e bem , porque não queremos aqui criar problemas.

Fiquei a saber também que a carris já foi questionada sobre o acesso livre a API mas a resposta foi que não estão disponíveis para a fornecer a desenvolvedores comunitários para já…  
O que leva a dizer que é triste, não seguirem o exemplo por exemplo do Metro de Lisboa que é um serviço de transportes também e têm o acesso aberto.

Tentei ir por um caminho alternativo pelo menos para saber o horário do próximo autocarro a passar na paragem que me interessa.  
Criei um flow em nodered que utiliza a API da Google que por sua vez a carris diz que todos os seus transportes podem ser consultados lá…

Consegui por a funcionar, contudo aquilo não é nada real… Fui duas vezes à paragem de autocarro e o autocarro a primeira vez passou 7 min atrasado e a segunda 10. Enquanto lá estava olhei para o Google Maps e mostrava te que o autocarro já tinha passado a paragem quando de facto nem tinha lá chegado.

Bom, comentei isso novamente com outra comunidade que está mais ligada a isto , onde me foi dito que a Google usa os dados fornecidos pelo GTFS e que não é em tempo real.  
Fico (ficamos) assim com as pernas presas.

Entretanto se alguém tiver uma ideia partilhe.

---

<div class="post-metadata">

**Author:** ![joao5](https://forum.cpha.pt/letter_avatar_proxy/v4/letter/j/46a35a/32.png) [@joao5](https://forum.cpha.pt/u/joao5)\
**Post date:** [11 Março , 2023 16:14 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/5 "2023-03-11T16:14:17Z")

</div>

A documentação é oficial, extraída do servidor da CARRIS.

---

<div class="post-metadata">

**Author:** ![RodolfoVieira](https://forum.cpha.pt/user_avatar/forum.cpha.pt/rodolfovieira/32/14633_2.png) [@RodolfoVieira](https://forum.cpha.pt/u/RodolfoVieira)\
**Post date:** [14 Julho , 2026 17:25 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/6 "2026-07-14T17:25:50Z")

</div>

> **[GitHub - leothemurphy41/ha-carrismetropolitana: carrismetropolitana](https://github.com/leothemurphy41/ha-carrismetropolitana?fbclid=IwdGRzaATDT-pjbGNrBMNP2WV4dG4DYWVtAjExAHNydGMGYXBwX2lkDDM1MDY4NTUzMTcyOAABHp6HLz6vPfkCH8_3t2lhzVtciVWecj7mFjTtblEI7SVE3BFosfRvCa1uRsJ6_aem_U4rzpboA-yVRrs-lTuqJPA)**
>
> carrismetropolitana

---

<div class="post-metadata">

**Author:** ![goliath\_2k](https://forum.cpha.pt/user_avatar/forum.cpha.pt/goliath_2k/32/18713_2.png) [@goliath\_2k](https://forum.cpha.pt/u/goliath_2k)\
**Post date:** [13 Agosto , 2026 14:38 UTC](https://forum.cpha.pt/t/carris-api-localizacao-em-tempo-real/11749/7 "2026-08-13T14:38:36Z")

</div>

Alguém instalou recentemente? Dá-me sempre o erro “Could not connect to the Carris Metropolitana API. Please check your internet connection.” Já tentei com net fixa, com net móvel e nada.
