Time Slider Causes App Failure on GeoParquet Load, Including Official NAIP Example

[Jack-Hayes]

Hi there,

First off, stac-map is a fantastic tool -- thank you! I'm currently working on a project to generate STAC GeoParquet files from commercial SAR catalogs and am hoping to use stac-map as my primary viewer (project context here: Jack-Hayes/commerical-sar-stac#1)

While debugging my current parquet structure, I ran into an issue where the time-range slider fails to initialize. I couldn't figure this out despite looking at the filter.tsx source code, so I tried loading the official "Colorado NAIP" example from your documentation and discovered it fails with the same error.

Steps to Reproduce

1. Navigate to the live stac-map demo: https://developmentseed.org/stac-map/
2. Select the "Colorado NAIP" example from the "Examples" widget:

https://developmentseed.org/stac-map/?href=https://raw.githubusercontent.com/developmentseed/labs-375-stac-geoparquet-backend/refs/heads/main/data/naip.parquet

The application shows a blank white screen. The browser's developer console displays the following unhandled application error:

[zag-js/slider] The configured `min`, `max`, `step` or `minStepsBetweenThumbs` values are invalid

Thoughts

My current belief is that there may be a data type mismatch when the min and max date values are passed from the data-loading utility to the slider UI component.

Specifically, it looks like this line in filter.tsx requires the datetime value to be a string:

https://github.com/developmentseed/stac-map/blob/70d4b016f0d5a7b9d4a126b423689f90dd7d3996/src/components/sections/filter.tsx#L64-L66

let start =
  value.start_datetime && typeof value.start_datetime === "string"
    ? new Date(value.start_datetime as string)
    : null;

It seems plausible that the min/max values aggregated by DuckDB from the Parquet file's datetime column are arriving in the frontend as objects that are not strings.

Hope this helps track down the issue. Thanks for the great work on this project!

[gadomski]

🤔 I can't reproduce:

Screen.Recording.2025-10-21.at.5.33.14.AM.mov

However, I did see this happen on someone else's screen the other day, so I'm going to keep this open. Any additional information that would help me reproduce would be appreciated, if possible.

[Jack-Hayes]

Thanks for the help! Below is a recording of the [zag-js/slider] The configured `min`, `max`, `step` or `minStepsBetweenThumbs` values are invalid error I get from selecting the Colorado NAIP example (browser endpoint https://developmentseed.org/stac-map/)

stac-map-parquet-err.mp4

I'm also linking the local geoparquet I was using for testing at:

https://github.com/Jack-Hayes/commerical-sar-stac/raw/refs/heads/stac-map-debug/iceye-stacmap-debug.parquet

Click to see ogrinfo outputs for this parquet

Note that I also face the same error with identically structured parquet files with Polygon geometries as opposed to MultiPolygon (though the geoms shouldn't be the issue). You can also drag and drop this parquet into QGIS and read with geopandas just fine.

$ gdalinfo --version
GDAL 3.11.3 "Eganville", released 2025/07/12

$ ogrinfo -al -so iceye.parquet
INFO: Open of `iceye.parquet'
      using driver `Parquet' successful.

Layer name: iceye
Geometry: Multi Polygon
Feature Count: 16
Extent: (-95.395387, -29.904990) - (122.204000, 51.978076)
Layer SRS WKT:
GEOGCRS["WGS 84",
    ENSEMBLE["World Geodetic System 1984 ensemble",
        MEMBER["World Geodetic System 1984 (Transit)"],
        MEMBER["World Geodetic System 1984 (G730)"],
        MEMBER["World Geodetic System 1984 (G873)"],
        MEMBER["World Geodetic System 1984 (G1150)"],
        MEMBER["World Geodetic System 1984 (G1674)"],
        MEMBER["World Geodetic System 1984 (G1762)"],
        MEMBER["World Geodetic System 1984 (G2139)"],
        MEMBER["World Geodetic System 1984 (G2296)"],
        ELLIPSOID["WGS 84",6378137,298.257223563,
            LENGTHUNIT["metre",1]],
        ENSEMBLEACCURACY[2.0]],
    PRIMEM["Greenwich",0,
        ANGLEUNIT["degree",0.0174532925199433]],
    CS[ellipsoidal,2],
        AXIS["geodetic latitude (Lat)",north,
            ORDER[1],
            ANGLEUNIT["degree",0.0174532925199433]],
        AXIS["geodetic longitude (Lon)",east,
            ORDER[2],
            ANGLEUNIT["degree",0.0174532925199433]],
    USAGE[
        SCOPE["Horizontal component of 3D system."],
        AREA["World."],
        BBOX[-90,-180,90,180]],
    ID["EPSG",4326]]
Data axis to CRS axis mapping: 2,1
Geometry Column = geometry
id: String (0.0)
datetime: String (0.0)
stac_item: String (0.0)
provider: String (0.0)

Prettyprint example of stac_item field:

{'stac_version': '1.0.0',
 'stac_extensions': ['https://stac-extensions.github.io/sar/v1.0.0/schema.json',
  'https://stac-extensions.github.io/sat/v1.0.0/schema.json',
  'https://stac-extensions.github.io/view/v1.0.0/schema.json',
  'https://stac-extensions.github.io/processing/v1.1.0/schema.json',
  'https://stac-extensions.github.io/projection/v2.0.0/schema.json',
  'https://stac-extensions.github.io/raster/v1.0.0/schema.json'],
 'id': 'ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF',
 'type': 'Feature',
 'geometry': {'type': 'Polygon',
  'coordinates': [[[-16.93278808349646, 32.68335730083363],
    [-16.942789935381718, 32.63907596317376],
    [-16.89045807066672, 32.63060645683977],
    [-16.880431444848977, 32.67488369199132],
    [-16.93278808349646, 32.68335730083363]]]},
 'bbox': [-16.942789935381718,
  32.63060645683977,
  -16.880431444848977,
  32.68335730083363],
 'properties': {'datetime': '2025-09-30T11:58:54.324Z',
  'created': '2025-09-30T18:53:06Z',
  'start_datetime': '2025-09-30T11:58:43.947Z',
  'end_datetime': '2025-09-30T11:59:04.702Z',
  'platform': 'ICEYE-X35',
  'constellation': 'ICEYE',
  'sar:instrument_mode': 'spotlight',
  'sar:frequency_band': 'X',
  'sar:center_frequency': 9600000000,
  'sar:polarizations': ['VV'],
  'sar:observation_direction': 'right',
  'sat:orbit_state': 'descending',
  'view:off_nadir': 21.23,
  'view:azimuth': 100.83,
  'view:incidence_angle': 22.88,
  'processing:software': {'forge': 'local', 'processor': 'ICEYE_I_1.1.1'},
  'proj:code': 'EPSG:4326',
  'proj:shape': [20000, 20000],
  'proj:centroid': {'lat': 32.65698770370005, 'lon': -16.911648585322013},
  'proj:transform': [-16.880431444848977,
   -5.013312908872081e-07,
   -2.6178319323742373e-06,
   32.67488369199132,
   -2.2138617575773624e-06,
   4.236804421154261e-07],
  'raster:bands': [{'data_type': 'ui16', 'bits_per_sample': 16}]},
 'links': [{'rel': 'collection',
   'href': '../../../collections/iceye-sar.json',
   'type': 'application/json',
   'title': 'ICEYE SAR Collection'}],
 'assets': {'grd-json': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_GRD.json',
   'type': 'application/geo+json',
   'roles': ['metadata'],
   'title': 'GRD metadata'},
  'grd-cog': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_GRD.tif',
   'type': 'image/vnd.stac.geotiff; cloud-optimized=true',
   'roles': ['data'],
   'title': 'GRD product'},
  'qlk-json': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_QLK.json',
   'type': 'application/geo+json',
   'roles': ['metadata'],
   'title': 'Quicklook Metadata'},
  'qlk-png': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_QLK.png',
   'type': 'image/png',
   'roles': ['overview'],
   'title': 'Quicklook PNG'},
  'qlk-cog': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_QLK.tif',
   'type': 'image/vnd.stac.geotiff; cloud-optimized=true',
   'roles': ['overview'],
   'title': 'Quicklook COG'},
  'slc-json': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_SLC.json',
   'type': 'application/geo+json',
   'roles': ['metadata'],
   'title': 'SLC metadata'},
  'slc-cog': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_SLC.tif',
   'type': 'image/vnd.stac.geotiff; cloud-optimized=true',
   'roles': ['data'],
   'title': 'SLC product'},
  'thm-png': {'href': 'https://iceye-open-data-catalog.s3.amazonaws.com/data/dwell-precise/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF/ICEYE_ETGCZ1_20250930T115843Z_6360071_X35_SLEDF_THM.png',
   'type': 'image/png',
   'roles': ['overview'],
   'title': 'Thumbnail PNG'}}}

Which gives me the same error as the video when I upload it as a local parquet to stac-map

[gadomski]

@Jack-Hayes since I can't reproduce, I'm having to debug-by-deploy. Can you clear your cache and retry? I added an explicit load of the icu extension (which handles time zone stuff), as a shot in the dark.

[Jack-Hayes]

Hi @gadomski , I'm getting the same error after clearing my cache on Chrome but I'm able to load in the NAIP example and my local parquets as expected in different browsers (Microsoft Edge and Firefox), which I didn't test initially 😅

So seems to be a different issue than expected. My chrome configuration and installation is standard so not sure what else I can provide -- thanks again for all the help