Skip to content

Home

Jump to bottom
donwilson-rezare edited this page Sep 24, 2023 · 10 revisions

Introduction

This repository defines specifications that support standardised geospatial data for agriculture. The specifications in this repository seek to build on existing work, including spatial data projects carried out by AgGateway, INSPIRE, and Open Ag Data Alliance. The initial work on this project was funded through the New Zealand Agritech Industry Transformation partnership and carried out with the input of a number of New Zealand and Australian geospatial and agriculture specialists.

Getting involved with this project

This is an open-source project published under the Apache 2.0 Licence. The copyright holder on behalf of industry is the NZ Tech Alliance, of which Agritech New Zealand is a member.

  • If you see something that needs fixing, have a suggestion or a question, please submit an Issue. We advise that you do a quick search to see if a similar issue has already been submitted, and you are welcome to comment on existing issues providing your comment stays on topic and adds useful information.
  • You are welcome to suggest changes and improvements. Please create a fork, make your changes to that fork, and then submit a Pull Request with your changes. For more information about how to do this, see the GitHub Docs.
  • From time to time, we run facilitated workshops and discussion groups. You are welcome to contact the repository owner to find out about these. The brief meeting notes from discussions can be found here.

Using these specifications

There are several ways that you can use these specifications to share agricultural data:

  • Use the JSON Resources in your applications. You might use these to pass data through a range of APIs and protocols, including non-HTTP protocols.
  • Implement JSON REST APIs that deal with the JSON Resources as non-spatial attributes. We provide some OpenAPI URL schemes that you might use to generate your implementations, or to create clients that access other people’s implementations.
  • Implement or use GeoJSON APIs that embed the JSON Resources as properties within RFC-7946 GeoJSON features. This approach will also be compliant with Open Geospatial Consortium OGC API Core (Features).

These specifications use OpenAPI v3.1. The JSON schema version used is 2020-12.

Understand the specifications

There are some useful pages to help you understand the specifications:

Clone this wiki locally