Latitude and longitude coordinates in Location API

MSE returns geo-coordinates when floor is has correct GPS Markers.

Test1

1. Put three or more valid GPSMarkers on a floor say (floor1) and save it in PI. While saving PI should not complain and this is an indication of these are valid GPS Markers. You can refer to below PI link.

http://www.cisco.com/c/en/us/td/docs/solutions/Enterprise/Borderless_Networks/Unified_Access/CMX/CMX_Prime.html#pgfId-1019702

2. Export this map from PI and you will get a tar.gz file.

3. Import this map to MSE 10 by using the CLI cmxconfig maps import

4. Check the log /opt/cmx/var/log/configuration/server.log and you should not see any error like ERROR com.cisco.mse.maps.ImportParser - ImportParser: Invalid GPS Marker info

Expected

Search for any client (detected or connected) on floor1 with REST API

http://<mse-ip>/api/location/v1/clients/04:db:56:af:f9:37

You should see the

geoCoordinate: {

lattitude: -81.4699689073352,

longitude: 0.00006206022536177526,

unit: "DEGREES"

}

Test2

1. Assuming you have the GPSMarker present on floor1, Add a Notification for type locationupdate, inout and movement using MSE UI ? Manage tab.

2. Check the Notification Payload sent by MSE.

Expected

You should see the geoCoordinate in the payload. Below is the example payload.

{"notifications":[{"notificationType":"inout","subscriptionName":"InOut","entity":"WIRELESS_CLIENTS","deviceId":"30:a8:89:e4:96:f7","lastSeen":"2015-05-20T00:56:56.115+0100","ssid":null,"band":null,"apMacAddress":null,"locationMapHierarchy":"System Campus>Nortech>BLE Floor","locationCoordinate":{"x":42.171116,"y":44.58178,"z":0.0,"unit":"FEET"},"geoCoordinate":{"lattitude":-121.92909062204372,"longitude":1.6066022581458773E-4,"unit":"DEGREES"},"confidenceFactor":256.0,"boundary":"INSIDE","areaType":"FLOOR","timestamp":1432079816115}]}

{"notifications":[{"notificationType":"movement","subscriptionName":"Movement","entity":"WIRELESS_CLIENTS","deviceId":"da:cc:21:3e:be:ff","lastSeen":"2015-05-20T00:54:29.638+0100","ssid":null,"band":null,"apMacAddress":null,"locationMapHierarchy":"System Campus>Nortech>BLE Floor","locationCoordinate":{"x":78.68433,"y":16.250189,"z":0.0,"unit":"FEET"},"geoCoordinate":{"lattitude":-121.92901074126753,"longitude":3.169220016955197E-4,"unit":"DEGREES"},"confidenceFactor":32.0,"moveDistanceInFt":63.234623,"timestamp":1432079669638}]}

{"notifications":[{"notificationType":"locationupdate","subscriptionName":"Test","entity":"WIRELESS_CLIENTS","deviceId":"78:33:8c:82:bd:ff","lastSeen":"2015-05-20T00:50:24.050+0100","ssid":null,"band":null,"apMacAddress":null,"locationMapHierarchy":"System Campus>Nortech>BLE Floor","locationCoordinate":{"x":36.35105,"y":77.63683,"z":0.0,"unit":"FEET"},"geoCoordinate":{"lattitude":-121.92917122084997,"longitude":1.284373308479956E-4,"unit":"DEGREES"},"confidenceFactor":136.0,"timestamp":1432079424050}]}