Skip to content

Add HydroBASINS North America Level 2 polygon data #30

@SAUMILDHANKAR

Description

@SAUMILDHANKAR

Issue created with ChatGPT models' help


Description

Add HydroBASINS North America Level 2 polygon data into the repository by converting the provided HydroBASINS GIS dataset into valid GeoJSON format.

HydroBASINS contains multiple hierarchical watershed levels (12 total levels), but this issue should only focus on Level 2 polygon data for North America to keep the contribution small and beginner-friendly.

The converted GeoJSON file should then be uploaded into the repository fixtures folder so the existing map setup can consume and render the dataset.


Goals

  • Obtain HydroBASINS North America Level 2 polygon dataset
  • Convert the source GIS data into valid GeoJSON
  • Upload converted GeoJSON into the repo fixtures folder
  • Verify the GeoJSON structure remains valid
  • Keep implementation lightweight and beginner-friendly

Implementation Instructions

Level 2 files: hybas_na_lev02_v1c
  • Ignore the remaining HydroBASINS levels for this issue

  • Convert to valid .geojson format by selecting all geospatial files in the dataset for Level 2:

    • dBase database file (.dbf)

    • Projection file (.prj)

    • Binary spatial index file (.sbn)

    • ESRI spatial index shapefile (.sbx)

    • Shapefile (.shp)

    • Shapefile XML (.shp.xml)

    • File Geodatabase (.gdb)

    • Compiled shapefile (.shx)

    • or other provided GIS formats

  • Contributors may use standard GIS conversion workflows/tools including:

  • Name the final GeoJSON file:

HydroBASINS Level 2 (North America).geojson
  • Upload the GeoJSON file into:
public/fixtures/

Repo path:

https://github.com/OpenSourceFellows/map_dashboard_hackathon/tree/main/public/fixtures
  • Verify the GeoJSON structure is valid
  • Verify the dataset renders correctly in the existing map setup
  • Keep the dataset limited to North America only

Optional lightweight cleanup improvements:

  • Remove unnecessary attributes/properties
  • Reduce file size if conversion output is extremely large
  • Preserve polygon geometry accuracy during conversion

Expected Functionalities

GeoJSON Conversion

  • HydroBASINS Level 2 polygon data converts successfully into valid GeoJSON
  • Polygon geometry and key properties remain intact after conversion

Repository Integration

  • GeoJSON file is uploaded into the fixtures folder
  • Existing map setup can load and render the dataset

Notes

  • HydroBASINS contains 12 hierarchical levels, but this issue only covers Level 2 polygons
  • Contributors may use any reasonable GIS conversion workflow/tool
  • Keep PR scope small and focused on dataset conversion/upload
  • No frontend UI work is required for this issue
  • Contributors do not need to process all HydroBASINS layers

Acceptance Criteria

  • HydroBASINS North America Level 2 polygon dataset converted to valid GeoJSON
  • GeoJSON file uploaded into public/fixtures/
  • File named HydroBASINS Level 2 (North America).geojson
  • GeoJSON structure is valid and readable
  • Dataset renders correctly in existing map setup
  • PR scope remains small and beginner-friendly

Resources

  1. HydroBASINS Product Page
  2. HydroBASINS Technical Documentation PDF

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions