Meetr

A Ruby on Rails app to help groups decide on a central location to meet at when people in the group are coming from different start locations. Once the app figures out the mid-point, it also suggests venues that people can meet at.

Models
Rails Routes
3rd Party API details
Algorithm
User Journeys
Screenshots

Models

User

first_name
last_name
email
password

Meeting

title
midpoint_latitude
midpoint_longitude
date_time

User_Meeting (Join Table)

user_id (validation for unique)
meeting_id (validation for unique)
start_latitude
start_longitude
user_status (created | invited | confirmed | declined)
start_address

Venue

name
address
category

Meeting_Venue (Join Table)

meeting_id
venue_id
selected ---- boolean

Rails Routes

Helper	HTTP Verb	Path	Controller#Action
meeting_venues_path	GET	/meeting_venues(.:format)	meeting_venues#index
	POST	/meeting_venues(.:format)	meeting_venues#create
new_meeting_venue_path	GET	/meeting_venues/new(.:format)	meeting_venues#new
edit_meeting_venue_path	GET	/meeting_venues/:id/edit(.:format)	meeting_venues#edit
meeting_venue_path	GET	/meeting_venues/:id(.:format)	meeting_venues#show
	PATCH	/meeting_venues/:id(.:format)	meeting_venues#update
	PUT	/meeting_venues/:id(.:format)	meeting_venues#update
	DELETE	/meeting_venues/:id(.:format)	meeting_venues#destroy
venues_path	GET	/venues(.:format)	venues#index
	POST	/venues(.:format)	venues#create
new_venue_path	GET	/venues/new(.:format)	venues#new
edit_venue_path	GET	/venues/:id/edit(.:format)	venues#edit
venue_path	GET	/venues/:id(.:format)	venues#show
	PATCH	/venues/:id(.:format)	venues#update
	PUT	/venues/:id(.:format)	venues#update
	DELETE	/venues/:id(.:format)	venues#destroy
user_meetings_path	GET	/user_meetings(.:format)	user_meetings#index
	POST	/user_meetings(.:format)	user_meetings#create
new_user_meeting_path	GET	/user_meetings/new(.:format)	user_meetings#new
edit_user_meeting_path	GET	/user_meetings/:id/edit(.:format)	user_meetings#edit
user_meeting_path	GET	/user_meetings/:id(.:format)	user_meetings#show
	PATCH	/user_meetings/:id(.:format)	user_meetings#update
	PUT	/user_meetings/:id(.:format)	user_meetings#update
	DELETE	/user_meetings/:id(.:format)	user_meetings#destroy
meetings_path	GET	/meetings(.:format)	meetings#index
	POST	/meetings(.:format)	meetings#create
new_meeting_path	GET	/meetings/new(.:format)	meetings#new
edit_meeting_path	GET	/meetings/:id/edit(.:format)	meetings#edit
meeting_path	GET	/meetings/:id(.:format)	meetings#show
	PATCH	/meetings/:id(.:format)	meetings#update
	PUT	/meetings/:id(.:format)	meetings#update
	DELETE	/meetings/:id(.:format)	meetings#destroy
users_path	GET	/users(.:format)	users#index
	POST	/users(.:format)	users#create
new_user_path	GET	/users/new(.:format)	users#new
edit_user_path	GET	/users/:id/edit(.:format)	users#edit
user_path	GET	/users/:id(.:format)	users#show
	PATCH	/users/:id(.:format)	users#update
	PUT	/users/:id(.:format)	users#update
	DELETE	/users/:id(.:format)	users#destroy
root_path	GET	/	users#new
login_path	GET	/login(.:format)	sessions#new
sessions_path	POST	/sessions(.:format)	sessions#create
logout_path	POST	/logout(.:format)	sessions#destroy

3rd Party API Details

Signed up for the HERE API: https://developer.here.com/

API to search for lat long from user entered address or postcode:

https://geocoder.api.here.com/6.2/geocode.json?app_id=API_ID&app_code=APP_CODE&searchtext=USERINPUTHERE

API needs: searchtext=USERINPUTHERE

API to get address from lat, long:

https://reverse.geocoder.api.here.com/6.2/reversegeocode.json?app_id=API_ID&app_code=APP_CODE&mode=retrieveAddresses&prox=51.50463,-0.17189

retrieveAddresses&prox=51.50463,-0.17189 - enter lat, long here

API to search for places to eat or drink around there:

https://geocoder.api.here.com/6.2/geocode.json?app_id=API_ID&app_code=APP_CODE&searchtext=ec2a1NT

API needs:

cat=eat-drink at=51.5162,-0.0864;r=100 (positive number is latitude, negative is longitude, r is radius)

Algorithm

The algorithm takes in all the starting locations using either postcode or street addresses.
Convert locations to latitude and longitude.
Convert latitude & longitude coordinates into radians.
Convert latitude & longitude radians to cartesian (x,y,z) coordinates.
Sum the individual cartesian coordinates (ex. x1+x2+x3, y1+y2+y3, z1+z2+z3)
Convert summed cartesian coordinates to latitude and longitude for the midpoint (still in radians)
Convert latitude & longitude cartesian coordinates to degrees.
Ta-dah! This is your midpoint.

Remember: The shortest distance between 2 points on a sphere is not necessarily a straight line

User Journeys

TBD

Screenshots

User can sign up to Meetr
User can login to Meetr! User Details
User can view their profile and any meetings they're part of Meeting Details
User can view Meeting Details with central location and suggested venue.

artismarti/meetr