/** * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ /* eslint-disable react/jsx-sort-default-props, react/sort-prop-types */ /* eslint-disable react/forbid-prop-types, react/require-default-props */ import { Component } from 'react'; import MapGL from 'react-map-gl'; import { WebMercatorViewport } from '@math.gl/web-mercator'; import ScatterPlotGlowOverlay from './ScatterPlotGlowOverlay'; import './MapBox.css'; const NOOP = () => {}; export const DEFAULT_MAX_ZOOM = 16; export const DEFAULT_POINT_RADIUS = 60; interface Viewport { longitude: number; latitude: number; zoom: number; isDragging?: boolean; } interface Clusterer { getClusters(bbox: number[], zoom: number): GeoJSONLocation[]; } interface GeoJSONLocation { geometry: { coordinates: [number, number]; }; properties: Record; } interface MapBoxProps { width?: number; height?: number; aggregatorName?: string; clusterer: Clusterer; // Required - used for getClusters() globalOpacity?: number; hasCustomMetric?: boolean; mapStyle?: string; mapboxApiKey: string; onViewportChange?: (viewport: Viewport) => void; pointRadius?: number; pointRadiusUnit?: string; renderWhileDragging?: boolean; rgb?: (string | number)[]; bounds?: [[number, number], [number, number]]; // May be undefined for empty datasets } interface MapBoxState { viewport: Viewport; } const defaultProps: Partial = { width: 400, height: 400, globalOpacity: 1, onViewportChange: NOOP, pointRadius: DEFAULT_POINT_RADIUS, pointRadiusUnit: 'Pixels', }; class MapBox extends Component { static defaultProps = defaultProps; constructor(props: MapBoxProps) { super(props); const { width = 400, height = 400, bounds } = this.props; // Get a viewport that fits the given bounds, which all marks to be clustered. // Derive lat, lon and zoom from this viewport. This is only done on initial // render as the bounds don't update as we pan/zoom in the current design. let latitude = 0; let longitude = 0; let zoom = 1; // Guard against empty datasets where bounds may be undefined if (bounds && bounds[0] && bounds[1]) { const mercator = new WebMercatorViewport({ width, height, }).fitBounds(bounds); ({ latitude, longitude, zoom } = mercator); } this.state = { viewport: { longitude, latitude, zoom, }, }; this.handleViewportChange = this.handleViewportChange.bind(this); } handleViewportChange(viewport: Viewport) { this.setState({ viewport }); const { onViewportChange } = this.props; onViewportChange!(viewport); } render() { const { width, height, aggregatorName, clusterer, globalOpacity, mapStyle, mapboxApiKey, pointRadius, pointRadiusUnit, renderWhileDragging, rgb, hasCustomMetric, bounds, } = this.props; const { viewport } = this.state; const isDragging = viewport.isDragging === undefined ? false : viewport.isDragging; // Compute the clusters based on the original bounds and current zoom level. Note when zoom/pan // to an area outside of the original bounds, no additional queries are made to the backend to // retrieve additional data. // add this variable to widen the visible area const offsetHorizontal = ((width ?? 400) * 0.5) / 100; const offsetVertical = ((height ?? 400) * 0.5) / 100; // Guard against empty datasets where bounds may be undefined const bbox = bounds && bounds[0] && bounds[1] ? [ bounds[0][0] - offsetHorizontal, bounds[0][1] - offsetVertical, bounds[1][0] + offsetHorizontal, bounds[1][1] + offsetVertical, ] : [-180, -90, 180, 90]; // Default to world bounds const clusters = clusterer.getClusters(bbox, Math.round(viewport.zoom)); return ( { const { coordinates } = location.geometry; return [coordinates[0], coordinates[1]]; }} /> ); } } export default MapBox;