• If you don't have Python installed, download it from the official website: https://www.python.org/downloads/
  


• During installation, make sure to check "Add Python to PATH" (especially on Windows) for easier command-line access.

• Open your terminal or command prompt.
  


• Run the following command to install the required libraries:

• This script uses Selenium to control a Google Chrome browser. You need the chromedriver executable that matches your installed Google Chrome browser version.
  


• Go to the official Chrome for Testing availability dashboard: https://googlechromelabs.github.io/chrome-for-testing/
  


• Find the chromedriver version that corresponds to your Chrome browser's version. You can check your Chrome version by going to chrome://version/ in your browser.
  


• Download the appropriate chromedriver zip file for your operating system.
  


• Unzip the downloaded file. You will find an executable file named chromedriver.exe (on Windows) or chromedriver (on macOS/Linux).
  


• Keep note of the path to this executable. You will need to provide it in the GUI, or you can place it in a directory that is already in your system's PATH.

• Copy the entire Python code from the "Google Maps Scraper with GUI" Canvas.
  


• Save it to a file named maps_scraper_gui.py (or maps_scraper_gui.pyw on Windows if you want to prevent the console window from appearing).

• Create a simple CSV file (e.g., cities.csv) containing the names of the cities you want to scrape. Each city name should be on a new line in the first column.
  


• Example cities.csv content:

• If you saved it as .pyw, you can usually just double-click the maps_scraper_gui.pyw file.
  


• If you saved it as .py, open Command Prompt or PowerShell, navigate to the directory where you saved the file, and run:

• Open a terminal, navigate to the directory where you saved the file, and run:

• A GUI window titled "Google Maps Scraper" will appear on the left side of your screen.
  


• Keyword: Enter the type of business you want to search for (e.g., "restaurants", "plumbers", "gyms").
  


• City Names CSV File: Click the "Browse" button and select the cities.csv file you created.
  


• Chromedriver Path (optional): If chromedriver is not in your system's PATH, click "Browse" and select the chromedriver executable you downloaded.
  


• Start Scraping: Click this button to begin the scraping process.
  
  1. A Chrome browser window will open on the right side of your screen and start navigating through Google Maps.
     
  
  
  2. The GUI will update with progress (cities scraped), current tasks, and any errors.
  
  
  
  


• Stop Scraping: Click this button to stop the scraping process at any time.
  


• Clear Settings: Clears all input fields and the saved configuration file (scraper_config.json).
  


• Open Scraped Data: Once scraping has started and some data is collected, you can click this button to open the google_maps_scraped_data.csv file in your system's default CSV viewer (e.g., Excel, Google Sheets).

(Jul 14, 2025 03:05 PM)thecodershark Wrote:  You should add a feature for it scrape If it has website or not, or if the business profile is claimed, and how many reviews they have.

(Jul 14, 2025 10:41 PM)Tyr Wrote:  Yo, sick guide man. Very well crafted and can tell that you put a good amount of effort into it.

(Jul 16, 2025 03:57 AM)Hopsin Wrote:  Does this work with Greek characters too?

(Jul 16, 2025 04:10 AM)The Joker Wrote:  If you can send the search keywords, I will check and update!