Class GeoJSONReader

java.lang.Object
org.episteme.core.io.AbstractResourceReader<List<Region>>
org.episteme.social.geography.loaders.GeoJSONReader
All Implemented Interfaces:
ResourceIO<List<Region>>, ResourceReader<List<Region>>
public class GeoJSONReader extends AbstractResourceReader<List<Region>>
Loads geographic data from GeoJSON format. Supports loading regions/features with coordinates (including altitude) and properties.
Since:
1.0
Author:
Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

  • Constructor Details

    • GeoJSONReader

      public GeoJSONReader()

  • Method Details

    • getCategory

      public String getCategory()
      Description copied from interface: ResourceIO
      Returns the category for grouping. MUST be implemented with I18N support.
      Returns:
      the category name

    • getDescription

      public String getDescription()
      Description copied from interface: ResourceIO
      Returns a short description of this resource handler. MUST be implemented with I18N support.
      Returns:
      the description

    • getLongDescription

      public String getLongDescription()
      Description copied from interface: ResourceIO
      Returns a long description of this resource handler. MUST be implemented with I18N support.
      Returns:
      the long description

    • getResourcePath

      public String getResourcePath()
      Description copied from interface: ResourceIO
      Returns the base path where this resource is located.

    • getResourceType

      public Class<List<Region>> getResourceType()
      Description copied from interface: ResourceIO
      Returns the type of resource.

    • getSupportedVersions

      public String[] getSupportedVersions()
      Description copied from interface: ResourceIO
      Returns the supported versions of the format this reader/writer handles.

      Each implementation MUST override this method to declare which versions of the underlying format are supported. The returned array should contain version strings in the format's standard notation (e.g., "3.0", "2.1", "Level 3 Version 2").

      Examples:

      • MathML: {"3.0", "2.0"}
      • SBML: {"Level 3 Version 2", "Level 3 Version 1", "Level 2 Version 5"}
      • PhyloXML: {"1.10", "1.00"}

      Returns:
      array of supported version strings, never null (empty array if version-agnostic)

    • loadFromSource

      protected List<Region> loadFromSource(String id)
      Specified by:
      loadFromSource in class AbstractResourceReader<List<Region>>

    • getMiniCatalog

      protected MiniCatalog<List<Region>> getMiniCatalog()
      Overrides:
      getMiniCatalog in class AbstractResourceReader<List<Region>>

    • loadRegions

      public List<Region> loadRegions(InputStream is) throws IOException
      Loads regions from a GeoJSON FeatureCollection.
      Parameters:
      is - Input stream containing GeoJSON data
      Returns:
      List of Region objects
      Throws:
      IOException - on parse error

    • loadCoordinates

      public List<GeodeticCoordinate> loadCoordinates(InputStream is) throws IOException
      Loads raw coordinate pairs from a GeoJSON geometry.
      Parameters:
      is - Input stream containing GeoJSON data
      Returns:
      List of GeodeticCoordinate objects
      Throws:
      IOException - on parse error

    • getName

      public String getName()
      Description copied from interface: ResourceIO
      Returns the display name of this resource handler. MUST be implemented with I18N support.
      Returns:
      the display name