Skip to content

Latest commit

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

locaspy

locaspy is a Python package designed for retrieving location-based information such as geographical coordinates, weather conditions, ISP details, and more, using an IP address as input.

Benefits

  • Convenience : Easily retrieve detailed information about any IP address.
  • Flexibility : Retrieve specific details such as weather, location, ISP, and more.
  • Integration : Useful for integration into applications needing location-based services.
  • Accuracy : Utilizes reliable APIs to provide accurate information.

Who Would Benefit?

  • Developers : Integrate location-based features into applications.
  • Network Administrators : Quickly gather IP-related details.
  • Security Analysts : Obtain context about IP addresses during investigations.

Installation

You can install locaspy via pip:

pip install locaspy

Usage

Overview

  • locaspy provides functions to fetch various types of information based on an IP address.

How do you print your IP address?

importlocaspymy_ip=locaspy.get_my_ip()
print("My IP Address:", my_ip)

Here's how you can use the locaspy package to print all available information based on the user's IP address:

importlocaspy# Get the user's IP addressip_address=locaspy.get_ip()
# Get all information based on the IP addressinfo=locaspy.get_data(ip_address)
# Print all informationprint("IP Address:", info["ip_address"])
print("Google Maps Link:", info["map_link"])
print("Location:")
print(f" City: {info['city']}")
print(f" Region: {info['region']}")
print(f" Country: {info['country']}")
print(f" Latitude: {info['latitude']}")
print(f" Longitude: {info['longitude']}")
print(f" Timezone: {info['timezone']}")
print(f" Country Code: {info['country_code']}")
print(f" Country Capital: {info['country_capital']}")
print(f" ISP: {info['isp']}")
print(f" ASN: {info['asn']}")
print(f" Organization: {info['organization']}")
print(f" Postal Code: {info['postal']}")
print(f" UTC Offset: {info['utc_offset']}")
print(f" Continent: {info['continent']}")
print(f" Currency: {info['currency']}")
print(f" Languages: {info['languages']}")
print("Weather:")
print(f" Condition: {info['weather_condition']}")
print(f" Temperature: {info['temperature']}°C")
print(f" Wind Speed: {info['wind_speed']} km/h")

Example Usages

Get Google Maps Link

importlocaspyip_address=input("Enter your IP: ")
map_link=locaspy.get_data(ip_address, "map")
print("Google Maps Link:", map_link)

Get Weather Information

importlocaspyip_address=input("Enter your IP: ")
weather_info=locaspy.get_data(ip_address, "weather")
print("Weather Information:", weather_info)

Get Location Details

importlocaspyip_address=input("Enter your IP: ")
location_info=locaspy.get_data(ip_address, "location")
print("Location Details:\n", location_info)

Get ISP Information

importlocaspyip_address=input("Enter your IP: ")
isp_info=locaspy.get_data(ip_address, "isp")
print("ISP Information:", isp_info)

Get ASN Information

importlocaspyip_address=input("Enter your IP: ")
asn_info=locaspy.get_data(ip_address, "asn")
print("ASN Information:", asn_info)

Get Postal Code

importlocaspyip_address=input("Enter your IP: ")
postal_code=locaspy.get_data(ip_address, "postal")
print("Postal Code:", postal_code)

Get Continent

importlocaspyip_address=input("Enter your IP: ")
continent=locaspy.get_data(ip_address, "continent")
print("Continent:", continent)

Get Currency

importlocaspyip_address=input("Enter your IP: ")
currency=locaspy.get_data(ip_address, "currency")
print("Currency:", currency)

Get Languages

importlocaspyip_address=input("Enter your IP: ")
languages=locaspy.get_data(ip_address, "languages")
print("Languages:", languages)

To save all data in a single file

importlocaspy# Get the user's IP addressip_address=locaspy.get_ip()
# Get all information based on the IP addressinfo=locaspy.get_data(ip_address)
# Define the file pathfile_path="data.txt"# Open the file in write mode and write the informationwithopen(file_path, "w") asfile:
file.write(f"IP Address: {info['ip_address']}\n")
file.write(f"Google Maps Link: {info['map_link']}\n")
file.write("Location:\n")
file.write(f" City: {info['city']}\n")
file.write(f" Region: {info['region']}\n")
file.write(f" Country: {info['country']}\n")
file.write(f" Latitude: {info['latitude']}\n")
file.write(f" Longitude: {info['longitude']}\n")
file.write(f" Timezone: {info['timezone']}\n")
file.write(f" Country Code: {info['country_code']}\n")
file.write(f" Country Capital: {info['country_capital']}\n")
file.write(f" ISP: {info['isp']}\n")
file.write(f" ASN: {info['asn']}\n")
file.write(f" Organization: {info['organization']}\n")
file.write(f" Postal Code: {info['postal']}\n")
file.write(f" UTC Offset: {info['utc_offset']}\n")
file.write(f" Continent: {info['continent']}\n")
file.write(f" Currency: {info['currency']}\n")
file.write(f" Languages: {info['languages']}\n")
file.write("Weather:\n")
file.write(f" Condition: {info['weather_condition']}\n")
file.write(f" Temperature: {info['temperature']}°C\n")
file.write(f" Wind Speed: {info['wind_speed']} km/h\n")
# Print confirmation messageprint(f"Data has been saved to {file_path}")

Thanks

Thank you for using locaspy! We appreciate your interest in our tool and hope it meets your needs.

Additional Information

For any issues, suggestions, or contributions, please visit our GitHub repository

We welcome and encourage contributions from the community. Whether it's reporting a bug, suggesting a feature, or improving the documentation, your feedback is valuable and helps us improve the project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

We would like to acknowledge the following libraries and resources that made this project possible:

Thank you again for your support!

About

A tool for fetching location, weather, and map link based on IP address.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors