How To Create Your Own Geo-Locator App
A geo-locator app can be used to search for and filter through programs and services in your area. Click the video to watch a presentation explaining what a geo-locator app does and why it can be useful. This repository was created to help you create your own version of Suffolk LIT Lab's geo-locator website application, which can be found here. Here are the steps to create your own geo-locator website application:
1. Head to https://github.com/ and create your own account.
2. Once you've created an account, go to https://github.com/SuffolkLITLab/resource-map-how-to.
3. Click on the index.html file.
4. Click the pen button to edit the code. You will have to verify your GitHub account via email before editing anything.
5. Copy the all the code from index.html. This is blank template where you will insert all the data needed.
6. Click fork on the top right hand corner.
7. Choose your profile to save under. Click the index.html file. Click the pen button to edit the code.
8. In the index.html file, paste the copied code.
9. Commit the changes on the bottom of the page.
10. Go to settings. Scroll down to GitHub Pages and turn on master branch.
11. Change the name to what you would like as this is how it will show up in the URL. Go back to the repository by clicking where the arrow is pointed.
12. Go to a different tab/window. Create an Airtable account here. Airtable will be free since this app will likely not be used for commerical purposes.
13. Choose a base template that suits your needs.
14. Add tabs for all the different locations desired (i.e. Boston, Roxbury etc...) and add a "locations" tab.
15. Under the "locations" tab, include the name, latitude & longitude coordinates, and zoom for each location. To find the latitude & longitude, you can use this website. To add the zoom, add a comma then a number (i.e. ,13 ,14 ,15) to the end of coordinates.
16. Use the following headings for the different sections on the Airtable: Name, Category, Minimum age, Maximum age, Address, Description, Wesbite, Phone, Email, Valid As Of, Latitude, and Longitude.
17. Under the Category heading, create your own set of categories (i.e. community outreach, job opportunities/training, health services etc...).
18. Conduct research on the programs you want to include. Begin inputting your own data into the Airtable.
19. Turn to the index.html file. Click the pen button to edit. Update lines 7 & 34 to create your own title.
20. Update line 38 to include your own description (i.e. "Use the following selections to find juvenile social, community based programs & services in and around Boston").
21. Update line 46 to describe age filter.
22. Now turn to line 73 to update your own About page.
23. Update line 142 to input your own Category names. Make sure the Category names are spelled exactly as they are in the Airtable to ensure the data is inputted correctly into the code. Tag the categories as you want to refer to them throughout the code (i.e. "Alternative" "Risk").
24. Put the tagged names into line 208 (i.e: checkbox-v-Alternative').
25. Go back to your Airtable. Find your API key. You can follow the steps below or go to this website. Go to your profile, click "Account." Scroll down to find your unique API key.
26. Copy and paste your API key in line 141 of the code. Make sure "key" is not entered into the code twice.
27. Find your API documentation. You can follow the steps below or go to this website. Click the question mark then go to "API Documentation." Look to the URL at the top of page and copy everything after the "app."
28. Copy and paste your API documentation in line 140 of the code. Be sure to only have "app" in the code once.
29. Find your Google Maps API. To find your Google Maps API go here and follow the steps below. You will have to sign into Google using a gmail account. Once you're signed in, click "Get Started"
30. Choose the Maps selection. Click "Continue."
31. Click "My Project" or create a new one.
32. Google will then ask you to enable billing. Even though you must input a credit card, Google gives $200 a month of free use. It is more likely than not that you will still not reach the $200 threshold because the app will likely be for internal use with only a few dozen people utilizing it. For more info on this, you can click here. Click "Create Billing Account."
33. Input your credit card info then hit "Submit and Enable."
34. Your Google API key should then generate. Copy the Google API key and turn to line 136 of the code. Paste your own Google API key.
35. Commit the changes on the bottom of the page.
36. Go to settings again, scroll down to GitHub pages to find your own URL link.
37. Click the URL and utilize your own geo-locator app!