HISTORY MAPS

Table of Contents

1. About Our Project
   • Built With
   • Tested With
2. How to Use History Maps
   • Repo and Heroku Sites
3. Contributors

About our Project

---

Our goal is to inspire curiosity about local history and provide an educational resource to enrich our relationships with the communities we live in. Whether you are history-curious, a fan of architecture, vintage photography, or just feeling sentimental, History Maps has thousands of local photographs to help you explore the past.

Built in two weeks by a team of six, our front end utilizes eight endpoints built by our back end team, consuming the Library of Congress and Mapquest API to find historical photographs near an address that is entered by a user. Utilizing Google Oauth for enhanced security, our application is easily accessible and intuitive to navigate.

In the future we would like to offer a map function where users can get directions to the historical landmark of their choosing, further enhancing the educational community engagement we hope to foster.

If you would like to contribute, feel free to reach out to any of the contributors on GitHub! Find our contact information below!!

Built With

• Rails v5.2.8
• Ruby v2.7.4

Tested With

• RSpec v3.11
• PostMan

(back to top)

How to Use History Maps

---

To access all of History Map's features, navigate to our home page at https://find-history-maps.herokuapp.com/ and click the 'Login' button in the upper left corner. After completing authentication, enter a zipcode or full address into the search bar. You will be brought to a search results page where you can see local historical photographs! To add a location to your favorites, press the "Add to Favorites" button below that listing.

For extra fun, visit the historical building in the photograph! Happy history hunting!

If you would like to explore the History Maps repo further:

• Fork and Clone
• Run 'bundle install'
• Run 'bundle exec figaro install' to create an application.yml file
• If you would like to expiriment with the Google Oauth environment, apply for a Google Client ID & Google Client Secret and explore documentation at https://developers.google.com/identity/protocols/oauth2
• Put the Google Client ID & Google Client Secret in your application.yml file
• To run our RSpec testing suite, run 'bundle exec rspec' from the command line

(back to top)

Repo and Heroku Sites

---

Backend

• https://github.com/enalihai/history_maps_be

• https://history-maps-be.herokuapp.com/

Frontend

• https://github.com/clayash/history_maps_FE

• https://find-history-maps.herokuapp.com/

(back to top)

Contributors

---

Zac Hazelwood
GitHub: @ZacHazelwood

Oscar Santos
GitHub: @Oscar-Santos

Luke Pascale
GitHub: @enalihai

Clay Ash
GitHub: @ClayAsh

Matthew Deming
GitHub: @Deming-Matt

Colin Reinhart
GitHub: @ColinReinhart

(back to top)