Use Cases¶

• Table of contents
• Use Cases
  • Audio Guide
    • Scenarios in GeTS Web Client
      • Create track
  • Points
    • Load points
    • Update point info (categories and data)
    • Add point
    • Remove point from category-channel(s)
  • Tracks
    • Load track
    • Update track's info
    • Remove track
    • Add track
  • Categories
    • Add category
    • Get category
  • Users
    • Registration
    • Authorization
    • Quit session
    • Remove user

category-channel = channel in geo2tag, corresponding category of GeTS

Audio Guide¶

Scenarios in GeTS Web Client¶

Create track¶

• User logs into GeTS Web Client using his Google Account
• Then User goes to the "Tracks" page
• At this page User hits button "Create track" and as the result creation menu will appear
• In this menu User can enter some name, some description and some other information which belongs to the track
• After that User can add some points to the track by pressing "Add point" button and then pressing some space on the map
• All points will be displayed as a list, where user can enter the name and add some information about a point, including Audio Track
• Also every point in a list will have edit and delete buttons

Points¶

Load points¶

• Send to GeTS (loadPoints) list of categories, coordinates of circle center and radius
• GeTS loads from geo2tag (filterCircle) list of category-channels with 2D filter (circle center and radius)
• GeTS merges list of points from channels and remove duplicates.
• GeTS returns list of points.

Update point info (categories and data)¶

• Send to GeTS (updatePoint) point with list of categories and point data
• GeTS search category-channels with old version of point
• if point data is differ then exists, then GeTS removes point from category-channels, else GeTS removes point from old category-channels
• GeTS add point to geo2tag (writeTag) to new category-channels (or to all category-channels if poind data was changed)
• GeTS returns OK answer

Add point¶

• Send to GeTS (addPoint) point with list of categories and point data
• GeTS add point to geo2tag (writeTag) to all category-channels
• if requested category-channel doesn't exists then GeTS creates (addChannel) category-channel

Remove point from category-channel(s)¶

(We need function in geo2tag for removing points from channels)
(We need function in geo2tag for removing channels)

• Send to GeTS (removePoint) point with list of categories
• For each category GeTS:
  1. loads point from category-channel (filterChannel);
  2. removes deleted point from list;
  3. deletes old category-channel (need a method);
  4. creates new category-channel (addChannel) and addes list of points (writeTag)

Tracks¶

Load track¶

• Send to GeTS (loadTrack) name of track
• GeTS loads track from geo2tag (filterChannel), if one exists
• GeTS returns track.

Update track's info¶

• Send to GeTS (updateTrackInfo) with track's field to change: url, name or description
• GeTS makes update track info on geo2tag (alterChannel)
• GeTS returns OK answer

Remove track¶

• Send to GeTS (removeTrack) name of track
• GeTS removes track from geo2tag (need a method), if one exists
• GeTS returns OK answer

Add track¶

• Send to GeTS (addTrack) with name, description, url, activeRadius
• GeTS addes channel to geo2tag (addChannel), if there is no channel with given name in the system
• GeTS returns OK answer

Categories¶

Add category¶

• Send to GeTS (addCategory) with name, description, url
• GeTS addes channel to geo2tag (addChannel) like category, if there is no channel with given name in the system
• GeTS returns OK answer

Get category¶

• Send to GeTS (getCategory) with the name of the desirable category
• GeTS loads category from geo2tag (filterChannel), if this category exists
• GeTS returns category with all points that it contains.

Users¶

Registration¶

Authorization¶

Quit session¶

• Send to GeTS auth-token (quitSession)
• GeTS calls quit session in geo2tag (quit)
• GeTS returns OK answer

Remove user¶

• Send to GeTS (removeUser) with name and password
• GeTS calls delete user in geo2tag (deleteUser)
• GeTS returns OK answer