CityBikes

Ukázka v RichPear Home

Screenshoty ukazují české rozhraní RichPear Home při vyhledání integrace a při prvním bezpečném kroku nastavení.

Co integrace přidá

Integrace vytváří senzor pro každou sledovanou stanici sdílených kol. Stav senzoru odpovídá počtu volných kol na stanici.

U stanic se ukládají také doplňující atributy: identifikátor stanice, souřadnice, počet volných stojanů, počet volných elektrokol, pokud je síť poskytuje, a časová značka posledních dat.

Data se obnovují pravidelným dotazováním. Konfigurace může sledovat stanice v okolí zadaných souřadnic, nebo jen konkrétní ID či UID stanic.

Příprava před přidáním

Rozhodněte, zda chcete sledovat všechny stanice v okolí, nebo jen konkrétní stanice. Pro okolí potřebujete souřadnice a poloměr. Pro konkrétní stanice potřebujete jejich ID nebo UID z veřejných dat CityBikes.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Nastavení v RichPear Home

Tato integrace se nastavuje ručně v konfiguraci. Po úpravě souboru konfiguraci uložte, restartujte RichPear Home a potom ověřte vytvořené senzory.

sensor:
  - platform: citybikes
    radius: 200

Pokud chcete sledovat konkrétní stanice, použijte seznam stanic. Volitelně můžete doplnit vlastní název skupiny, síť sdílených kol a souřadnice.

sensor:
  - platform: citybikes
    name: Prace
    latitude: 50.0755
    longitude: 14.4378
    stations:
      - "123"
      - "145"
      - "436"

Kontrola entit a funkcí

Po restartu otevřete Nastavení → Zařízení a služby a zkontrolujte entity vytvořené pro jednotlivé stanice. Každá stanice by měla ukazovat počet dostupných kol v jednotce bikes.

U vybraných stanic zkontrolujte atributy empty_slots, free_ebikes, latitude, longitude a timestamp. Pokud se stanice nezobrazí, ověřte síť, poloměr, souřadnice a ID stanice.

Použití v automatizacích

Typické použití je upozornění, že je na oblíbené stanici dostupný minimální počet kol nebo elektrokol. Podmínku doplňte o čas, pracovní dny a kontrolu, že senzor není nedostupný.

Pro rozhodování nepoužívejte jednu izolovanou změnu. Stanice se mohou rychle měnit a data jsou závislá na pravidelném cloudovém dotazu.

Provoz a údržba

Po změně sítě sdílených kol, přesunu domácí adresy nebo úpravě sledovaných stanic upravte konfiguraci a restartujte RichPear Home.

Pokud provozovatel sdílených kol změní ID stanic nebo data dočasně neposkytuje, mohou senzory zmizet nebo být nedostupné. V takovém případě znovu ověřte aktuální ID a UID stanic.

Řešení problémů

Když se senzory nevytvoří, ověřte odsazení YAML, že je vyplněný buď radius, nebo stations, a že zadané souřadnice odpovídají oblasti se sítí sdílených kol. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény citybikes.

Pokud je výsledek prázdný, zkuste nejdřív větší poloměr nebo konkrétní ID stanice. U vzdálenosti počítejte s tím, že při amerických jednotkách se zadaný poloměr převádí ze stop na metry.