Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/datamade/probation-resources-map

Interactive, searchable map that helps people on probation find social, health, and cultural resources throughout Chicago
https://github.com/datamade/probation-resources-map

Last synced: 3 months ago
JSON representation

Interactive, searchable map that helps people on probation find social, health, and cultural resources throughout Chicago

Host: GitHub
URL: https://github.com/datamade/probation-resources-map
Owner: datamade
License: other
Created: 2016-07-18T15:58:00.000Z (over 8 years ago)
Default Branch: main
Last Pushed: 2024-05-09T21:20:28.000Z (9 months ago)
Last Synced: 2024-11-04T01:32:54.474Z (3 months ago)
Language: JavaScript
Homepage: https://probationcommunityresources.org/
Size: 623 KB
Stars: 10
Watchers: 6
Forks: 8
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-starred - datamade/probation-resources-map - Interactive, searchable map that helps people on probation find social, health, and cultural resources throughout Chicago (others)

README

# Probation Community Resources

Probation Community Resources is an online interactive, searchable map that helps users:

- find **social, health, and cultural resources** throughout Chicago
- identify services within **certain geographic boundaries**
- suggest **updates, changes, and additions** to the directory

Built in collaboration with the Cook County Adult Probation Department (CCAPD), the Cook County Juvenile Probation Department (CCJPD), the Sargent Shriver National Center on Poverty Law, the Chicago Appleseed Fund, and the Health & Medicine Policy Research Group, Probation Community Resources helps criminal justice personnel refer clients to culturally relevant and geographically specific community-based services.

![Probation Community Resources](https://raw.githubusercontent.com/datamade/probation-resources-map/main/images/probation-community-resources.jpg)

## Installation


  $ git clone https://github.com/datamade/probation-resources-map.git

  $ cd site_template

  $ gem install jekyll

  $ jekyll serve -w

  navigate to http://localhost:5000/

## Data updates

The data for this site is housed a Google Spreadsheet and synced with CARTO. Initially, it was set up to automatically update every 30 minutes, but the automatic import for CARTO failed on parsing the spreadsheet properly. Now, to do updates, you must take the following steps:

1. Download a CSV of the `Probation Resources Map` Google Sheet: https://docs.google.com/spreadsheets/d/1iShheCZRamOmuWo3SETgbWopHCCu1DRB_F5_FZMKp5A/edit#. This ensures only the sheet with the info we want is included (CARTO gets confused by Excel files with multiple sheets)
2. In Excel or LibreOffice, save the CSV as an XLSX file.
2. In CARTO, create a new dataset and make sure the "Let CARTO automatically guess data types and content on import." box is UNCHECKED (if it is, CARTO will convert fields like Yes/No into boolean true/false)
3. After the table is created, go to Edit => Georeference and select the latitude and longitude columns to set as the location.
4. Set the table to visible With link
5. Click visualize to create a map visualization layer
6. Click Publish and copy the visualization layer URL under CartoDB.js (should be something like `https://datamade.carto.com/api/v2/viz/b9ab99de-e4e7-4625-9dc5-032097853133/viz.json`) and update `layerUrl` in `cartodb_lib.js`.
7. Copy the table name (found by clicking on the SQL icon on the right) and update `tableName` in `cartodb_lib.js`
8. Preview the site and make sure there are no javascript errors and the points display as expected. If the map doesn't display, open up the Network tab to diagnose errors from CARTO. It won't throw javascript errors, but the network responses from their domain will tell you the error it encountered. It is typically due to column names being slightly changed or renamed.

## Dependencies

* [Jekyll](http://jekyllrb.com)
* [CartoDB](http://docs.cartodb.com/cartodb-platform/cartodb-js.html)
* [Leaflet](http://leafletjs.com)
* [jQuery](http://jquery.org)
* [jQuery Address](http://www.asual.com/jquery/address)
* [Bootstrap](http://getbootstrap.com)

## Data

The data for this tool resides in a Google spreadsheet and its corresponding Carto table.

Most of the data has been (and continues to be) manually entered by people associated with CCAPD, CCJPD, the Shriver Center, the Appleseed Fund, and the HMPR Group. One data piece can be automated: the discovery of latitude and longitude for facility addresses. We use [Google Sheets Geocoder](https://github.com/jackdougherty/google-sheets-geocoder) - specifically, [geocoder-census-google.gs](https://raw.githubusercontent.com/JackDougherty/google-sheets-geocoder/master/geocoder-census-google.gs) - a library that converts addresses into lat-long coordinates.

## Run Tests

This site includes a basic test suite built with Rspec and Capybara, which drive the browser to perform acceptance tests.


  $ bundle install

  $ rspec spec/

Some tests include **binding.pry**. In such cases the test pauses, after which you may type "exit" in the terminal to continue.

## Team

* [Derek Eder](mailto:[email protected])
* [Regina Compton](mailto:[email protected])

## Errors / Bugs

If something is not behaving intuitively, it is a bug, and should be reported.
Report it here: https://github.com/datamade/probation-resources-map/issues

## Note on Patches/Pull Requests

* Fork the project.
* Make your feature addition or bug fix.
* Commit, do not mess with rakefile, version, or history.
* Send a pull request. Bonus points for topic branches.

## Copyright

[See LICENSE for details](https://github.com/datamade/probation-resources-map/blob/main/LICENSE)