Let's have a look at the available data before we define the corresponding dataset object.
The data we will visualize in this tutorial represent our customers. The anonymized table contains each customer's internal ID, city, address, sex, age group and most importantly - latitude and longitude of the address. The table also contains code of the neighborhood to which the address belongs, which we'll use later.
This tutorial contains geocoded data - we know the latitude and longitude of the address.
This does not always have to be the case. In case you need to geocode your data - use one of the web services, e.g. OpenCage Geocoder, or contact us.
Download the CSV file and put it in the /data folder of your dump.
Creating a dataset
Now, we will create the corresponding dataset. Dataset object has some specifics which differ it from other metadata objects:
it contains properties with featureTitle and featureSubtitle settings
has a ref object instead of content
The properties.featureTitle and properties.featureSubtitle properties specify the content of the tooltip shown when hovering the dataset's features in the map. In this case, it will be customer_id and an address.
Now, to the ref object. The type of the dataset is dwh, and the subtype is geometryPoint, because the table represents customers' addreses (points) that have a latitude and longitude. The table's primaryKey is the customer_id property. In the visualizations object, we say that we want to visualize it as a dotmap and a heatmap (the only two available for geometryPoint). The dataset is not categorizable by default, and none of its properties are filterable, as they will not appear in filters (more about filters later). It's data are also not allowed to be searched by full text search - fullTextIndex property.
The zoom object at the end can be used to modify the zoom levels for the dotmap visualization. This can be handy when there's a lot of dots, which could be a performance problem.
The dwh ref.properties list must correspond with the columns in the CSV file, including order and data types.
Checking status of project k5t8mf2a80tay2ng (First project) against dump ...
No files have been modified locally
No files have been modified on the server
2 new files have been detected:
Adding all new objects to the server...
Added object customers.json
1 new object has been successfully uploaded to project k5t8mf2a80tay2ng
No metadata objects were changed - nothing to push
Asynchronous data upload started...
CSV file customers.csv successfully loaded into dataset customers (4822 rows loaded)
DWH data of project k5t8mf2a80tay2ng successfully updated from dump
Validating DWH model/data integrity of project k5t8mf2a80tay2ng...
That's it! In the next chapter of this tutorial, we will define a metric and an indicator to finally see the data in the map.