From 0004ab0e15c5c1e30337c88b5532781c58841608 Mon Sep 17 00:00:00 2001
From: Allan Persson | Marathon Pepe
 <46043392+allanpersson@users.noreply.github.com>
Date: Sun, 7 Apr 2019 05:22:43 +0200
Subject: [PATCH] Update rejseplanen.markdown (#9154)

* Update rejseplanen.markdown

The guide was missing the steps to find the id in most cases, due to the old guide gave the "adr" output i most cases and not the "id"

* Update rejseplanen.markdown

* Move content to setup section

* Change format
---
 source/_components/rejseplanen.markdown | 59 +++++++++++++++++--------
 1 file changed, 40 insertions(+), 19 deletions(-)

diff --git a/source/_components/rejseplanen.markdown b/source/_components/rejseplanen.markdown
index 4ac80104899..772e4268567 100644
--- a/source/_components/rejseplanen.markdown
+++ b/source/_components/rejseplanen.markdown
@@ -17,6 +17,32 @@ redirect_from:
 
 The `rejseplanen` sensor will provide you with travel details for Danish public transport, using timetable data from [Rejseplanen](https://www.rejseplanen.dk/).
 
+## {% linkable_title Setup %}
+
+The `stop_id` can be obtained through the following steps:
+
+- Go to [http://rejseplanen.dk](http://rejseplanen.dk)
+- Make a search and fill in the location you want to find stop ID for in the from's (a) section. 
+- Fill in either a random or the destination into the (b) section of the form.
+- Press on "detaljer" and find the name of the stop you are looking for.
+- Example search:
+    - Jernaldervej 1, Søften, 8382 Hinnerup
+    - Odense St. (detaljer) 
+- Now insert the stop name in the end of this URL: http://xmlopen.rejseplanen.dk/bin/rest.exe/location?format=json&input=STOP_NAME
+
+For "Engdalsvej/Århusvej" you would have to use: http://xmlopen.rejseplanen.dk/bin/rest.exe/location?format=json&input=Engdalsvej/%C3%85rhusvej
+You will se a output like this:
+
+```text
+"StopLocation":[{
+    "name":"Engdalsvej/Århusvej (Favrskov Kom)",
+    "x":"10078598",
+    "y":"56243456",
+    "id":"713000702"
+```
+
+Find the name of your stop in the list and the "id" is the one you are looking for to us as value for `stop_id:`.
+
 ## {% linkable_title Configuration %}
 
 Add a sensor to your `configuration.yaml` file as shown in the example:
@@ -28,25 +54,9 @@ sensor:
     stop_id: 'YOUR_STOP_ID'
 ```
 
-The `stop_id` can be obtained by looking up the name of the stop at this link:
-
-<http://xmlopen.rejseplanen.dk/bin/rest.exe/location?format=json&input=STOP_NAME>
-(Replace "STOP_NAME" with city or location you want id for)
-find the stop and copy the `id` field with the trailing zeros.
-
-The sensor can filter the timetables by one or more routes, directions and types. The known types are listed in the table below.
-
-| Departure type | Description |
-|--------------|-------------|
-| BUS | Normal bus |
-| EXB | Express bus |
-| M | Metro |
-| S | S-train |
-| REG | Regional train |
-
 {% configuration %}
 stop_id:
-  description: The id of the public transport stop.
+  description: The ID of the public transport stop.
   required: true
   type: string
 route:
@@ -65,8 +75,8 @@ departure_type:
 
 ## {% linkable_title Direction %}
 
-If you use the direction filter it's important to put correct destination, or else the sensor will not work at all.
-The direction has to be the destination(s) for the transport type(s) for the departure stop destination, and NOT the stop where you want to get off. Check <http://rejseplanen.dk> and make a search, and use the destinations from there in your configuration. Make sure you use the exact name as the destination(s)
+If you use the direction filter it's important to put correct destination or else the sensor will not work at all.
+The direction has to be the destination(s) for the transport type(s) for the departure stop destination, and NOT the stop where you want to get off. Check [http://rejseplanen.dk](http://rejseplanen.dk), make a search and use the destinations from there in your configuration. Make sure you use the exact name as the destination(s).
 
 A working example on how to use this sensor with direction:
 
@@ -90,6 +100,7 @@ sensor:
     direction:
       - 'København H'
 ```
+
 It fails because the destination from the departure is NOT København H, but 'CPH Lufthavn', 'Helsingør St.' and others.
 
 ## {% linkable_title Examples %}
@@ -106,3 +117,13 @@ sensor:
       - 'Herlev St.'
       - 'Ballerup St.'
 ```
+
+The sensor can filter the timetables by one or more routes, directions and types. The known types are listed in the table below.
+
+| Departure type | Description |
+|--------------|-------------|
+| BUS | Normal bus |
+| EXB | Express bus |
+| M | Metro |
+| S | S-train |
+| REG | Regional train |