Skip to content
forked from sjlu/cities

Lookup cities based on zipcodes or GPS coordinates

Notifications You must be signed in to change notification settings

jbranchaud/cities

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cities

Circle CI

Cities is an easy to use Node.js library to allow you to lookup a city by it's zipcode or by a set of GPS coordinates (reverse geocoding).

At the moment, this package only supports US cities only. There are plans to extend this in the next version.

Usage

Webservice

Like any node.js application.

npm install
node server.js

You can then visit http://localhost:4000 with the endpoints /gps/:lat/:lng or /zip/:zipcode to get locations.

Install

npm install cities --save

Usage

var cities = require('cities');

Lookup by GPS coordinates

cities.gps_lookup(lat, lng);

Lookup by zipcode

cities.zip_lookup(zipcode);

Lookup by state

cities.findByState('NJ')

Sample Response

A sample response or object that this module returns looks like this.

{
    zipcode: "07946",
    state_abbr: "NJ",
    latitude: "40.672823",
    longitude: "-74.52011",
    city: "Millington",
    state: "New Jersey"
}

License

MIT.

About

Lookup cities based on zipcodes or GPS coordinates

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%