Integrace RichPear Home
MTA New York City Transit
MTA New York City Transit zobrazuje reálné odjezdy linek metra a autobusů v síti New York City Transit. Integrace pracuje s daty MTA a vytváří senzory pro vybrané zastávky a směry.
- Doména
mta- Kategorie
- Doprava
- Komunikace
- cloud-polling
- Kvalita
- silver
Příprava
Nejdřív připravte vše, co integrace MTA New York City Transit potřebuje mimo RichPear Home: pro metro není potřeba API klíč, pro autobusová data připravte MTA Bus Time API key a přesný název zastávky nebo stanice. Bez této přípravy se průvodce může dokončit jen částečně nebo se entity budou tvářit jako nedostupné.
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123. Nastavení provádějte z účtu správce, aby bylo možné vytvářet zařízení, oblasti a případné pomocné entity.
Nastavení
V RichPear Home otevřete Nastavení -> Zařízení a služby, zvolte Přidat integraci a vyhledejte MTA New York City Transit. Pokud je zařízení nebo služba nalezená automaticky, dokončete nabídnuté nastavení z objevené karty.
Průvodce obvykle vyžaduje přihlašovací údaje, API klíč, adresu zařízení nebo výběr konkrétního účtu podle typu integrace. U každé položky vyberte, zda sledujete metro nebo autobus, a zadejte zastávku, linku a směr tak, aby senzor odpovídal každodenní trase. Po dokončení pojmenujte zařízení podle místnosti a zkontrolujte, že vytvořené entity odpovídají skutečnému zařízení nebo službě.
Metro a autobusy
Senzory pro metro a autobusy mají rozdílné požadavky. Metro využívá veřejná GTFS-RT data bez klíče, autobusové sledování vyžaduje MTA Bus Time API klíč.
Při vytváření senzoru používejte přesné názvy zastávek. Pokud se zastávka nenajde, ověřte název přímo proti MTA datům a zkontrolujte směr jízdy.
Výběr směru
Směr a cílová stanice pomáhají odfiltrovat odjezdy opačným směrem. U rušných stanic je bez filtru senzor často nepoužitelný pro automatizace.
Pro pravidelné dojíždění vytvořte samostatný senzor pro každou trasu. Ranní a večerní cesta obvykle potřebují jiný směr a často i jinou linku.
Senzory
Hlavní hodnota senzoru udává nejbližší odjezd. Další informace, například linka nebo cíl, mohou být v atributech podle dostupných dat.
Na dashboardu zobrazujte nejen čas odjezdu, ale i linku a směr. Uživatel pak pozná, zda senzor ukazuje správné spojení.
Interval dotazování
Data veřejné dopravy se mění rychle, ale není vhodné nastavovat příliš agresivní dotazování. Použijte interval, který odpovídá skutečné potřebě dashboardu nebo automatizace.
Pro ranní přehled stačí častější aktualizace jen v době odchodu. Mimo špičku můžete data používat méně často a šetřit API i systém.
Použití v praxi
Integrace se hodí pro dashboard u dveří, oznámení před odchodem nebo automatizaci, která upozorní na vhodný čas vyrazit.
Automatizace vždy doplňte podmínkou dne a času. Dopravní senzor bez časového omezení může posílat oznámení i ve chvíli, kdy nikdo necestuje.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace MTA New York City Transit. Sledujte, jestli se hodnoty aktualizují podle očekávané komunikace, zda příkazy nemají zpoždění a jestli se v logu neopakují chyby přihlášení, odmítnuté požadavky nebo výpadky dostupnosti.
U zařízení s přímým dopadem na provoz domácnosti nechte správcům jasný postup pro ruční ovládání, vypnutí automatizace a bezpečný návrat do původního stavu. Zapište také místo, kde se spravuje token, heslo, API klíč, adresa zařízení, topic struktura nebo konfigurační soubor.