Contribute in GitHub:
Open doc issue|Edit online
Context Mapping
The Context Mapping component of IBM® IoT Connected Vehicle Insights provides powerful geospatial functions and map-based analytics to add contextual insights into the vehicle data that is retrieved by the Vehicle Data Hub (VDH).
The Context Mapping service provides fast access to static road network data and dynamic event data. Context Mapping also provides geospatial tools for road networks, which you can use to integrate geospatial capabilities with your applications.
A summary of the main features that are provided by the Context Mapping service is outlined in the following table:
| Feature | Use to... |
|---|---|
| Highly accurate map matching | Match the raw GPS location coordinates from a vehicle device to the coordinates of the actual mapped road network. |
| Road geometry data retrieval | Retrieve the mapped road network to draw road shapes on a map. |
| Dynamic shortest path search | Search for the shortest route that incorporates real-time events, such as traffic delays and incidents. |
| Real-time traffic event manipulation | Add real-time map-matched events, such as traffic conditions, to improve route planning results. |
Map regions
The following map regions are supported:
| Region | Map ID |
|---|---|
| Europe | map_id=1 |
| Africa | map_id=2 |
| Asia | map_id=3 |
| Australia Oceania | map_id=4 |
| North America | map_id=5 |
| Central America | map_id=6 |
| South America | map_id=7 |
Configuring Context Mapping
Use the internal and external URLs that are provided in your welcome pack to connect to the Context Mapping component of your service instance.
Configure the map sources
The Dynamic Map Manager (DMM) is a component of the Context Mapping service that manages the map sources. You can configure and manage multiple versions of map data in your IBM IoT Connected Vehicle Insights service. When you upload the map data source files, they must be converted to the DMM format that is required by the service.
The map vendor, version hierarchy, and status information are maintained and managed from the Asset Management component in IBM IoT Connected Vehicle Insights.
By default, sample maps are provided in the DMM map directory (/data/map/
Procedure summary:
- Retrieve the source map file from the map vendor, for example, OpenStreetMap.
- Convert the map file to binary format by using the map tool that is provided.
- In the Asset Management component, create a new map record for each map and provide the required information. You can log on to the Asset Management component by connecting to the IBM® Maximo® Asset Management administration interface. Your Maximo Asset Management system URLs and credentials are in your customer welcome pack.
- By using the System Manager, upload the map into IBM IoT Connected Vehicle Insights.
Configure the Context Mapping analytics
You can configure and customize the context mapping analytics and add traffic events to the system.
Developing apps with map insights data
You can use the Context Mapping REST API to integrate the contextual geographic map insights into your automotive applications. For more information, see REST APIs for application development.
Starter apps and samples that demonstrate how you can feed the contextual mapping data and analytic insights from IBM IoT Connected Vehicle Insights into example apps are also available.
More information
To help you to configure and customize the Context Mapping service, detailed information and guidance can be provided by IBM Consulting. For more information, contact your local IBM Representative.