SAP Lumira – How to extend Lumira with Location Analytics and your own geodata

This part 2 explains how to build custom maps in SAP Lumira using Galigeo free extension for Lumira Desktop.

It follows the part 1 that explains the main concepts to add custom geodata and geomaps in Lumira.

You can find it here.

Let’s say that I have crime statistics for New York City per year and geographic sectors, called precincts.

The geographic NYC precincts come from the NYC OpenData website.

The geodata have to be in geoJSON format and in standard WGS84 coordinate system (lat/long).

If your geodata is in the common shapefile format, you can use the following tool to convert it in GeoJSON.

Our goal is to be able to build a map of #crime by precinct, using the above specific geodata.

First of all, you must have already installed the Galigeo geomap extension for Lumira which you can find here.

Follow the installation instruction to install it in a couple of minutes.

The extension comes with a standard catalog of geodata, such as States, counties, zipcode samples.

The standard catalog, obviously, doesn’t contain the NYC precincts.

So let’s see how to enrich it with our custom geodata.

1. Copy the GeoJSON file into the directory:

C:\Users\[username]\.sapvi\extensions\bundles\galigeo\viz\ext\map\galigeo_viz_ext_map-src\map\layers\

2. Edit the catalog

For SapLumira 1.25, open the file located here:

C:\Users\[username]\.sapvi\extensions\bundles\galigeo\viz\ext\map\galigeo_viz_ext_map-src\map\layers\catalog.json

The file contains sections describing the metadata for each layer.

• country: Country or area that will appear in the catalog
• label: Name of the custom layer that will appear in the map
• field: Field of the geoJSON file to match with the Lumira geographic dimension
• url: URL to the geojson file. $layers is replaced by the default layers directory.
• keywords: Name of the dimension to match with the geodata field
• geometryType: ‘point’ or ‘polygon’ according to the type of geometry
• description: A description that will appear in the catalog

Copy/paste one section and modify it according to your data

In our example, we put:

{

        “country”: “USA, NYC”,

        “label”:”NYC precincts”,

        “field”:”precinct”,

        “url”:”$layers/precinct.geojson”,

        “keywords”:[“Precinct”],

        “geometryType”:”polygon”,

        “description”:”NYPD precinct area by code. For example 1,2,3,..100…”,

            }

3. We recommend to test your JSON syntax

To make sure the catalog.json you are working on is valid after your changes, go to this tool, and copy/paste the entire content of your file.

We are fully aware that editing JSON can be painful and our next version will offer a killer new feature to skip this step;)

4. Save and close the catalog

5. (Re)start Lumira

Choose Galigeo map extension and check the online help.

Go to the section “Available Geographic Layers”.

Check that your new layer is in the catalog.

Then add the Lumira geographic dimension in the GeoLayers box and a measure in the indicators box to get your location analytics with your own geodata.

Here, you can see the number of Robberies per precinct in 2014 displayed as a choropleth map through a quantile classification.

Thank you for reading and I look forward to your feedback, questions, or ideas to improve your UX and build better products.

Sébastien