Click 2 Vector

An interactive Streamlit application for creating and exporting geographic points as multiple vector formats. Click on a map, import from Google Sheets, or enter coordinates manually to build your dataset, then export it for use in GIS software, web maps, or other spatial applications.

Installation & Setup

This project uses pip for dependency management.

Prerequisites

• Python 3.9+ (excluding 3.9.7)
• pip

Installation

1. Clone the repository

   git clone <repository-url>
   cd click2vector

2. Install dependencies with pip

   pip install -r requirements.txt

3. Run the application

   streamlit run streamlit_app.py

4. Open your browser and navigate to the local URL (typically http://localhost:8501)

Development Setup

For development, install additional dependencies and set up pre-commit hooks:

1. Install development dependencies

   pip install -r requirements-dev.txt

2. Install pre-commit hooks

   pre-commit install

3. Run pre-commit on all files (optional)

   pre-commit run --all-files

Usage

Adding Points

• Map Clicking: Simply click anywhere on the interactive map to drop a pin
• Location Search: Use the search box in the top-right corner to find specific places
• Google Sheets Import: Paste a public Google Sheets URL with coordinate data

Google Sheets Import

Your Google Sheet should have either:

• A column with 'wkt' or 'geom' in the name containing WKT Point format: Point (longitude latitude)
• OR separate columns with 'lat' and 'lon' (or 'lng') in their names

Managing Your Data

• View Points: Expand the "Point Table" to see all your points in an interactive table
• Delete Points: Remove individual points by selecting rows in the table, or use the "Remove Last Point" and "Clear All Points" buttons
• Export Data: Choose from multiple formats and download your complete dataset

CHANGELOG

0.8.0 : 2025-10-13

• Remove extra below app with HTML.

0.7.0 : 2025-08-24

• Added GeoJSON pretty print format with GeoJSON export option.

0.6.0 : 2025-08-23

• Added columns to input and output UI to shorten scroll space in the app.

0.5.0 : 2025-08-23

• Added ability for the user to select different basemap options (CartoDB Positron, OpenStreetMap)

0.4.0 : 2025-08-23

• Created custom point marker based on branding.

0.3.1 : 2025-08-23

• Fixed bug that ignored user filename input.

0.3.0 : 2025-08-23

• Adjusted basemap tiles from OpenStreetMap to Cartodb Positron

0.2.0 : 2025-08-23

• Added radio button for specifying which coordinate type to import from Google Sheets.

0.1.0 : 2025-07-16

• Initial release

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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

Support

If you encounter any issues or have questions:

1. Check the existing issues on GitHub
2. Create a new issue with detailed information
3. Include steps to reproduce any bugs