@rekhly/charts-geospatial25 exported symbols — see also the package guide.
interface BubbleMarker| id | string |
| lon | number |
| lat | number |
| value | number |
interface BubbleMarkerOptions| minSize? | number | undefined |
| maxSize? | number | undefined |
| color? | string | undefined |
(options: MapChartOptions) => MapChartClears the entire shared geometry cache. Prefer {@link clearGeoCacheEntry} when disposing a single chart instance — this clears geometry every other chart sharing the cache is still using.
() => voidClears one cache entry, without disturbing geometry other chart instances still reference.
(cacheKey: string) => voidBubble markers sized by `value`, the marker equivalent of `compileRegions`' color-by-value scaling — callers pass a value, not a pre-computed pixel size.
(markers: readonly BubbleMarker[], view?: MapView, options?: BubbleMarkerOptions) => PrimitiveNode[](markers: readonly { lon: number; lat: number; size?: number; }[], view?: MapView) => PrimitiveNode[](paths: readonly { lon: number; lat: number; }[][], view?: MapView) => PrimitiveNode[](features: readonly GeoFeature[], values: Readonly<Record<string, number>>, low: Rgba, high: Rgba, view?: MapView) => PrimitiveNode[]MapViewEncodes features into the Rekhly binary geometry format.
(features: readonly GeoFeature[], dtype?: GeoBinaryDtype) => ArrayBufferRekhly binary geometry format (little-endian) — the "Custom binary geometry" provider from the Phase 8 design note. Mirrors `@rekhly/streaming`'s frame protocol: a fixed magic/version header, then a sequential feature list (an id string, a ring count, and ring vertex runs in the declared coordinate dtype). Decodes straight into the same `GeoFeature[]` shape `parseGeoJson` produces, so `compileRegions`/`compileMarkers`/`hitTest` need no changes. ``` 0 magic u32 "FGEO" (0x4645474f) 4 version u16 6 dtype u8 0 = f32, 1 = f64 7 pad u8 8 featureCount u32 12 reserved u32 16 features[featureCount]: idLength u16 id utf8 bytes[idLength] ringCount u32 rings[ringCount]: vertexCount u32 vertices (f32|f64)[vertexCount * 2] -- x0,y0,x1,y1,... ```
1type GeoBinaryDtype = GeoBinaryDtypeinterface GeoFeature| id | string |
| rings | readonly (readonly [number, number][])[] |
interface GeoJsonFeatureCollection| type | "FeatureCollection" |
| features | readonly GeoJsonPolygon[] |
(features: readonly GeoFeature[], lon: number, lat: number) => string | undefinedMap chart. Renders user-supplied GeoJSON / TopoJSON through the Rekhly engine. No third-party map SDK.
class MapChartinterface MapChartOptions| container | string | HTMLElement |
| canvas? | HTMLCanvasElement | undefined |
| theme? | Theme | BuiltinThemeName | undefined |
| renderer? | RendererPrefs | undefined |
| width? | number | undefined |
| height? | number | undefined |
Color-scale legend for a choropleth map: a gradient swatch plus min/max labels, drawn into the chart's DOM overlay. The map-chart equivalent of `OverlayCursor` in `@rekhly/charts-2d` — a small, disposable overlay widget, not a second rendering path.
class MapLegendWeb Mercator-ish lon/lat → normalized [0,1] then clip space.
interface MapView| scale | number |
| ox | number |
| oy | number |
Decodes the Rekhly binary geometry format into the same `GeoFeature[]` shape `parseGeoJson` produces.
(buffer: ArrayBuffer) => GeoFeature[]Parse a FeatureCollection of polygons. Results are cached by `cacheKey`.
(collection: GeoJsonFeatureCollection, cacheKey?: string) => GeoFeature[](lon: number, lat: number, view?: MapView) => { x: number; y: number; }Minimal TopoJSON → GeoJSON decoder (arcs + transform).
(topo: { readonly type: "Topology"; readonly transform?: { readonly scale: number[]; readonly translate: number[]; }; readonly arcs: number[][][]; readonly objects: Record<string, { type: string; geometries?: unknown[]; geometries_?: unknown; }>; }) => GeoJsonFeatureCollection(x: number, y: number, view?: MapView) => { lon: number; lat: number; }Got any questions? I'm happy to help with products, licensing, and examples.