pygeoapi快速学习

现在,您已经安装了pygeoapi,设置了配置并启动了服务器。

pygeoapi的默认配置包括两个简单的向量数据集,一个STAC集合和一个示例进程。请注意,这些资源是pygeoapi基线功能的直接示例,旨在让用户在尽可能少的障碍下启动和运行。

让我们检查一下。在web浏览器中,转到 http://localhost:5000

概述

所有pygeoapi url都有HTML和JSON表示。如果您是通过web浏览器工作的,HTML总是作为默认值返回,而如果您是以编程方式工作,则总是返回JSON。

要显式地请求HTML或JSON,只需添加 f=htmlf=json 相应地指向任何URL。

每个网页都提供了浏览服务器数据的导航条。此外,UI的右上角总是有JSON和JSON-LD链接,如果需要,可以用JSON提供当前页面。

登录页

http://localhost:5000

登录页提供了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/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}?f=mvt

通用元数据

此页面提供自由格式的平铺元数据。

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)&parameter-name=SST&f=json

此页面针对给定的参数名称执行位置查询,并在CoverageJSON中提供响应。

参见

将数据发布到OGC API-环境数据检索 了解更多OGC API-EDR请求示例。

时空资产

http://localhost:5000/stac

此页面提供原始地理空间数据文件的Web可访问文件夹视图。用户可以导航并单击以浏览目录内容或检查文件。单击一个文件将尝试显示该文件的属性/元数据,以及带有文件空间范围示意图的交互式地图。

参见

将文件发布到时空资源目录 更多的STAC请求示例。

API文档

http://localhost:5000/openapi

http://localhost:5000/openapi?f=json

API文档链接提供了 Swagger API的页面,作为开发人员提供示例请求/响应/查询功能的工具。还提供了一个JSON表示。

一致性

http://localhost:5000/conformance

一致性页面提供了与pygeoapi服务器支持的ogcapi一致性类相对应的url列表。对于开发人员和客户机应用程序,这些信息通常对发现服务器支持的内容非常有用。