Search code examples
real-timeibm-cloudiot

How to supply event coordinates for real-time insights events?

When we look at the IoT Real-Time Insights service, we see that it provides a visual mapping capability. Unfortunately, the current documentation on using this appears to be very light. What should the JSON string structure of an incoming event contain to provide latitude and longitude data to the Map widget within a Real-Time Insights dashboard?

References:

Solution

  • During the creation of an IBM IoT Real-Time Insights environment, one must build the schema that describes the content of an incoming event. Within an event, we get to specify "data points" which are basically the fields within the incoming event. When we define a data point there is an attribute of it called "Sensor type" which is presumably used to provide a "hint" as to what kind of sensor produced that field in the event. Contained within this set are two pre-defined values called Longitude and Latitude and these provide the core of the answer. When we define the schema of an incoming event and we know that two arbitrarily named fields that we have chosen will contain the latitude and longitude information for a geospatial position, we need to define them as having the sensor types appropriate for their purpose. Here is an example screen shot illustrating a definition:

    enter image description here

    Notice specifically the value of "Sensor type".