Use Custom Geo Collections in Geo Charts

Administrators can upload custom geo collections to define their own geographic regions for use in geo chart visualizations. Custom collections allow you to map data to organization-specific boundaries such as sales territories, operational regions, or other custom polygon shapes.

Custom collections are uploaded at the organization level and can then be referenced in workspaces through the Logical Data Model (LDM).

Upload a Custom Geo Collection

Custom geo collections are uploaded by administrators in the organization settings.

  1. Go to Settings > Appearance & Behaviour > Geo collection.
  2. Upload a GeoJSON file containing the geographic shapes you want to use.
  3. After the file is validated, the collection is added to the organization’s geo collection library.

Uploaded collections can later be updated or deleted from the same interface.

GeoJSON Requirements

The uploaded file must meet the following requirements:

  • The file must contain valid GeoJSON syntax.
  • Each feature in the collection must include a unique id value.
  • Geographic coordinate precision must not exceed 5–6 decimal places.

The id values defined in the GeoJSON file are used to map dataset values to the corresponding geographic regions.

Use a Custom Collection in a Workspace

Once uploaded, the custom geo collection becomes available for use in workspaces.

To configure a dataset to use the collection:

  1. Open the workspace’s logical data model for editing.
  2. Add a Geo area secondary label to the attribute representing geographic regions.
  3. Configure the label to reference the uploaded geo collection.
  4. Ensure that the dataset values match the id values defined in the GeoJSON file.

After configuration, the dataset can be used in geo area charts that render the custom geographic shapes.

Example GeoJSON Structure

The following example shows a simplified GeoJSON structure for a custom collection:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "region_1",
      "properties": {
        "name": "North Territory"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[...]]]
      }
    }
  ]
}