User Stories: Room Finder

• RF-C-1: (13SP) As a student, I get suggestions for incomplete or slightly misspelled names, so that I can find the room even if I do not know its exact name.

In the current version of TCA, the slightest misspelling or mispositioning of a letter in the search sequence will deliver an empty search result. This is not very convenient. In this feature, students can type part of words, even misspelled or incomplete, and the search will figure out what the student meant. Then, all relevant results will show on the list. Many existing algorithms can do this kind of fuzzy search.

• RF-Ma-1: (8SP) As a student, I can see the route from my current location to the selected room in Google Maps, so that I can easily find it.

In every interface of a location (classrooms or lecture halls), there should be a button like “find my route on Google” for users to switch to Google Maps. The destination will be automatically set in the Google Maps app and thus the route will automatically be shown. Therefore, the necessary information about destinations and routing options have to be communicated between the two applications.

• RF-Mi-2: (5SP) As a student, I want to know the distance and time it will take to go from my current location to the next spot on campus, so that I know when to make my way. [can also be used between Stammgelände and Garching -> also use MVV information]

Apart from the information that is shown by the Google Maps app, once we have handed over control for routing, we can use Google's API in TCA to gather all kinds of information about the route, including distance and time.

• RF-C-2: (13SP) As a student, I want to see the room finder maps integrated into google maps with the respective zoom level, so that there is no need to switch between the views manually. [zoom in -> more fine-grained room finder map will be overlaid in map] - Is this even possible?

We create a cutout for each of the existing room maps and will overlay the cutout over the integrated map in our room finder. Depending on the current zoom level of the map, there must only be the one overlay which corresponds to the room map with the suitable scale.

TODO: Get GPS coordinates of room

Optional

• (optional, really not needed) RF-Mi-1: As a student, I want to be able to send the location of a room to a friend via WhatsApp, so that I can easily coordinate meetings.

In every interface of a location (classrooms or lecture halls), there should be a sharing button. Students should be able to send the location of a room via different types of methods, such as WhatsApp and text message. The receivers will receive a link about the location of the room. When receivers click on the link, it will automatically jump to the browser and present the intended location. Detailed information about sharing buttons can be found at https://developer.android.com/training/sharing/shareaction

• (optional) RF-Mi-3: As a student, I can save rooms in a list, so that I can find them quickly the next time.

In the room finder activity, the students should see an overview of all rooms that they saved in a list. This can be implemented as a two-paged dropdown menu, with favorites on the one and a search history on the other page. When an item of the list is selected, the search will be initiated for the respective room.

Already implemented

• (Already implemented) As a student, I want to be able to search for a room by name, so that I can find rooms whose name I know.
• (Already implemented) As a student, I can drag or zoom the map, so that I can see the surrounding environment to help me find it.
• (Already implemented?-8SP) As a student, I want to conveniently find a route to a specific lecture hall/study room/spot on campus, so that I don’t have to spend too much time searching. [What does ‘conveniently’ mean? Need to specify in discussion!]
• (Already implemented) As a student, I want to see a history of rooms that I have searched in the past, so that it is easier for me to access rooms where I need to go to repeatedly.
• (Already implemented) As a student, I want to get recommendations for rooms that I need to go in upcoming lectures, so that I do not need to search for them manually. [only if TUM online calendar is shared]
• (Already implemented) As a student, I want to see which lecture is currently held in the room I searched for, so that both I can double check if I'm right and that I can decide to join other lectures that I'm interested in, e.g. when I have arrived early.