pawangeek / indiapins

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

indiapins

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

• Free software: MIT license
• Documentation: https://pawangeek.github.io/indiapins/
• Github Repo: https://github.com/pawangeek/indiapins
• PyPI: https://pypi.org/project/indiapins/

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'}}