Getting Started

Get your own copy of finda

Add your data

Finda can read data formatted as geojson or data in json format from Socrata's Open Data Portal through the SODA API. If your data is on some other format (excel file, csv) you will need to convert it before using Finda.

###Flat geojson

To edit the data in Finda open the data.geojson file.

The geojson specification requires that objects be stored in a FeatureCollection. An empty FeatureCollection looks like this:

{
  "type": "FeatureCollection",
  "features": []
}

Paste.

Inside the brackets add your own list of datapoints. Datapoints in geojson should look like this:

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [-72.6411923, 42.3250492]
  },
  "properties": {
    "property1": ["apples", "oranges"],
    "property2": "no dogs allowed",
    "property3": 14
  }
}

Edit the Configuration to specify the data type to be a flat file:

"data_type": "flat",
"geojson_source": "data.geojson"

Commit your changes!

###SODA data

Edit the Configuration to specify the data type to be a Socrata query:

"data_type": "soql",

And then specify the soql query, for example, to get open building permits labelled "Roxbury" from the city of Boston.

"geojson_source": "https://data.cityofboston.gov/resource/msk6-43c6.json?$select=owner,address,permitnumber, worktype, permittypedescr, description, applicant, declared_valuation, issued_date, expiration_date, sq_feet, location &$where=city = 'Roxbury' AND owner IS NOT NULL AND status = 'OPEN' " 

Serve it

If you've forked the project on github then the hosting is already taken care of using github's gh-pages.

Navigate to http://your-github-username.github.io/finda to view your new website.

Configure it

To configure the elements on the page edit the Configuration.