Overview

The First Two integration integrates the First Two  platform with the Sureview Maps UI allowing for the use of First Two Data within an Event.

 NOTE : This features requires a External Map Layer click handler to display correctly CC-PLUGIN-FirstTwoPlugin.

Enable the Feature

The FirstTwoIntegration feature under ExternalMapLayers must be enabled for the click handler to properly work.

Set the Prefs

There are two Prefs as part of this FirstTwo integration. The Prefs are system wide Prefs under Maps, Setup.

FirstTwo User Email is Email address used to make request to the First Two api. If not set the logged in users email will be used. (If the user has no email set their username will be used as a last resort).

FirstTwo Location Endpoint is the url that First Two requests will be sent to.

At time of writing it is currently https://api.firsttwo.com/api/1/locations/latlng.

Add an Externa Map Layer

Creating a First Two Layer
To be able to use First Two data on the map an External Map layer of Type First Two must be created. Below is an Example of how a First Two External Map Layer looks within the External map layer setup module.

Title: What do you want the layer to be named

Type: FirstTwo

URL: This should point at the GetGeoJSON/FirstTwo endpoint within the ExternalMapLayer data service. It should look like the following:

SERVER: http://{SureView Host}/api/ExternalMapLayers/GetGeoJSON/FirstTwo

Click Handler: This should be set to the FirstTwo click handler. Ensure you have the First two click handler plugin installed.

Secure Layer: check
Username: This is the Agency/Organization username.
Password: This is the Agency/Organization password.
These are the same two fields used to Authorize yourself in the firstTwo api (https://www.firsttwo.com/apidocs/1/index.html#/)

NOTE: This layer type cannot be previewed within the External Map Layer Setup as it requires a location based component

Using First Two in maps

Once you have Created a First Two layer view an Event and Set the First Two external map layer to visible using the layers dropdown within the enhanced map.
This will display the 25 nearest First Two locations (api limitation) to the event location. The names of any residents (and their age within parentheses if provided) under each marker
These Markers can be clicked to display more information about the marker.

Example: