Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

GeoPy

GeoPy is a Python-based geocoding utility that processes company address data from an Excel file and converts it into latitude and longitude coordinates. This can be useful for mapping, location analysis, and data enrichment workflows.

Features

  • Reads address data from an Excel file
  • Converts registered addresses into geographic coordinates
  • Outputs the processed results into a new Excel file
  • Simple and easy to run in a local Python environment

Prerequisites

Before running the script, make sure you have the following installed:

  • Python 3
  • Visual Studio Code or any Python-compatible IDE

Required Libraries

This project requires the following Python libraries:

  • pandas
  • requests

The following modules are included in Python by default, so no separate installation is needed:

  • json
  • time

To install the required libraries, run:

pip install pandas requests

Input File Requirements

Your Excel file must contain the following exact column headers:

  • Registered_Address
  • Company_name

These column names must match exactly, including capitalization and underscores.

Configuration

  1. Set the input file name

Locate the following line in the script:

df = pd.read_excel("FILE-NAME.xlsx")

Replace "FILE-NAME.xlsx" with the name of your actual Excel input file.

  1. Set the output file name
df.to_excel("FILE-NAME.xlsx")

How to Run

Open your terminal in the project folder and run:

py geo.py

Output

The script will generate a new Excel file containing the processed results, including the corresponding latitude and longitude values for each registered address.

Notes

Make sure the Excel file is in the same directory as the script unless you specify the full file path. Ensure the column headers are written exactly as required. File names in the code must be enclosed in double quotes. Incorrect column names may cause the script to fail during execution. Use Case

This project is useful for:

Geocoding business address data Supporting mapping and visualization projects Automating coordinate lookups from spreadsheet-based records Enriching datasets with location information

Author

Created as a simple geocoding utility for processing address-based Excel data using Python.

About

Python geocoding tool that converts address data into latitude and longitude coordinates.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages