README
¶
go-wfs 
go-wfs is a Go server implementation of OGC WFS 3.0.
REQUIRES GO >= 1.8
server/ routes.go: maps urls to functions (from handlers.go) handlers.go: actual work done here server.go: simple interface to start the server.
wfs3/ collection_meta_data.go: generates content for metadata requests conformance.go: generates content for conformance requests FeatureCollectionJSONSchema: provides a string variable populated with the schema for a geojson FeatureCollection features.go: generates content for feature data requests FeatureSchema.go: provides a string variable populated with the schema for a geojson Feature openapi3.go: encapsulates generation of json OpenAPI3 document for WFS service. root.go: generates content for a root path ("/") request validation.go: helper functions for validating encoded responses wfs3_types.go: go structs to mirror the types & their schemas specified in the wfs3 spec.
data_provider/
provider.go: wraps github.com/go-spatial/tegola/provider.Tiler to provide convenience methods & additional behavior
main.go: Executable entry-point.
Defaults to run on localhost:9000. Visit http://localhost:9000/api for OpenAPI definition of
service. Take a look at server/routes.go for a concise list of supported URLs.
Build Instructions
# create directory for local env
mkdir /path/to/golang-env
export GOPATH=/path/to/golang-env
# install go-wfs
go get github.com/go-spatial/go-wfs
# install dependencies
go get github.com/golang/dep/...
dep ensure
go build -i -o go-wfs github.com/go-spatial/go-wfs
For AWS Lambda deployments, add -tags awslambda when building
Running
# start server on http://localhost:9000/
go run main.go # or go build main.go
Developers
dep ensure will install dependencies at the current HEAD when you run it (equivalent to go get ...)
Run dep ensure -update periodically to stay current with these depenencies. (equivalent to subsequent go get ...)
Please don't add Gopkg.lock to the repo.
Requests Overview
Features are identified by a collection name and feature primary key pair.
- API landing: http://localhost:9000/
- API definition: http://localhost:9000/api
- Conformance: http://localhost:9000/conformance
- Collections: http://localhost:9000/collections
- Feature collection metadata: http://localhost:9000/collections/{name}
- Features from a single feature collection: http://localhost:9000/collections/{name}/items
- Single feature from a feature collection: http://localhost:9000/collections/{name}/items/{feature}
Bugs and Issues
All bugs, enhancements and issues are managed on GitHub.
Documentation
Source Files
Directories