A python app for creating sectional search areas to break up a Google Maps api places search. Inside the selected area, a search radius can be applied to break the area up into multiple search points. Once the search area points have been calculated, input a file name to save the search data to. Finally input your keyword and start the search. The results will be saved into a csv file containing the Google Places ID and the extractred email.
python3 -m venv venv
source venv/bin/activate
pip install -r requirments.txt
Activate python virtual environment
source venv/bin/activate
then run the search with the app with
python main.py
In order to make requests with the Google Places API users must input their Google API key which can be found here https://developers.google.com/maps/documentation/places/web-service/get-api-key. On the initial app launch, a screen will ask for your API key. Paste it into the text field and click | save. Keys will be stored in ./.secrets/googlekey
WARNING! This is VERY VERY dangerous. You should never blindly import API keys into an application you do not trust.
This is all written in python and you can follow where the key is all stored and used. To be super safe between uses
you should delete or regenerate keys between uses to limit the possibility of API keys being leaked.
WARNING! Be sure to fully read the terms of service and understand the billing criteria.
Any Google Places API data CANNOT be stored or cached other than the places ID. Emails are obtained through scrapping
and are thus not subjected to the Googles terms of service. Google Places API request also can invoke monetray costs
if used beyond the free tier. Understand and monitor your account usage to avoid large bills.
https://cloud.google.com/maps-platform/terms/
In order to display the map, an API key is required from Mapbox which can be found here https://docs.mapbox.com/api/accounts/tokens/ and be sure to read their terms of service https://www.mapbox.com/legal/tos. After adding your Google API key, another screen will ask for your Mapbox API key. Paste it into the text field and click | save. Keys will be stored in ./.secrets/mapboxkey
On the map, right click to place a map marker where you would like to begin a search.
Right click again to create a search area.
Click "Add Section" to add the current section to the search area. Left click on the map marker to delete the marker and try again if the section needs to be adjusted. More sections can be added after clicking "Add Section" as shown below.
When all the sections have been added, enter the search radius (meters) that the area will be broken up into. Then click "Calculate Search Points". The app doesn't not search past one page of results, so if a more refined search is needed, reduce the search radius to limit results to one page.
Once the search points have been calculated enter the file name for results to be saved. The search term can be left blank to search for everything or a term can be added to search with.
Then click "Start Search" which will launch a pop up that will display the search progress.
Once the search has finished (or canceled) the result file will be saved into a csv file with the place id and email address.
Toggle light or dark mode. Some GUI widgets get stuck when toggle switching. Restarting the app fixes the issue.
API keys can be updated/changed by clicking on the pencil
You can clear the Google Places ID. By default every search saves the Places ID into a cache file to skip over them on subsequent searches.
I wrote this App in two days. There's probably bugs... It works okayish for me but I'm sure issues will arise with more use.