gatsby-source-geo

Plugin for creating nodes from geospatial data sources. Each layer is exposed as a GeoLayer node, each geographic feature a GeoFeature - each of these nodes can be published, or referenced or whatever in graphql.

Uses the node-gdal module for accessing underlying geospatial data sources.

Install

You’ll need to install both this module and the gdal module.

npm i gatsby-source-geo gdal

How to use

// In your gatsby-config.js
module.exports = {
  plugins: [
    {
      resolve: `gatsby-source-geo`,
      options: {
        path: `${__dirname}/data/myfile.geojson`,
        // optional per layer filters
        layers: [
          {
            //name of the layer to filter
            name: `some_layer`,
            //partial WHERE query to filter by attribute
            attribute_filter: `some_field = 'somevalue'`,
          }
        ],
      },
    },
  ],
}

Options

path - it’s just the location of the geospatial data file (eg /tmp/myfile.geojson)

How to query

You can query GeoLayer nodes from geospatial data in the following way:

{
    allGeoLayer {
        edges {
            node {
                id
                name
                srs_wkt
            }
        }
    }
}

You can query GeoFeature nodes from geospatial data in the following way:

{
    allGeoFeature {
        edges {
            node {
                id
                    geometry {
                        type
                            coordinates
                    }
                featureFields {
                    my_first_field
                        my_second_field
                        etc
                }
            }
        }
    }
}

geometry will contain the features’ geometry in GeoJSON format, and the contents of featureFields will vary depending upon the schema definition of the data that you’re querying.