Skip to content

Instantly share code, notes, and snippets.

@natdudley
Last active August 16, 2016 21:22
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save natdudley/fc1f3aac0febfd13667f023e0554b762 to your computer and use it in GitHub Desktop.
Save natdudley/fc1f3aac0febfd13667f023e0554b762 to your computer and use it in GitHub Desktop.
Figure.NZ API

We're in the process of rebuilding our Figure.NZ API after building a new database structure earlier this year, and we want to get your input.

We hold a bunch of different types of objects:

  • Tables, which have been extracted and standardized into machine-readable formats. Most of these are sourced from various open government data sets.
  • Charts, created from our datasets to meet our charting standards, available in a variety of formats.
  • Enumerations, relations, and synonyms. These are concepts we've built up to describe links between data.
    • Enumerations: Lists used to standardize items, enabling us to define things in a consistent way. For example, a list of fields of study might have a standardized format for Computer Science. Enumerations are used to build relations.
    • Administrative relations: Te Aro has a relationship to Wellington City which has a relationship to Wellington Region, which has a relationship to New Zealand.
    • Conceptual relations: An aircraft pilot is related to the airport and airline industries, and those industries are related to the physical location of airports.
    • Synonyms: Different terms used for items in enumerations. For example, Computer Science might have synonyms CompSci, comp sci, computer science.

There's also some miscellaneous other data which is probably of less interest (user saved lists, lists of patrons/supporters)

It'd be useful to know what bits of this are of interest to people, and what they want to be able to do.

How to give feedback

One of our team @natdudley will be at OS/OS conference in Wellington next week. Otherwise, email nat@figure.nz, or leave a comment here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment