pdok/wfs-3.0

GOAF

OGCAPI-FEATURES示例1的PDOK服务器实现

基于https://github.com/opengeospatial/ogcapi-features/blob/master/core/examples/openapi/ogcapi-features-1-example1.yaml%E8%A7%84%E8%8C%83%E7%A4%BA%E4%BE%8B1%E7%9A%84%E5%AE%9E%E7%8E%B0%EF%BC%8C%E9%87%87%E7%94%A8GeoJSON%E6%A0%BC%E5%BC%8F%EF%BC%8C%E4%BB%A5Geopackage%E4%BD%9C%E4%B8%BA%E6%95%B0%E6%8D%AE%E6%8F%90%E4%BE%9B%E5%99%A8%E3%80%82

代码灵感及部分实现借鉴自https://github.com/go-spatial/jivan和https://github.com/go-spatial/tegola。与jivan相比，主要差异在于数据提供器设置、大型Geopackage的查询性能优化以及SQL特性扫描的调整。

规范为初步版本，通过go generate可基于API规范生成路由、提供器接口、类型结构及便捷的参数提取，以便轻松保持与规范的同步更新。

• provider gpkg中的FeatureCollectionGeoJSON已被覆盖，使用github.com/go-spatial/geom/encoding/geojson等效实现解码二进制数据
• 基于规范：https://github.com/opengeospatial/ogcapi-features/blob/master/core/openapi/ogcapi-features-1.yaml

GOAF Geopackage示例：https://github.com/PDOK/wfs-3.0-gpkg

最小配置（适用于较小Geopackage，如<3GB）

docker
docker build -t pdok/goaf:latest .

docker run --rm -v `pwd`/example:/example -e PROVIDER='gpkg' -e PATH_GPKG='/example/bgt_wgs84.gpkg' -e ENDPOINT='http://localhost:8080' -p 8080:8080 pdok/goaf:latest

性能优化配置（适用于大型数据库，10M+记录/集合）

执行./run_postgis.sh

示例表结构：

sql
CREATE TABLE bgt_wfs3_v1.bak
(
    _id text COLLATE pg_catalog."default" NOT NULL,
    _version text COLLATE pg_catalog."default",
    properties jsonb,
    _geom geometry,
    _bbox geometry,
    _offset_id bigint NOT NULL DEFAULT nextval('bgt_wfs3_v1.bak__offset_id_seq'::regclass),
    _created timestamp without time zone,
    CONSTRAINT bak_pkey PRIMARY KEY (_id)
)
WITH (
    OIDS = FALSE
)

配置参数说明

go
bindHost := flag.String("s", envString("BIND_HOST", "0.0.0.0"), "服务器内部绑定地址，默认：0.0.0.0")
bindPort := flag.Int("p", envInt("BIND_PORT",8080), "服务器内部绑定端口，默认：8080")

serviceEndpoint := flag.String("endpoint", envString("ENDPOINT","http://localhost:8080"), "服务器端点（用于代理），默认：http://localhost:8080")
serviceSpecPath := flag.String("spec", envString("SERVICE_SPEC_PATH","spec/oaf.yml"), "Swagger OpenAPI规范路径")
defaultReturnLimit := flag.Int("limit", envInt("LIMIT",100), "默认返回限制，默认：100")
maxReturnLimit := flag.Int("limitmax", envInt("LIMIT_MAX",500), "最大返回限制，默认：1000")
providerName := flag.String("provider", envString("PROVIDER",""), "数据提供器类型：postgis或gpkg")
gpkgFilePath := flag.String("gpkg", envString("PATH_GPKG",""), "Geopackage文件路径")
crsMapFilePath := flag.String("crs", envString("PATH_CRS",""), "CRS文件路径")
configFilePath := flag.String("config", envString("PATH_CONFIG",""), "配置文件路径")
connectionStr := flag.String("connection", envString("CONNECTION", ""), "数据库连接字符串")

featureIdKey := flag.String("featureId", envString("FEATURE_ID",""), "默认要素标识键，若未指定则使用第一列定义（fid）") // 对gpkg提供器为可选参数

测试

go
go test ./... -covermode=atomic

贡献方式

提交Pull Request...

许可证

采用MIT许可证分发，详情请参见代码中的许可证文件。