Location

Spotfire reserves two document properties for adding location services to an analysis. Such an analysis is designed to be used on a mobile device. The document properties are named AppGeoLatitude and AppGeoLongitude and are of data type Real.

An analysis that contains these document properties displays an active location icon on a mobile device. If the document properties are not included in the analysis, the location icon is not available.

When you add the document properties to a Spotfire analysis, set them both to 0.0. (The app interprets these values as setting the location to inactive.) When the mobile device user taps the location icon in the app, the current latitude and longitude are passed to the document properties

Note: A data table with columns containing latitude and longitude can take advantage of the Spotfire expression method GreatCircleDistance() to create a calculated column containing the distance between the device location and all locations in the data. Multiply the resulting value by the radius of the planet. (For more information on GreatCircleDistance(), see its reference topic in the Spotfire help system.

For kilometers, use 6371.
For miles, use 3959.

For example, the following expression gives the distance in kilometers.

6371 * GreatCircleDistance(${AppGeoLatitude}, ${AppGeoLongitude}, [latitude_column_name], [longitude-column_name])

To begin adding location service to your mobile app-ready analysis, go to Adding positioning capabilities for mobile users.