Skip to content

Indiapins is a Python package for getting the places tagged to a particular Indian Pincode

License

Notifications You must be signed in to change notification settings

pawangeek/indiapins

Repository files navigation

indiapins

https://img.shields.io/pypi/v/indiapins?label=PyPI&logo=PyPI&logoColor=white&color=blue Python versions Build Downloads Updates

Indiapins is a Python package for getting the places tagged to particular Indian pincode

Installation

Install the plugin using 'pip':

$ pip install indiapins

Alternatively, install from source by cloning this repo then running 'setup.py':

$ python setup.py install

Features

  • Get all the mappings of given pins
  • The Python sqlite3 module is not required, so easily to use in Clouds (no additional dependencies)
  • Works with Python 3.8, 3.9, 3.10, 3.11 and PyPy
  • Cross-platform: Windows, Mac, and Linux are officially supported.
  • Simple usage and very fast results

Examples

1. Exact Match

To find the names of all places, districts, circles and related information by given Indian Pincode

Important: The Pincode should be of 6 digits, in string format

indiapins.matching('110011')

[{'Name': 'Nirman Bhawan', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'},
{'Name': 'South Avenue', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Non-Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'},
{'Name': 'Udyog Bhawan', 'BranchType': 'Sub Post Office', 'DeliveryStatus': 'Non-Delivery', 'Circle': 'Delhi', 'District': 'Central Delhi', 'Division': 'New Delhi Central', 'Region': 'Delhi', 'Block': 'New Delhi', 'State': 'Delhi', 'Country': 'India', 'Pincode': '110011'}]

2. Valid Pincode

To check if the given Pincode is valid or not

indiapins.isvalid('110011')

True

3. District by Pincode

It extracts the district of given Indian pincode

indiapins.districtmatch('302005')

'Jaipur'

4. Coordinates of Pincode

It extracts all the coordinates of given Indian pincode

indiapins.coordinates('110011')

{'Udyog Bhawan': {'latitude': '28.6111111', 'longitude': '77.2127500'},
'Nirman Bhawan': {'latitude': '28.6108611', 'longitude': '77.2148611'}}

About

Indiapins is a Python package for getting the places tagged to a particular Indian Pincode

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published