Map and globe reports provide interactive geospatial visualizations, supporting features such as globe view, night style, and hex binned layers.
Features#
Hex Binned Layers#
Hex binned layers aggregate point data into hexagonal bins for spatial summarization. The system generates a hex grid based on plot resolution, maps data points to grid cells, and summarizes values within each bin using a reducer function. Bin size is scaled for visual representation. Category-based hex binning is supported, allowing each category to have its own color and scaling. The core logic is implemented in the PlotHexBinsSVG and PlotHexBinSVG React components, which render bins as SVG polygons, and in selectors within plotHexBins.js that handle grid generation, aggregation, and scaling. For implementation details, see PlotHexBinsSVG.jsx, PlotHexBinSVG.jsx, and plotHexBins.js.
Example usage in a React component:
<PlotHexBinsSVG {...props} />
This component connects to the Redux store to retrieve aggregated data and renders a group of hex bins, each colored and sized according to the summarized data.
Globe View and Night Style#
Globe view and night style are supported, but implementation details, configuration options, and usage instructions are not available in the current documentation or code references. There is no information on which components, props, or API parameters enable these features, nor on how users can switch between map and globe views or day and night styles. No relevant documentation, pull requests, or support threads were found describing these features or their limitations.
Map Visualization#
Map reports display sample locations as points using coordinate fields. The map visualization is built on the react-leaflet library, and the ReportMap component is responsible for rendering the map. There is a feature request to support GeoJSON for displaying country borders and shading countries by count, but this is not currently implemented. User interaction in the map report should allow clicking a country to filter search results by country code, suggesting interactive filtering capabilities, but this is not documented as implemented.
Error Handling#
If there is no location data for a query, the map report may fail with an error such as undefined is not an object (evaluating 'g.top_left'). This indicates the need for error handling in map visualizations when location data is missing. See issue #398.
Limitations#
Region-based visualization (such as by country or continent) is not currently supported. All map and globe visualizations are point-based, using coordinate fields for data placement. There is no available information on configurable map themes, projections, or additional UI controls for globe view or night style. GeoJSON support for country borders and region shading is a requested feature but not yet implemented. For updates and further details, refer to the codebase and issue tracker.
