Utility for translating lat, long coordinates into neighborhoods in various cities
Project description
# Neighborhoodize
![](https://img.shields.io/pypi/v/Neighborhoodize.svg)
Neighborhoodize uses `fastkml`, `fiona`, and `shapely` to determine what
neighborhood a latitude, longitude pair resides in.
## Installation
### Dependencies
This package uses `shapely` and `fiona`, which require `GEOS` and `GDAL`. On OS
X and Windows you shouldn't need to worry about these, but on a Linux system you
may need to install them:
#### Debian/Ubuntu
`apt-get install libgeos-dev libgdal1-dev`
### This package
`pip install Neighborhoodize`
:boom: boom emoji, you're done.
## Usage example
```
import neighborhoodize
hood_map = neighborhoodize.NeighborhoodMap(neighborhoodize.zillow.ILLINOIS)
hood_map.get_neighborhoods(41.879617, -87.633463)
# [u'Loop']
```
## NeighborhoodMaps available for use
### Zillow
Zillow provides their neighborhood boundaries free under Creative Commons.
These are good boundaries to use for colloquial/property-value related use cases.
- `zillow.ILLINOIS`
- `zillow.NEW_YORK`
- more coming soon...
### City of New York
- `nyc.NEIGHBORHOOD_TABULATION_AREAS` (these are [defined](http://www.nyc.gov/html/dcp/html/bytes/applbyte.shtml)
by the Department of City Planning)
### City of Chicago
- `city_of_chicago.NEIGHBORHOODS` (these are
[defined](https://data.cityofchicago.org/Facilities-Geographic-Boundaries/Boundaries-Neighborhoods/9wp7-iasj)
by the Department of Tourism)
*Have other boundaries you want to see in the package? Open an issue, or,
better yet, make a pull request!*
## Other implementations
jkgiesler's [`chicago_neighborhoods`](https://github.com/jkgiesler/chicago_neighborhoods)
provides similar functionality for Chicago without dependencies.
coddingtonbear's [`django-neighborhoods`](https://github.com/coddingtonbear/django-neighborhoods)
provides similar functionality as a Django app.
## Future of this project
(see Issues for details/to make suggestions)
- ability to use Chicago community areas or wards instead of 2012 neighborhoods
- ability to use subarb boundaries for Chicagoland areas not inside the city limits
- additional cities
![](https://img.shields.io/pypi/v/Neighborhoodize.svg)
Neighborhoodize uses `fastkml`, `fiona`, and `shapely` to determine what
neighborhood a latitude, longitude pair resides in.
## Installation
### Dependencies
This package uses `shapely` and `fiona`, which require `GEOS` and `GDAL`. On OS
X and Windows you shouldn't need to worry about these, but on a Linux system you
may need to install them:
#### Debian/Ubuntu
`apt-get install libgeos-dev libgdal1-dev`
### This package
`pip install Neighborhoodize`
:boom: boom emoji, you're done.
## Usage example
```
import neighborhoodize
hood_map = neighborhoodize.NeighborhoodMap(neighborhoodize.zillow.ILLINOIS)
hood_map.get_neighborhoods(41.879617, -87.633463)
# [u'Loop']
```
## NeighborhoodMaps available for use
### Zillow
Zillow provides their neighborhood boundaries free under Creative Commons.
These are good boundaries to use for colloquial/property-value related use cases.
- `zillow.ILLINOIS`
- `zillow.NEW_YORK`
- more coming soon...
### City of New York
- `nyc.NEIGHBORHOOD_TABULATION_AREAS` (these are [defined](http://www.nyc.gov/html/dcp/html/bytes/applbyte.shtml)
by the Department of City Planning)
### City of Chicago
- `city_of_chicago.NEIGHBORHOODS` (these are
[defined](https://data.cityofchicago.org/Facilities-Geographic-Boundaries/Boundaries-Neighborhoods/9wp7-iasj)
by the Department of Tourism)
*Have other boundaries you want to see in the package? Open an issue, or,
better yet, make a pull request!*
## Other implementations
jkgiesler's [`chicago_neighborhoods`](https://github.com/jkgiesler/chicago_neighborhoods)
provides similar functionality for Chicago without dependencies.
coddingtonbear's [`django-neighborhoods`](https://github.com/coddingtonbear/django-neighborhoods)
provides similar functionality as a Django app.
## Future of this project
(see Issues for details/to make suggestions)
- ability to use Chicago community areas or wards instead of 2012 neighborhoods
- ability to use subarb boundaries for Chicagoland areas not inside the city limits
- additional cities
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Neighborhoodize-0.9.4.tar.gz
(924.7 kB
view hashes)