Add nextbus (#8661)

* Add initial NextBus documentation

* Update nextbus docs to meet standards

* Update ha_releaes

Setting it to the next relese

* Update nextbus docs to describe how to get config values

* Add sensor to ha_category

Co-Authored-By: ViViDboarder <ViViDboarder@gmail.com>

* ✏️ Tweak

After this we will merge it

* ✏️ Change file name
This commit is contained in:
Ian 2019-05-07 18:19:41 -07:00 committed by Klaas Schoute
parent a487b68ce1
commit c51bbe923a

View File

@ -0,0 +1,58 @@
---
layout: page
title: "Public Transit (Nextbus)"
description: "Instructions on how to use public transit data from Nextbus in Home Assistant."
date: 2019-02-20 00:00
sidebar: true
comments: false
sharing: true
footer: true
logo: train.png
ha_category:
- Transport
- Sensor
ha_iot_class: Local Polling
ha_release: 0.93
---
The `nextbus` sensor will give you the next departure time and associated data from your public transit station/stop. The data comes from [NextBus](https://www.nextbus.com), which provides real time transit data for a number of transit authorities.
It is possible to get the tag information from the NextBus website.
1. Visit https://www.nextbus.com/
2. Use the drop downs to select the transit system, route, direction, and stop
3. Extract the tags from the URL. It is constructed with the following pattern:
https://www.nextbus.com/#!/<agency>/<route>/<direction>/<stop>
If tags are incorrect, valid ones will be displayed in the logs as a
convenience.
```yaml
# Example configuration.yaml entry
sensor:
- platform: nextbus
agency: AGENCY_TAG
route: ROUTE_TAG
stop: STOP_TAG
```
{% configuration %}
agency:
description: The agency tag from NextBus.
required: true
type: string
route:
description: The route tag from NextBus.
required: true
type: string
stop:
description: The stop tag from NextBus.
required: true
type: integer
name:
description: Name to use in the frontend.
required: false
default: <Agency> - <Route>
type: string
{% endconfiguration %}