The Data Inspector addresses developers, data scientists, and business analysts. Inspecting data on the HERE Platform – structurally as well as visually – can help you understand the data’s value for your use case or can help you debug the data that you produce on the Platform yourself.
The Data Inspector essentially consists of these two interfaces:
One that lets you programmatically create a visualization for Protobuf-encoded data by defining which elements of your data shall be presented and in what way. This interface is called a GeoJSON renderer plugin and it transforms your Protobuf-encoded data to GeoJSON.
The point-and-click UI that lets you interact with the data. It offers visual clues on where your data is located and how it is distributed geographically. It lets you view the data visually on a map using a GeoJSON plugin to transform the data and a GeoJSON rendering engine to visualize it. In case the data is already formatted as GeoJSON, it renders directly.
The Platform lets you attach a GeoJSON plugin to your schema. So, when you share your data with someone, the schema and the plugin are implicitly shared with it. This way, they can benefit from the visualization that you've created. In fact, a number of Platform data sets already have a schema and plugin attached so that you can enjoy automatic decoding and visualization for these data layers out of the box.
The Data Inspector allows visualizing the following types of data:
Protobuf-encoded data visualized with custom GeoJSON renderer plugins:
GeoJSON data visualized with the dedicated GeoJSON rendering engine:
Several layers from the HERE Map Content catalog (Cartography, Road Topology & Geometry, and Building Footptrints) visualized out of the box with the dedicated rendering engine that requires no specific renderer plugin:
The Data Inspector is available as a component integrated in the Platform Portal as well as in form of a library. For most cases, the Portal application is all you need. You can even develop a rendering plugin there. The Library lets you create a customized Data Inspector tool for special cases that you might have. For more information, see the use cases in the chapter below.
The Data Inspector Library allows you to do the following:
- Discover the coverage of data that is stored in OLP.
- Inspect the data that is available in OLP.
- Inspect the data while developing your OLP pipeline applications.
- Create your own application with the contents of your catalogs.
Whenever searching for certain types of data stored in OLP, one of the first things you may be interested in is where that data is available geographically.
For HERETiled layers, the Data Inspector provides a coverage map (as a green overlay on top of the basemap) that shows the geographical distribution of layer data on a global or local sale, depending on a zoom level.
But if the data is generically partitioned, then there is no way of knowing where the data would be at until you load the data itself – and that can be a very heavy operation. In that case, OLP still offers you the possibility to state in which countries your data is available through a layer description.
The information on the layer's page in the OLP Portal can help you out, of course, but to know more about the data, use the Data Inspector. This tool brings lots of data inspection capabilities, including those listed below:
- Learn in more detail where exactly tiles with data can be expected.
- View where the larger tiles of data (in KB) are available.
- Visualize the layer content's geometry of one or more tiles on the basemap to see if the geometry is correct.
- Study the data structure and attribute values in a specific tile, so that you can find out if it fits your purpose without having to code a single line.
- Inspect non-tiled data that cannot be visualized from within the Data Inspector as a list of partitions.
For more information on inspection capabilities, see How To chapters.
As an OLP pipeline developer, you take OLP data as your pipeline input. Then, to ensure that every processing stage fits your overall purpose, you can inspect your pipeline output with the Data Inspector.
The Data Inspector Library allows you to:
View visualized partition data directly in the Portal Data Inspector. For this, though, your schema with renderer plugins must be deployed to the Platform and bundled with a layer. Equally, your pipeline application must be deployed to the Platform, configured, and launched in the OLP Pipeline Service.
View a local (off-line) partition exactly as it will be visualized in the Portal. You can also view a local schema (and renderer plugin) exactly as it would be visualized in the Portal. This is the convenient way since all the pipeline development and testing is happening on your local staging environment. Once completed, you deploy a perfectly finetuned pipeline application to the Platform.
For more information, see Pipelines Developer Guide.
OLP is extremely flexible in how it allows you to store and structure your data. Every layer can be tiled or non-tiled, and every layer can have its own data format. However, you are recommended to store your data in HERE tiles in GeoJSON or in Protobuf with a well-defined Protobuf schema.
HERETiled GeoJSON layers can be instantly visualized by the Data Inspector.
For more information on renderer plugins, see Create Renderer Plugins.
For more information, see Library Modules Overview.
To build and run applications based on the OLP Data Inspector Library, you need the following:
- Have a valid OLP user account.
- Obtain repository and platform credentials.
- Install Node.js at least version 10.14.0. However, it is recommended to use Node.js version 12.x for the best Data Inspector Library experience.
- Configure the npm package manager, shipped along with Node.js, that is needed to run the commands in this guide.
- Be familiar with the basic OLP concepts.
- Install a WebGL-enabled browser to be able to see visualizations. The latest versions of Google Chrome, Mozilla Firefox, and Apple Safari all support this technology. To test your browser, go to https://get.webgl.org/.
To get started with the Data Inspector Library, follow these steps:
For the terms and conditions covering this documentation, see the HERE Documentation License.