MGSi Tracking (Maps)

The UWP / Android / iOS screen-shots for each page are grouped together. Use the Show/Hide Options to toggle the display of the screen-shots for each device type.

The Android screen-shots are from an Android Pixel 5 R 11.0 - API 30 device. The iOS screen-shots are from an iPhone SE (3rd generation) iOS 16.0 device.

Contents (by function)

Getting Started with the MGSi Tracking app - Taps and Keystrokes

This topic details the taps and keystrokes for getting started with the MGSi Tracking app once it has been installed.

The MGSi Tracking app is an app for displaying geofenced maps and the geolocation coordinates of cattle that have been outfitted with Oyster IoT devices. Additionally, notifications are sent when a device reading is outside of the geofence.

Definition: A geofence is a virtual perimeter for a real-world geographic area. A geofence could be dynamically generated or match a predefined set of boundaries. The use of a geofence is called geofencing, and one example of use involves a location-aware device of a location-based service object (user, vehicle, cow) entering or exiting a geofence.

Definition: Web hooks are user-defined HTTP callbacks. They are triggered by some event in an application (Dragino) and can facilitate integrating different applications (MGSi) or third-party APIs.

For additional information see:

Installing the MGSi IoT software and Configuring IIS

This section details installing the MGSi IoT web software and configuring IIS. This section is applicable only if you are running a standalone version.

Installing and Configuring SQL Server

A standard setup is all that is needed. Once installed, create the MGSiIoT database via a Restore operation.

Installing and Configuring IIS

Configure the application pool and application. The suggested names are MGSiIoT for each.

Configuring the IoT Hardware

This section details configuring the IoT hardware to be used.

Configuring the Router

Configure a hard-coded IP address for the Dragino console to access. Create a second IP address for the MGSi server machine for use in defining the web hooks.

If the router is not connected to the internet, the Oyster location events may not have accurate values.

Configuring the Dragino Gateway

See Configuring the Dragino Gateway.

If the Dragino Gateway is physically moved or attached to a different router, restart all devices in order to force a re-join. For Oyster devices, remove the battery for 30 seconds.

Creating an Application in the Dragino Gateway

Each different device 'type' (Oyster, Arduino, Nanotag) must be defined in its own Dragino application. The web hooks for a device are unique, due to the unique JSON format of the data transmitted to the server.

See Applications.

Defining the Devices in the Dragino Gateway

See Devices.

Once the device has been defined in Dragino, the device needs to be defined in the MGSi app.

Note that a map (geofence) must be defined in the MGSi app before you associate a device with a map. I.e., the MGSi Tracking Device page has a required field for the map.

The first device for an application must be entered manually in the MGSi app.

Tip: Copy and paste the values from the Dragino console - Live Data tab - end_device_ids hive of the json file that is displayed.

If the device has been configured in the Dragino, but not in the MGSi app and this is not the first device for the application, on the first event received in the MGSi Tracking app for the device, the device is inserted into the database. Use the MGSi Tracking Device page to complete the configuration for the device: specify the map the device is related to, if the device is active and the pin color.

Configuring the Web Hooks in the Dragino Gateway

The IP address used must be accessible from the Dragino console and point to the machine that has the MGSi server side software installed.

See Web Hook.

Creating the Geofence

The following are the app options for creating the geofence. Note that you can "manually" create a geofence by specifying the geolocation points in the MGSi Tracking Map Fence Post page.

Creating a Geofence using the Oyster device (Walk-the-fence)

This option also verifies that the Oyster device is working properly and that the private Lora network coverage is sufficient.

Configure the Oyster device in Dragino and ensure the Uplink web hook is configured. The first uplink event will insert the Oyster device ID in the MGSi database. You could also enter the Oyster ID's using the MGSi Tracking Device page.
From the MGSi Tracking Home page tap the New Map menu option, then tap the New Map option. The MGSi Tracking Map Properties page is displayed.
Select the Oyster device and specify -1 for the Animal ID field. Complete the other fields, then tap Save.
The Center latitude and longitude values are filled with your current geolocation. These values will be updated once a polygon has been formed (when there are at least 4 fence points).
Go the starting position.
Ensure that the device registers your current location.
Start walking (or ATV-ing or horse back) the fence line, stopping at regular intervals for the Oyster device to transmit the location.
When you have returned to the starting point, remove the battery from the Oyster device to prevent additional Oyster events from being generated, which would insert more fence posts.
Open the MGSi Map Properties page and change the Animal ID field from -1 to 0.
Put the battery back into the Oyster device.
Tap Home to return to the MGSi Tracking Home page, then select the map item you just created. The map is displayed using the Oyster location values that are stored in the database.

Determining Geolocation Points

Microsoft, Apple and Google web sites each have the capability to determine a specific point. You can then copy/paste these values into a TXT file for use with MGSi Import (List) or the MGSi Map Properties, MGSi Map Fence Post and MGSi Map Reading pages. This may become tedious. As an alternative for the Reading page, use the Create a Reading Here option.

Microsoft - Windows 10+

Run the Windows Map app, click in the map and select the 'Drop a pin' option. A dialog is displayed with the geolocation coordinates. Copy the latitude and longitude values and paste into the TXT/CSV file or the MGSi app page listed above.

Google Maps from a Desktop Browser

Go to https://www.google.com/maps/. Right mouse on the map. A dialog is displayed with the geolocation coordinates at the top. Copy the latitude and longitude values and paste into the TXT/CSV file or the MGSi app page listed above.

[Desktop Browser]

Screen Capture

Apple Maps from a Mac

Run the Map app, click in the map and select the 'Drop a pin' option. A dialog is displayed with the geolocation coordinates at the top. Copy the latitude and longitude values and paste into the TXT/CSV file or the MGSi app page listed above.

Nudge Options

The MGSi Map Properties, MGSi Tracking Map Fence Post and MGSi Map Reading pages each have "nudge" options (North/South for latitude and East/West for longitude) for moving/adjusting the geolocation value 10 feet (0.0000275 degrees for latitude and 0.0000347 degrees for longitude).

Use the Map (External) menu option from these pages to display the native map app using the latitude and longitude values configured.

Note that there are no nudge options for the web version. A step increment of 0.000001 is used.

Notifications

When a device reading is outside of the geofence, an alarm is sounded and an email is sent to the user(s) that have the Notify option selected in the MGSi Tracking User page.

Sample Email

[Sample Email]

Screen Capture

Initial Keystrokes

The following are the keystrokes you can use to start using the app.

MGSi Tracking Logon page

The MGSi Tracking Logon page is displayed when you launch the MGSi app, and from the 'Logoff' menu item.

Type your user id in the 'User ID' edit box.
Type your password in the 'Password' edit box.
Tap the 'Save Password' switch to save the values. If this field is left off, you will need to enter your credentials each time you launch the MGSi app.
Tap the 'Select an App to connect to' picker and tap the 'MGSi Tracking' item.
Tap 'Connect'. If you are connected to the internet and you typed valid credentials, the MGSi Tracking Home page is displayed

MGSi Tracking Home page

The MGSi Tracking Home page is displayed when you logon and lists the defined maps.

Tap an item in the list to display the map. The MGSi Tracking Map page is displayed

MGSi Tracking Map page

The MGSi Tracking Map page displays the geofence defined map with pins of the geolocation coordinates of cattle that have been outfitted with Oyster IoT devices and have been assigned to that map.

Tap a pin to display a popup with the details of the pin.

Web version

The following details the design of the MGSi Tracking web app.

Each page has a navigation section (top) + body section + footer section.
The navigation section collapses to a pancake based on sizing.
The contents of the navigation and body section varies by page.

Web vs. Device version

The following details the differences between the web version and the native device versions.

There is no explicit Top or Bottom options. Tap the MGSi logo at the top of the webpage to go to the bottom of the webpage. Tap the triangle glyph at the bottom of each page to go to the top of the page, or press the Home key.
There is no explicit Refresh option. Tap the F5 key in the browser.
There is no logging.
The web versions have Pin Clustering in the maps.
There are no 'nudge' options due to the step attribute of the number input type.
There is a 'full screen' glyph in the upper right of the google map.

Top • Bottom

MGSi Tracking Logon

Tracking Logon

MGSi Tracking Home (Maps)

Map Item Options

There are three buttons that can be displayed for each item in the list. Click on the button to display the map.

Map Options

The Map Options action sheet is displayed when you tap on an item, but not one of the buttons. Each item is a "shortcut" than can be duplicated using the MGSi Tracking Search page.

The 'All readings and devices (if any)' item is always displayed. The other options are not displayed if the map doesn't have any readings or the geofence has not been configured.

The Properties button is used to go directly to the Properties pages without displaying the map. When you display a map, Google and Microsoft both increment their billing counters.

Tracking Home (Maps)

UI Fields

MGSi Tracking Search

Used to search the readings and display a map with the results. This is most often used instead of the Map Options from the Home page to limit by device or date range.

To find devices incorrectly assigned to a map, don't select an option from the Devices picker.

Tracking Search

MGSi Tracking Users

Tracking Users

MGSi Tracking User

Tracking User

MGSi Tracking Alarms

Tracking Alarms

UI Fields

MGSi Tracking Alarm

Used to configure the details for the IoT alarm device for sending Downlink events to the Dragino gateway so that the MGSi servers can turn on the alarm when a cow is outside of the geofence. This is similar to configuring the IoT Oyster + devices for Uplink events that sends geolocation data to the MGSi servers.

Tracking Alarm

UI Fields Source

Notes

When the app is running on the MGSi servers (and not in "Stand Alone"/local mode: on your premises), the Alarm value on the MGSi Tracking Device page should be selected only if there is an accessible public IP address for the IoT alarm that can be specified for the Gateway.

The Alarms drop down list on the MGSi Tracking Device page only displays Active alarms.

MGSi Tracking Devices

Tracking Devices

MGSi Tracking Device

Tracking Device

MGSi Tracking Map Company

Tracking Company

UI Fields

Email Sent

MGSi Import (Google Map)

Creating a Geofence using Google Maps

Import (Google Map)

MGSi Import (List)

Creating a Geofence using a TXT or CSV file

Import (List)

MGSi Walk the Fence

Creating a Geofence using the Walk-the-fence option

Walk the Fence

MGSi Tracking Map

Only readings (pins) marked as active are displayed. If the query used to display the map didn't exclude inactive readings, use the MGSi Map Reading page to edit those readings.

Tracking Map

Blocked Map

The web version uses the Google Maps API which has many features that have nothing to do with displaying a map. Many of these features will cause the browser to block the display of the map and the message 'If this message is displayed, the maps.googleapis.com site has been blocked by your browser.' will be displayed. To verify that the browser is blocking google (and not a JavaScript error), from Firefox, press the F12 key and tap the Console tab. Look for the 'the resource as https://maps.googleapis.com/maps/api/js" was blocked' message.

Fix (for Firefox)

From your browser settings - Privacy and Security tab, in the Custom section, click the Change block list link. Change from Level 2 to Level 1.

Privacy and Security tab - Custom section

Block List

UWP (Hybrid)

Maps for UWP display sequence numbers ("tooltips") next to the pin.

Screen Capture

Pin Information

Screen Capture

Create a Reading Here

Tap on the map and the confirmation message 'Create a Reading Here?' is displayed. Tap Yes, and the MGSi Tracking Map Reading page is displayed. This option is available for admin users only on UWP devices.

If this prompt is displayed while you are trying to tap a pin, zoom the map and try again. Also, tap on the dot at the bottom of the pin to avoid the prompt. Tapping on the pin above the dot may also display the prompt.

If the prompt is not displayed, try tapping 'a bit' away, and then use the nudge options to move the pin where it needs to go.

Screen Capture

Find Pin options

Screen Capture

Android (Hybrid)

Screen Capture

Pin Information

Screen Capture

Create a Reading Here

Screen Capture

Find Pin options

Screen Capture

iOS (Hybrid)

Screen Capture

More options

Screen Capture

Pin Information

Screen Capture

Pin Information - Info tap

Tap on the "circle i" glyph to display additional details.

Screen Capture

Create a Reading Here

Screen Capture

Find Pin Options

Screen Capture

Web Parque Cuscungo (2)

Screen Capture

Pin Information

Screen Capture

Create a Reading Here (Toggle)

Screen Capture

Create a Reading Here

Tapping OK takes you to the MGSi Map Reading page.

Screen Capture

Find Pin options

Screen Capture

MGSi Map Properties

Used to display the properties for the map. Changes can be saved by Admin users only.

Map Properties

MGSi Map Fence

Map Fence

MGSi Map Fence Post

Map Fence Post

MGSi Map Readings

Used to display the readings transmitted from the IoT device and which are displayed in the map.

Note that the counts displayed include the centroid. Also, for UWP, the sequence number is the Pin # displayed on the map.

Distance Calculation

For tracking the movement of a specific device (animal/cow) the Distance from Prior Reading values are most accurate if all readings are from the same device and sorted in the Date Created sequence (which is the initial sort sequence) or by the Device ID. For this scenario, use the MGSi Tracking Search option from the MGSi Tracking Home page to search by Device ID.

Map Readings

MGSi Map Reading

Tracking Map Reading

MGSi User Guide Search (Device)

Enter a term to search for in the Search Term edit box, then tap Submit. From the Results page, tap on an item in the list to display the User Guide webpage (topic) with each occurrence of the search term highlighted. The results are sorted by the webpage Title in ascending sequence. Note that searches are case-insensitive.

User Guide Search

User Guide Search Results

Help Topic

A toast message is displayed with the number of occurrences of the term in the help page.