Page History
...
| Table of Contents | ||
|---|---|---|
|
Overview
| Styleclass | ||
|---|---|---|
| ||
In order to create a new GeoPack the data will need to be submitted to Yellowfin for pack generation. This This page will explore the files that are required to create GeoPacks.GeoPacks require the following files These include:
- A CSV file for each level of the geographical hierarchy in the pack, containing geometry and aliases.
- A CSV file containing demographic names and values for the lowest level of the geographical hierarchy. (You only need the lowest level, as Yellowfin will automatically aggregate these values up if higher levels are used instead)
- A metadata file specifying how the CSVs link together.
Source & Disclaimer information is required for all GeoPacks. It's important to ensure any source data used has been acquired in an appropriate manner and is allowed to be redistributed in this form.
Example
For the purposes of the examples throughout the page, we will explore a scenario around creating a GeoPack for Australia, which has three levels of geographical hierarchy:
...
- A CSV file containing geometry and aliases for States.
- A CSV file containing geometry and aliases for Postcodes.
- A CSV file containing geometry and aliases for Suburbs.
- A CSV file containing demographic names and values for Suburbs.
- A metadata file specifying how the CSVs link together.
CSV Geometry & Aliases File(s)
| Styleclass | ||
|---|---|---|
| ||
Naming Conventions
The CSVs containing geometry and aliases must all share a common name, suffixed with an underscore and the order of the CSV in the pack hierarchy.
...
| Code Block |
|---|
"Suburb" "Suburb Name" "Sydney CBD","2000","<WKT Point>","<WKT Polygon>" "Darling Harbour","2000","<WKT Point>","<WKT Polygon>" "Haymarket","2000","<WKT Point>","<WKT Polygon>" "Darling Island","2009","<WKT Point>","<WKT Polygon>" ... "Melbourne CBD","3000","<WKT Point>","<WKT Polygon>" "Docklands","3008","<WKT Point>","<WKT Polygon>" ... etc ... |
CSV Demographic File
| Styleclass | ||
|---|---|---|
| ||
Naming Convention
This CSV file, containing demographic values for the bottom level of the hierarchy, must use the same common name used by the Hierarchy CSVs, suffixed with an underscore and the word "demo".
...
| Code Block |
|---|
"Population","Median Income" 14308,75000,"Sydney CBD" 28371,60000,"Melbourne CBD" ... etc ... |
Metadata File
| Styleclass | ||
|---|---|---|
| ||
Naming Convention
This file, containing linking information about the CSVs, must use the same common name used by the CSV files, with no suffix or file extension.
...
| Code Block |
|---|
2,2 1,2 1,3 SUM,AVG |
Source & Disclaimer
| Styleclass | ||
|---|---|---|
| ||
All GeoPacks come with both source and disclaimer information, which is presented to users when they attach a pack to a field. A sample of this information is displayed here:
This GeoPack provides geometry for every country on Earth. It includes a metric for country population estimates as of 2005. Source:
Although the data in this GeoPack has been produced and processed from sources believed to be reliable, no warranty, expressed or implied, is made regarding accuracy, adequacy, completeness, legality, reliability or usefulness of any information. This disclaimer applies to both isolated and aggregate uses of the information. The information is provided on an "as is" basis. All warranties of any kind, express or implied, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, freedom from contamination by computer viruses and non-infringement of proprietary rights are disclaimed. Changes may be periodically made to the information herein; these changes may or may not be incorporated in any new version of the publication. Data can also quickly become out-of-date. It is recommended that careful attention be paid to the contents of any data associated with a file, and that the originator of the data or information be contacted with any questions regarding appropriate use. If you find any errors or omissions, please report them to the provider. |
As you can see, this pack has provided:
- Information on the contents of the pack and any possible data disputes.
- Information on the source of the data, including a link to the website itself.
- Disclaimer information.
| horizontalrule |
|---|
| Styleclass | ||
|---|---|---|
| ||