Click 2 Vector

Click 2 Vector is an interactive Streamlit app for creating and exporting geographic points as multiple vector formats. Click on a map, import from Google Sheets, or search for a place to build your dataset, then export it for GIS software, web maps, or other spatial applications.

Open in Streamlit

Installation & Setup

This project uses Poetry for dependency management.

Prerequisites

• Python 3.11+
• Poetry

Installation

1. Clone the repository

   git clone <repository-url>
   cd click2vector

2. Install dependencies with Poetry

   poetry install

3. Run the application

   poetry run 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 all dependencies (including dev)

   poetry install

2. Install pre-commit hooks

   poetry run pre-commit install

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

   poetry run pre-commit run --all-files

Usage

Adding Points

• Map Clicking: Click anywhere on the map to drop a pin; drag pins to adjust their location
• Place Search: Search for a place above the map and press Enter to geocode it as a pin (works when deployed on Streamlit Cloud via a Photon fallback if Nominatim is unavailable)
• Google Sheets Import: Paste a public Google Sheets URL with coordinate data (under Advanced options)

Google Sheets Import

Paste a public Google Sheet URL with lat and lon columns under Advanced options (or choose WKT Geometry below the URL). Include #gid=... in the URL when your data is on another tab. If headers are missing, the app shows an error with guidance on title rows and header placement.

Managing Your Data

• View Points: Expand the Location table to see and edit points
• Descriptions: Add an optional description per point; descriptions are included in exports
• Display Settings: Configure basemap, inset map, legend, and pin clustering; choose a column to color locations by and edit legend labels and colors
• Pin Clustering: Toggle Points vs Clusters to show individual pins or merge overlapping pins into count bubbles (colored by the most common pin color in each group)
• Auto-zoom: The map fits all points when locations are added, imported, or removed
• Delete Points: Delete rows directly in the Location table using the row delete control
• Export Data: Choose export format and filename, then download; exports include lat and lon attribute columns

CHANGELOG

0.11.2 : 2026-05-31

• Locked the app to light mode only.

0.11.1 : 2026-05-30

• Fixed place search crashing on Streamlit Cloud when Nominatim rejected requests.
• Added Photon geocoding fallback and user-facing errors when geocoders are unreachable.

0.11.0 : 2026-05-30

• Added optional location clustering with majority-color styling.
• Added auto-zoom to fit all points when the location set changes.
• Added a Display settings section for basemap, inset map, legend, clustering, and location coloring.
• Renamed Point table to Location table and separated it from display options.
• Moved basemap and inset map controls out of Advanced options.

0.10.0 : 2026-05-30

• Added Google Sheets tab selection from #gid=... in the shared URL.
• Added informative import errors when coordinate headers are missing or below a title row.
• Added pin coloring by any Point Table column, with editable legend display names.
• Added optional category color legend on the map and Folium fullscreen control.
• Reorganized search, Advanced options, Point Table, and export layout.
• Added direct row deletion in the Point Table and Enter-to-search for place lookup.
• Removed separate point-management buttons and custom global button styling.
• Added more basemap options

0.9.1 : 2026-05-30

• Added lat and lon attribute columns to all export formats.
• Added export filename extension inference from the selected format.

0.9.0 : 2026-05-30

• Added optional description column per point, included in exports.
• Added pin colors by description with per-value color pickers in the Point Table.
• Added place search above the map with geocoded Add pin workflow.
• Added draggable map pins.
• Added Advanced options for basemap, pin color, inset map, Google Sheets import, export format, and GeoJSON preview.
• Added inset map toggle (off by default).
• Raised minimum Python version to 3.11 for streamlit-folium compatibility.

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