artismarti / meetr

Find a meeting place in between

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

1. The algorithm takes in all the starting locations using either postcode or street addresses.
2. Convert locations to latitude and longitude.
3. Convert latitude & longitude coordinates into radians.
4. Convert latitude & longitude radians to cartesian (x,y,z) coordinates.
5. Sum the individual cartesian coordinates (ex. x1+x2+x3, y1+y2+y3, z1+z2+z3)
6. Convert summed cartesian coordinates to latitude and longitude for the midpoint (still in radians)
7. Convert latitude & longitude cartesian coordinates to degrees.
8. 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.