pygeoapi快速学习
现在,您已经安装了pygeoapi,设置了配置并启动了服务器。
pygeoapi的默认配置包括两个简单的向量数据集,一个STAC集合和一个示例进程。请注意,这些资源是pygeoapi基线功能的直接示例,旨在让用户在尽可能少的障碍下启动和运行。
让我们检查一下。在web浏览器中,转到 http://localhost:5000
概述
所有pygeoapi url都有HTML和JSON表示。如果您是通过web浏览器工作的,HTML总是作为默认值返回,而如果您是以编程方式工作,则总是返回JSON。
要显式地请求HTML或JSON,只需添加 f=html
或 f=json
相应地指向任何URL。
每个网页都提供了浏览服务器数据的导航条。此外,UI的右上角总是有JSON和JSON-LD链接,如果需要,可以用JSON提供当前页面。
登录页
登录页提供了pygeoapi服务器的高级概述(联系信息、许可证),以及浏览数据、进程和地理空间文件的特定部分。
收藏
http://localhost:5000/collections
collections页面显示pygeoapi服务器上可用的所有数据集及其标题和摘要。让我们深入研究给定的数据集。
收集信息
http://localhost:5000/collections/obs
让我们深入研究给定的数据集。在这里我们可以看到 obs
数据集与相关链接一起描述(其他相关HTML页面、数据集下载等)。
“视图”部分提供了开始浏览数据的默认设置。
“Queryables”部分提供指向数据集属性的链接。
矢量数据
集合查询
http://localhost:5000/collections/obs/queryables
Queryables终结点提供集合的可查询属性和关联的数据类型。
收集项目
http://localhost:5000/collections/obs/items
此页面显示数据的地图和表格视图。功能可以在交互式地图上单击,允许用户钻取有关该功能的更多信息。该表还允许通过单击给定表行中的链接钻取功能。
让我们检查一下 Toronto, Ontario, Canada .
收款项目
http://localhost:5000/collections/obs/items/297
此页面提供了该功能及其完整属性集的概述,以及交互式地图。
参见
将矢量数据发布到OGC API-功能 更多的OGC API功能请求示例。
交易记录
将项添加到集合(使用 curl ):
curl -XPOST -H "Content-Type: application/geo+json" http://localhost:5000/collections/canada-metadata/items -d @new-item.json
更新集合中的项(使用 curl ):
curl -XPUT -H "Content-Type: application/geo+json" http://localhost:5000/collections/canada-metadata/items/item1 -d @updated-feature.json
从集合中删除项目:
curl -XDELETE http://localhost:5000/collections/canada-metadata/items/item1
栅格数据
集合覆盖域集
此页面提供有关集合覆盖率空间属性和轴信息的信息。
http://localhost:5000/collections/gdps-temperature/coverage/domainset
集合覆盖范围范围类型
此页提供有关集合覆盖范围范围类型(波段)信息的信息。
http://localhost:5000/collections/gdps-temperature/coverage/rangetype
收集覆盖率数据
这个页面以CoverageJSON格式提供了一个覆盖范围。
http://localhost:5000/collections/gdps-temperature/coverage
参见
将栅格数据发布到OGC API-覆盖范围 对于更多的OGC API-Coverage请求示例。
地图
数据集可以作为动态地图提供:
http://localhost:5000/collections/mapserver_world_map/map
参见
将地图发布到OGC API-地图 获取更多OGC API-Maps请求示例。
瓦片
给定的集合或任何数据类型还可以作为分片(地图分片、矢量分片等)使用。下一页概述了集合的tiles功能(tile矩阵集、URI模板等)
http://localhost:5000/collections/lakes/tiles
URI跟URI模板
在上面提到的页面中,我们可以找到URI模板:
通用元数据
此页面提供自由格式的平铺元数据。
http://localhost:5000/collections/lakes/tiles/WorldCRS84Quad/metadata
元数据记录
http://localhost:5000/collections/metadata-records/items?q=crops&bbox=-142,42,-52,84
此页面提供元数据目录搜索功能
参见
将元数据发布到OGC API-记录 了解更多OGC API-Records请求示例。
交易记录
请参阅 交易记录 一节中提供了示例。
过程
“进程”页面提供集成到服务器上的进程的列表,以及名称和说明。
待处理
一旦OAProc HTML被更好地清除,就可以用更多的信息进行扩展。
参见
通过OGC API发布流程-流程 更多OGC API-进程请求示例。
环境数据检索
http://localhost:5000/collections/edr-test
此页除提供通用集合说明外,还提供集合是否具有EDR功能时的EDR查询的特定链接关系,以及要选择的受支持的参数名称。
http://localhost:5000/collections/edr-test/position?coords=POINT(111 13)¶meter-name=SST&f=json
此页面针对给定的参数名称执行位置查询,并在CoverageJSON中提供响应。
参见
将数据发布到OGC API-环境数据检索 了解更多OGC API-EDR请求示例。
时空资产
此页面提供原始地理空间数据文件的Web可访问文件夹视图。用户可以导航并单击以浏览目录内容或检查文件。单击一个文件将尝试显示该文件的属性/元数据,以及带有文件空间范围示意图的交互式地图。
参见
将文件发布到时空资源目录 更多的STAC请求示例。
API文档
http://localhost:5000/openapi?f=json
API文档链接提供了 Swagger API的页面,作为开发人员提供示例请求/响应/查询功能的工具。还提供了一个JSON表示。
参见
一致性
http://localhost:5000/conformance
一致性页面提供了与pygeoapi服务器支持的ogcapi一致性类相对应的url列表。对于开发人员和客户机应用程序,这些信息通常对发现服务器支持的内容非常有用。