hoods

1.2.0 • Public • Published

hoods

Give me a lng/lat and I'll give you a neighborhood.

See hoods-as-a-service.herokuapp.com for examples and an HTML5 geolocation demo.

For a list of included cities and neighborhood names, see names.md. If your city is not represented, please ask Zillow nicely for more data.

Notes

  • This module doesn't make any network requests.
  • All the data is in the module itself. It's under 50MB.
  • The neighborhoods boundary data comes from Zillow.
  • Data was converted from shapefiles to GeoJSON using gdal.
  • The point-in-polygon function is powered by turf.
  • If the given point is in more than one neighborhood, all matches are returned.
  • Data is only for US

Installation

Download node at nodejs.org and install it, if you haven't already.

npm install hoods --save

Usage

const hoods = require("hoods")
const assert = require('assert')
 
var hood = hoods(-90.132093, 29.934436)[0]
 
assert.equal(hood.name, 'Black Pearl')
assert.equal(hood.city, 'New Orleans')
assert.equal(hood.county, 'Orleans')
assert.equal(hood.state, 'LA')
assert(hood.region_id)
assert(hood.geometry)
 

Tests

npm install
npm test

Dependencies

  • lodash.flatten: The modern build of lodash’s _.flatten as a module.
  • require-dir: Helper to require() directories.
  • turf: a node.js library for performing geospatial operations with geojson

Dev Dependencies

  • mocha: simple, flexible, fun test framework
  • standard: JavaScript Standard Style

License

MIT

Special thanks to Zillow for the data and Mapbox for guidance.

Generated by package-json-to-readme

Package Sidebar

Install

npm i hoods

Weekly Downloads

2

Version

1.2.0

License

MIT

Last publish

Collaborators

  • zeke