G-NAF LDAPI

About

This is a Linked Data API delivering data from the G-NAF, the Geocoded National Address File.

It was initially developed through a joint initiative between PSMA Australia , Geoscience Australia & CSIRO to test the application of Linked Data technologies to large spatial datasets. The hope is that Linked Data will allow new applications of data presentation, access, mining and sharing that improve Australia've value from the G-NAF.

This system is now part of a system-of-systems delivering Linked Data for multiple national spatial datasets. The overall system is being built within the Location Integration Capability (LOC-I) project..

Detailed documentation of this system within the overall system and components of this system is given in the LOC-I project wiki, see:

The Linked Data API

This API is a minimal implementation of a RESTful HTTP API that allows portions of the G-NAF dataset to be delivered as human- or machine-readable web resources (web pages and code files). It essentially presents endpoints (URI s- web addresses) for address-related items according to various conceptual models. Conceptual models such as the ISO's 19160-1:2015 -- Addressing are related to the elements in the G-NAF through deliberate mappings which are made in the Model portion of this API codebase. The API then extracts data for its various models from the G-NAF database using SQL queries that this API applied to a local copy of the G-NAF. It then uses HTML templates or in-memory graphs to generate Views for human or machine reading.

The following tools are used by this API:

See the LOC-I Geofabric spatial dataset component diagram for more info.

License

The code for this API is licensed under Creative Commons 4.0.

This essentially means you can copy and redistribute the code in any medium or format and remix, transform, and build upon the material for any purpose, even commercially, as long as you give appropriate credit, provide a link to the license, and indicate if changes were made.

The source code for this API is available on GitHub.

Further documentation

Further documentation for this API, and all of its source code, is contained within its Git code repository at:

Contacts

This API is developed by:

Joseph Abhayaratna
CTO, PSMA Australia Ltd.
Joseph.Abhayaratna@psma.com.au

Nicholas Car
Senior Experimental Scientist
nicholas.car@csiro.au
ORCID:0000-0002-8742-7730