Geovisualization Developer's Guide

Developer Guide

The Geovisualization workflow consists of a series of steps to suit the way you work.

1. Prepare your data

The source data you use with Geovisualization can be in CSV format, contain geometries or coordinates data and needs to follow some formatting guidelines, read our data formatting guidelines for more details.

2. Connect your data

You have multiple options for using your data with Geovisualization.

To get started with simpler visualizations that use smaller data sources, learn the toolkit and explore its possibilities, use the data manager graphical interface to upload data to your account. You can also provide data from a local or remote file using the RawDataProvider method of the Geovisualization JavaScript API, which also accepts files in GeoJSON format.

You can also store data in our backend using the Geovisualization REST API to upload data to your account by first creating an empty dataset, and then uploading data with a Recipe.

To learn more about the toolkit features and create more complex visualizations that use larger data sources, deciding which option suits will depend on your application structure. If you have a REST API with an endpoint that provides the data, you can use the Provider method that loads data into memory or the RawDataProvider method that parses a file, but you need to wait for the file to transfer. Both of these methods also accept files in GeoJSON format.

You can also store data in our backend using the new ingestion process for the Geovisualization REST API that uses 'recipes' to predefine how your data source matches to a dataset. This process requires extra steps, but is more stable for large, complex data sources.

3. Query your data

While not necessary, with queries you can filter, aggregate and transform data before creating a visualization. Queries are JSON objects run within your app by calling its unique ID. You can define "dynamic parameters", which allow you to modify the parameters of the query using URL parameters. For more details, read querying your data.

4. Create visualization

Finally, you use the Geovisualization JavaScript API to consume your data and create a visualization. For more details, read setting up your app, creating visualizations, and our Code examples for inspiration.

Note: You can also use the Geovisualization CLI tool to manage your datasets and queries and keep configuration files in version control.