Skip to content

Latest commit

 

History

History
63 lines (46 loc) · 1.91 KB

README.md

File metadata and controls

63 lines (46 loc) · 1.91 KB

Get Kinmen Address Coordinates

Introduction

This Python script retrieves address coordinates data from the Kinmen Urban Development Bureau website.

Features

  • Retrieves town, road, lane, alley, and door information from the Kinmen Urban Development Bureau website.
  • Uses multi-threading to process multiple towns concurrently.
  • Converts coordinates from TWD97 to WGS84.
  • Logs information about the retrieval process.
  • Writes the retrieved coordinates to a CSV file.

Dependencies

  • Python 3.x
  • requests
  • loguru
  • pyproj
  • beautifulsoup4

Installation

  1. Clone the repository:

    git clone https://github.com/skyksl066/getKinmenAddressCoordinates.git
    
  2. Install dependencies:

    pip install -r requirements.txt
    

Usage

  1. Run the script:

    python app.py
    
  2. The retrieved coordinates will be saved in a CSV file named data.csv.

Configuration

  • MAX_RETRIES: Maximum number of retries for failed requests.
  • API: URL for the API used to retrieve data.
  • LOG_PATH: Path to the log file.
  • CSV_FILE: Path to the CSV file to save coordinates.
  • FIELDNAMES: Names of the fields in the CSV file.
  • RESUME_FILE: Path to the file to store processed locations.
  • BATCH_SIZE: Number of towns to process concurrently.

HTML Functionality

The index.html file in this project serves as the user interface for displaying the retrieved data. It offers the following functionality:

  • Bootstrap Integration: Utilizes Bootstrap 5 for consistent styling and responsive layout.
  • DataTables Integration: Incorporates DataTables to enable interactive table features.
  • Theme Detection: Detects the system's preferred color scheme and applies it to the UI for a cohesive user experience.

Notes

  • Ensure internet connectivity for the program to work.
  • The program may take some time to complete processing, depending on the number of towns and roads.