6. QUICKSTART#

The next sections guide you through the minimum, fastest steps to participate in geoconnex.us with a collection of static geospatial files representing locations or areas you have data about. It includes instructions on how to interact with geoconnex.us services through GitHub, install open-source software (pygeoapi) available on GitHub, and deploy this software on the internet (using Google Cloud Platform as an example).

6.1. Assumptions#

This quickstart makes some assumptions that may not be true in your case.

This quickstart assumes that have would like to publish a dataset you have available that in some way represents geospatial locations that have data related to water about them. Typical examples could be water quality monitoring sites, wells, streamgages, water utilities, weather stations, dams, and so on. Presumably, this is true if you are reading this. However, if you don’t want to publish a dataset, then we encourage you to read the Internet of Water report and reconsider!

This quickstart also assumes that you do not currently have a platform that publishes web content about individual features, and you do not have the resources, expertise, time, or desire to implement one customized to your needs in the near future. It offers pygeoapi as a free and open-source option to do so. If your data is being published through a web accessible folder or API, then it may be relatively simple for you to create landing pages using your own web development tooling if you have not already done so. If you already publish some kind of web site/ data portal with feature-specific landing pages, then you only need to modify your landing pages to include structure metadata formatted as JSON-LD and mint persistent identifiers for those pages.

6.2. The steps#

By following this quickstart, you will be able quickly publish landing pages with embedded JSON-LD about each feature you have data about, and register persistent identifiers them, allowing them to be harvested into the knowledge graph.

  1. Creating an identifier scheme

  2. Data preparation

  3. Deploying landing pages with JSON-LD using pygeoapi

  4. Minting persistent identifiers with the geoconnex.us GitHub repository