/indian_places

A npm package to get all the recognized places of india including pincode

Primary LanguageTypeScriptMIT LicenseMIT

Indian Places

List of india places including pincode. Demo

Installation

npm i indian_places

Example

const ip = require("indian_places");

// To get the states
const states = ip.getStates();

// To get the district of a state
const westBengal = states.find((item) => item.name === "West Bengal");
const districtsOfWb = westBengal.getDistricts();

// To get places of a specific district
const north24Pgs = districtsOfWb.find(
  (item) => item.name === "North 24 parganas"
);
const places = north24Pgs.getPlaces();

// To get places by pincode
// This function will return empty array if that pincode doesn't exists
const places = ip.getPlacesByPin(743271);

Functions

To get place data, package contains essential functions which will help you to retrive exact place from mapped data. I described little bit about object types below.

func() parameter returns
getStates() None Array of State Obj
getDistrictsByState() State - obj Array of District Obj
getPlacesByDistrict() District - obj Array of Place Obj
getPlacesByPin() pincode - number Array of State Obj

Objects

State Object

member description
name State name
getDistricts() Method to get districts of that state

District Object

member description
name District name
state State name of that district
getPlaces() Method to get places of that district

Place Object

member description
name Place name
district District name of that place
state State name of that place
pin Pincode of that place

At last

If you like this wrapper package please give this repo a star :)

Credits, India gov data portal