From 81f72fc898502da9a1d1c53c072eb684b24d9736 Mon Sep 17 00:00:00 2001 From: panosmz Date: Sat, 6 Apr 2019 22:21:57 +0300 Subject: [PATCH] Add documentation for OASA Telematics greek public transport sensor c (#8978) * add telematics sensor documentation * Update source/_components/sensor.oasa_telematics.markdown Co-Authored-By: panosmz * Update source/_components/sensor.oasa_telematics.markdown Co-Authored-By: panosmz * fix route_id type * rename file & update release no --- source/_components/oasa_telematics.markdown | 72 ++++++++++++++++++++ source/images/supported_brands/oasa.png | Bin 0 -> 4854 bytes 2 files changed, 72 insertions(+) create mode 100644 source/_components/oasa_telematics.markdown create mode 100644 source/images/supported_brands/oasa.png diff --git a/source/_components/oasa_telematics.markdown b/source/_components/oasa_telematics.markdown new file mode 100644 index 00000000000..a00c9d38bd8 --- /dev/null +++ b/source/_components/oasa_telematics.markdown @@ -0,0 +1,72 @@ +--- +layout: page +title: "OASA Telematics" +description: "Instructions on how to integrate bus and trolley arrival data for Greek OASA Telematics within Home Assistant." +date: 2019-03-05 21:52 +sidebar: true +comments: false +sharing: true +footer: true +logo: oasa.png +ha_category: + - Transport + - Sensor +ha_iot_class: Cloud Polling +ha_release: 0.92 +--- + +The `oasa_telematics` sensor will provide you with bus and trolley arrival times for Greek public transport for Athens, using real-time data from [OASA Telematics](http://telematics.oasa.gr/en/). + +## {% linkable_title Configuration %} + +Add a sensor to your `configuration.yaml` file as shown in the example: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: oasa_telematics + route_id: YOUR_ROUTE_ID + stop_id: 'YOUR_STOP_ID' +``` + +The `route_id` can be obtained by looking up the "LineCode" of the route you want at this link: + + + +Then getting the "RouteCode" from this link: + + +(Replace "LINE_CODE" with the "LineCode" you copied from the first link) find the route you need and copy the `RouteCode` field. + +Next, get the `stop_id` from this link: + + +(Replace "ROUTE_CODE" with the "RouteCode" you got from the previous link) find the stop you need and copy the `StopID` field. The route must pass from this stop in order for the sensor to work. + +{% configuration %} +route_id: + description: The id of the public transport route. + required: true + type: int +stop_id: + description: The id of the public transport stop. + required: true + type: string +name: + description: A friendly name for this sensor. + required: false + default: OASA Telematics + type: string +{% endconfiguration %} + +## {% linkable_title Examples %} + +A more extensive example on how to use this sensor: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: oasa_telematics + route_id: 1965 + stop_id: '090006' +``` diff --git a/source/images/supported_brands/oasa.png b/source/images/supported_brands/oasa.png new file mode 100644 index 0000000000000000000000000000000000000000..8780f104c76726d4e5d75f3156d29d5b4b7cfa31 GIT binary patch literal 4854 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 Mx<0N<-7e^V0MBYSC;$Ke literal 0 HcmV?d00001