Gophered Guide

Last updated: Jun 15, 2018

Overview

Gophered is a free delivery driver tracking and management platform for individuals and casual users. The Gophered mobile application provides tracking of and route information to the user/driver. With the Gophered app, you can look at your assigned delivery stops, map them out, and perform delivery activities as required for each stop by the route manifest. A web-based admin system is available at https://gophered.com/admin to change and upload the route information, as well as view events reported by the app.

After registering and activating your account, an example route with 6 delivery stops will be created and added to your account. Running the app will show this delivery route, and you can map stops, mark a stop as delivered, capture signatures and scan QR codes for any stops requiring them. The admin events page will show gps locations from the app, as well as delivery events and new notes,pictures and signatures added via the app during delivery.

Getting Started

Step One: Install and run the application

Gophered is available on both iOS and Android devices. The initial release of Gophered is designed for phone form factors and not yet optimized for tablets. You can install the app from the appropriate store link below:




After installing the app, run the app to start the loading process. If this is your first time running the app after installation, you will be asked to allow Gophered access to your location.




Gophered Requirements

The Gophered app requires a working internet connection and location permissions to function. Location permissions should be authorized as "Always" instead of "WhenInUse" for proper tracking. Access to the camera is also necessary if you wish to scan qr codes or take pictures during delivery.



After granting permissions, you'll see the main login screen with links to the registration and password update screens.

Step Two: Register an account


If you don't have an account yet, tap on the "Need an account?" link to show the registration screen.


Fill out your first and last names, email address and a password to use on Gophered. An activation email will be sent to your email address. Tap on the link to activate your account and login to the app.


If you wish to change the password for your account, tap on the "Forgoten password?" link on the main login screen.


Fill out your email address and a password reset link will be sent to your email address. Tap on the link to update your account's password.

Step Three: Login to Gophered

Once you've signed up and activated your account, enter your email and password on the login screen, and tap the Sign-In button. The app will remember the last user email that logged in successfully.

Using the App

Route Overview

After logging in, the app will load your currently assigned route manifest. This manifest can be edited and changed via the Route Page. If you've made a change and wish to load the new route, logout of the app and log back in.

The App titlebar contains two buttons. The gear link on the right will open the settings page. The map icon on the left of the titlebar will change the current view to a map view initially centered on your first route stop. The map view contains markers for all of the stops on your route, and will display your current location as well. Tap on any of the stop marker icons to view the stop address. Tap the stop address to open the route stop details page for that delivery stop.

App Settings

The Settings page contains a button to log out of the app, and some information on the current route manifest state.

Synchronization timing

The Gophered platform relies on the app to send changes to the server, which are usually processed within a minute. If you log out the app immediately after making a change to the manifest state, please wait a bit before logging back in to ensure server has been updated with the most current state.

Delivery Stop Details and Actions

Tapping on a route list stop will bring up details about that delivery stop.

You can manually mark a package as delivered by tapping the Checkmark icon on the top right of the status section.

Gophered supports geofenced checks before allowing important actions to be taken for a route stop. When marking a package as delivered, capturing a signature or taking a picture, route stops can be set to check if the driver is within 500 meters of the stop address. Drivers can choose to override this although an event will be generated noting the possible discrepancy in location.

Some packages may be marked in the manifest as requiring a QR-code scan upon delivery. Tapping the QR-code icon will bring up your camera, center the camera view on the package qr code to be scanned. A matching QR code will mark the package as scanned. If it's the wrong package/code for this delivery stop, the app will show a warning instead. You can generate qr codes online for free from a number of sites such as this site

Route stops in the manifest may be marked as requiring picture proof of delivery. Tapping the camera icon will bring up a picture gallery page for this route stop. Users can view pictures and associated notes captured so far for the current route stop. Users can also add a new picture by tapping the button at the top of the page. This brings up a camera window where the recipient can take a picture and save it. Pictures and associated notes will be saved and uploaded to the server for viewing on the Events Page.

Tapping a picture will bring up the picture details page, where you can add or edit notes about the picture taken. You may also delete pictures on this page.

Some packages may be marked in the manifest as requiring signatures upon delivery. Similar to pictures, tapping the pencil icon will bring up a signature gallery page for this route stop. Users can view signatures and associated notes captured so far for the current route stop. Users can also add a new signature by tapping the button at the top of the page. This brings up a signature pad where the recipient can sign their name with a stylus or finger. Signatures and associated notes will be captured and uploaded to the server for viewing on the Events Page.

Tapping a signature will bring up the signature details page, where you can add or edit notes about the signature captured. You may also delete signatures on this page.

Tapping the map icon next to the delivery address will show the delivery address on the map with a marker. Tap on the car icon on the top right of app title bar to bring up directions from your current location to that address.

The next section contains a contact phone number for the delivery driver to use if necessary.

Tapping the phone icon will bring up the phone dialer and allow them to place a call.

At the bottom of the delivery details, the Notes for this location are displayed. Tapping the plus icon to the right of the notes area will bring up a screen where a new note can be added and sent to the server as a delivery event.

Chat support

Drivers can tap on the Chat tab on the bottom of the main route overview page to bring up the chat screen. Here drivers may exchange messages with the admin using the Gophered Chat Page.

Notifications will be shown in the title bar of the main route page whenever a new chat message is received while the user is not viewing the chat page. Currently notification support is limited to the main route page, so make sure to check periodically if you're actively waiting for a message.

Using the Admin

Route Management

The Route Page will show you the current route manifest to be loaded by the mobile client app.

A route manifest is a JSON array object that must conform to the following format. In particular, please note that Gophered does not allow the use of single or double quotes inside string values, and expects a curly apostrophe for proper formatting when one is used in a text field. The server and client will attempt to replace problematic characters but care should be taken when modifying route manifests.

{ 
    "route_date":"2018-05-03", //String value, route date
    "driver_name":"Antonio Montana", //String value, driver name 
    "route_list":"2018-05-03", //Array value, route stop array
[ {
    "index":1, //Integer value, route stop order
    "stop_id":"2200" //Integer value, route stop id
    "stop_type":"2200" //String value, "commercial" or "residential" stop
    "name":"Marcus Initial",//string value, recipient name
    "address_street":"66 NE 39th St",//string value, street address of delivery location
    "address_street2":"USPS",//string value, street address line 2
    "address_city":"Miami",//string value, city of delivery location 
    "address_state":"FL",//string value, state of delivery location 
    "address_zip":"33137", //string value, zip code of delivery location
    "phone":"1 (800) 275-8777", //string value, phone number for delivery location
    "notes":"Ignore the dragon and gryphon", //string value, notes for this stop separated by \n
    "latitude":"25.8124116",//float value, latitude of delivery location
    "longitude":"-80.1943161", //float value, longitude of delivery location
    "req_signature":true, //boolean value, require a signature for this stop
    "req_picture":true, //boolean value, require a picture for this stop
    "req_qrcode":false, //boolean value, require a qr_scan for this stop
    "is_scanned":false, //boolean value, if this stop has been scanned successfully
    "bag_id":"101",//string value, used to match qr code scanned bag id
    "status":"pending", //string value, current status of delivery for this stop
    "signatures":[],   //Array value, signature filenames and associated notes
    "pictures":[],   //Array value, picture filenames and associated notes
},
{
    ...   //next delivery stop 
},
    ... //additional delivery stops
]}
                                        

If a stop requires a scan, the QR Code being scanned should encode a string in JSON format like {"bag_id":"BAGID"} where BAGID is the id specified in the route manifest for that stop. For example, the following qr code should be scanned for stop #6 in the sample route generated with the Gophered App when you first activate your account.

Tracked Events

The Events Page will bring up a table of all events recorded by the mobile client app so far. On the top of the page you have several export options, including:

  • Copy
  • - copies the data as an array to the local clipboard
  • CSV
  • - downloads all event data in CSV format
  • Excel
  • - downloads all event data in Excel format
  • PDF
  • - downloads all event data in PDF format

You can click on any of the column headers to sort by that value. Events that captured a signature/picture will have a clickable link to show the signature/picture from that event. Any added notes will appear in the same column for those types of events.

Account Info

This page will show your account details, and give you an option to logout of the admin site. There is a contact form on the bottom of this page in case you wish to send us a question or suggestion regarding Gophered.

Gophered Credits

The gophered platform was created with the help of many open-source projects, including: