How To Guide
Uber-style GeoTracker

What is the Uber-style GeoTracker? Back to top

The Uber-Style Geotracker is a PHP/MySQL script that allows ANY group of smartphone owners to track each other's geolocations in near real time (default: every minute).

In my opinion Uber app's user interface is what sets it apart and is the key to uber's success. It is real time, accurate, easy to use and informative and what makes taking uber more attractive than taking a cab. Customers knowing where the drivers are at any time made the difference and redefined the for hire transporation business.

Now, imagine being able to apply that to daily life with family, friends, coworkers, employees, etc. Now you can with this script!

- Data Ninja (7/12/2017)






How it works Back to top

  1. Decide on the group of people you want to geotrack ("geotrackees") in a private geopmap and enter their emails in textarea on home page.
  2. Click on the invite button and an email with GeoTracking link will be sent to each geotrackees' email address.
  3. Each geotrackee will receive and email similar to below. Each simply clicks on the link to start geotracking and closes browser or navigates to new web page, to stop.
  4. Keep browser with private geomap active to keep updating geolocation real time. (you may want to disable screensaver)
  5. Close browser or navigate to a different web page to end geomapping.
  6. Re-click (reuse) geotracking link in email if you want to tracking to commence again.





Personalize your marker Back to top

To personalize your marker:

  1. Click on the geotrackee profiles link on the top right.
  2. Select from preloaded images or
  3. Upload your own photo - for best results - centered landscape (button on the rightside) or square photos make the best markers.





Change Geomap Theme Back to top

To change your geomap theme:

  1. Click on the settings button on the top right.
  2. Click on Geomap theme accordion.
  3. Scroll thru map theme selections and select new theme.





Invite New GeoTrackees Back to top

To invite more folks to join your geomap:

  1. Click on the settings button on the top right.
  2. Click on Invite More Geotrackee accordion option.
  3. Add new email address in textbox.
  4. Click button to send out invites.





Adjust Frequency Settings Back to top

Depending on capacity of your server and how much phone battery storage you want to preserve, you can adjust refresh frequency of map:

  1. Click on the settings button on the top right.
  2. Click on Refresh Settings accordion option.
  3. Update refresh frequency in seconds and also whether to refresh only when change detected or all the time.
  4. Refresh Now button allows you update map immediately at any time.





Installation Instructions Back to top

Install this script on a LAMP or WAMP server or hosting service:

  1. IMPORTANT: This script runs off the root of your domain. You will need to set up a subdomain (e.g. https://subdomain.domain.com) if you need to install in a folder on your webserver.
  2. Compare your php/mysql server settings with https://geotracker.dataninja.biz/php/phpinfo.php
  3. REQUIRED: Your server needs to set up for HTTPS (SSL cert) for geolocation technologies to work
  4. Unzip contents of purchased zip file into the folder you've designated for your domain or subdomain in step 1.
  5. Edit /php/config.php and modify database settings and update mapbox access token key to your own - go to https://www.mapbox.com/help/how-access-tokens-work/ to generate your own.
  6. NOTE: If you need continuous tracking, go to documentation and review the 'Disable Phone's Auto-lock' section. You will need to prevent phone from 'sleeping' if you want continuous tracking. Also, see 'Adjust Refresh Settings' to set refresh frequency (be sure you have a server/hosting account that can support the number of hits per day from this setting)
  7. NOTE: If you plan to use SMS text invite feature (not required, if email invitations are okay) you will need to sign up for a Twilio Account - put your account number and auth token on the top of /php/config.php file.