Hikr is an application that provides integrated collaborative planning tools. It allows users to create hiking trips, add members, share information, communicate, share trip route points and general details about the trip.

• Technologies Used
• How to locally run Hikr
• How to use Hiker

• Python
• Flask
• PostgreSQL/PostGIS
• SQLAlchemy
• Javascript/jQuery
• AJAX/JSON
• SocketIO
• Flask SocketIO
• AngularJS
• Jinja2
• Twitter Bootstrap
• OpenStreetMap (OSM) Dataset
• Osm2pgsql
• Google Maps API
• Twilio API (dependencies are listed in requirements.txt)

Hikr has not yet been deployed, so here is how to run the app locally on your machine.

Some of Hikr maping features (trails and elevation profile) depend on dataset obtained from Open Street Map. For this version of the app, trail data is obtained for California alone. To be able to use these features of the app, please follow the following steps to setup local OSM PostreSQL database:

• To obtain dataset for California, download california-latest.osm.pbf from http://download.geofabrik.de/north-america/us/california.html
• Install osm2pgsql for Ubuntu. For instructions on other operating systems please check out osm2pgsql page.

  apt-get install osm2pgsql

• Install osmosis for Ubuntu. For instructions on other operating systems please check out http://wiki.openstreetmap.org/wiki/Osmosis/Installation#Linux

  apt-get install osmosis

• Follow the commands below to create database for highways alone:

  osmosis --read-pbf california-latest.osm.pbf \
  --tf accept-ways highway=* --used-node \
  --wb california-hiking.osm.pbf

• Create database gis using the following commands:

  createdb gis
  psql -d gis -c 'CREATE EXTENSION postgis; CREATE EXTENSION hstore;'
  osm2pgsql -l -c -d gis --slim -C 1000 --flat-nodes california-hiking.osm.pbf

• After these steps the OSM database is set up and should be ready to use after following the steps below.

• Set up and activate a python virtualenv, and install all dependencies:

  pip install -r requirements.txt

• Make sure you have PostgreSQL running. Create a new database in psql named hiker:

  createdb hiker

• Create the tables in your database:

   python -i model.py
   db.create_all()
   quit()
   python seed.py

• Start up flask server:

  python server.py

• Go to localhost:5000 to interact with the app

• Register as a new user or Log-in if you have already an account.
• Once you log-in, you will be directed to the last trip you organized/recent trip page.
• To create new trip click on the "Create New Trip", input trip information and click "Submit".
• On the trip page you can add members to the trip by using a drop-down list of users with their names and user names listed, and you can create new trips by clicking the Create New Trip link.
• You can use the messaging app to send messages to all members in your trip
• You can add action items by clicking on the To-Do-List and save by clicking Submit.
• To create a route you can search the trailhead on the search window and click "Search" button to pan the map to the area
• Your map will be loaded with trails (colorcoded) in the area you searched and a list of the trails with trailnames will be displayed in the right hand side of the map.
• You can click on any trail and you will be able to see an elevation profile for that trail.
• You can double click on the map to create a marker
• To add note on marker you can right click to add a comment and "Update" to save your comment
• Once all markers for your route have been added, click "Log This Route" to save your trip information.
• All data entered for the trip will be saved next time you login and visit the trip page.

Blerina Aliaj is an Electrical Engineer entering the world of Software Engineering.