Skip to main content
Version: 0.0.41

Mapbox Integration

Mapbox is a mapping and geospatial data platform used by Apache Superset for map-based chart types. When users work with geographic data — sales by region, customer locations, logistics routes, or any dataset with spatial dimensions — map charts in Superset require a Mapbox API key to render.

Without a Mapbox API key, map chart types in Superset are unavailable. If your users analyze geographic data, enabling this integration is strongly recommended.

How It Works​

The Mapbox API key is registered with Superset during deployment. The Lakehousecat Operator passes the key to Superset as part of its configuration — you do not need to configure Superset directly.

Prerequisites​

  1. A Mapbox account — create one at mapbox.com
  2. A Mapbox public access token — created in your Mapbox account dashboard under Tokens

Mapbox offers a free tier that covers typical evaluation and low-volume production usage. Check mapbox.com/pricing for current limits.

Configuration​

Add the following to the superset section of your Lakehousecat Custom Resource:

superset:
  mapbox:
    enabled: true
    apiKey: "pk.eyJ1Ij..."   # Your Mapbox public access token

Full example in context​

apiVersion: lhc.lakehousecat.com/v1alpha2
kind: Lakehousecat
metadata:
  name: my-instance
spec:
  # ... other configuration ...

  superset:
    replicaCount: 1
    resources:
      requests:
        cpu: "250m"
        memory: "256Mi"
      limits:
        cpu: "1"
        memory: "6Gi"

    mapbox:
      enabled: true
      apiKey: "pk.eyJ1IjoiZXhhbXBsZSIsImEiOiJleGFtcGxlIn0.example"

Apply the updated CR:

kubectl apply -f lakehousecat-instance.yaml

The Operator reconciles the change and restarts Superset with the Mapbox key registered. No manual Superset configuration is required.

Disabling Mapbox​

To disable the integration, set enabled: false or remove the mapbox block from the superset section:

superset:
  mapbox:
    enabled: false

Verifying the Integration​

After applying the configuration:

  1. Open a session using a Custom Model connected to geographic data
  2. Ask a question involving location data (e.g., "Show sales by country on a map")
  3. The system should generate a World Map or Deck.gl map chart — if Mapbox is active, the map tiles will load correctly

If map tiles do not load, check:

  • That the API key is a valid public Mapbox token (starts with pk.)
  • That your cluster has outbound HTTPS access to api.mapbox.com
  • The Superset pod logs for Mapbox-related errors: kubectl logs -n <namespace> <superset-pod>