locations

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #machine-learning #deep-learning #linux #windows #awesome #kubernetes #awesome-list #vue #security #mcp #open-source

(★ 30)

An expanding collection of data scrapers designed to gather location details on prominent stores, restaurants and other consumer destinations across the United States.

locations 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![starbucks locations](https://raw.githubusercontent.com/stiles/locations/main/starbucks/visuals/visualization.png)

# Locations
An expanding collection of data scrapers designed to gather location details on prominent stores, restaurants and other consumer destinations **across the United States**.

## Collection summary

### Aggregates

| Company category                  | Companies |    Locations |
| ------------------------- | ----: | -----: |
| Automotive                   |     3 |  2,924 |
| Banking                   |     1 |  6,066 |
| Beauty Products           |     2 |  3,013 |
| Casual Dining             |     4 |  3,567 |
| Clothing & Accessories    |     3 |    620 |
| Coffee Shops & Desserts   |     5 | 22,788 |
| Electronics & Appliances  |     1 |    526 |
| Entertainment  |     2 |    868 |
| Fast Food & Quick Service |    21 | 92,505 |
| Food & Beverage           |     2 |    236 |
| Frozen Yogurt             |     3 |    529 |
| Home Improvement          |     1 |  2,002 |
| Jewelry                   |     1 |    234 |
| Pet Supplies              |     1 |    121 |
| Retail Stores             |    21 | 66,315 |
| Shoes & Accessories       |     1 |    439 |
| Specialty Foods           |     5 |   1856 |
| **Total collected**               |    **77** | **204,639** |

### All the companies

| Company                                                                                   | Category                  | Locations |
| ----------------------------------------------------------------------------------------- | ------------------------- | --------: |
| [7-Eleven](https://github.com/stiles/locations/tree/main/7-eleven)               | Fast Food & Quick Service           |        8,568 |
| [99 Ranch Market](https://github.com/stiles/locations/tree/main/99ranch)               | Specialty Foods           |        62 |
| [99 Cents Only](https://github.com/stiles/locations/tree/main/99-cents-only)               | Retail Stores           |        370 |
| [Abercrombie & Fitch](https://github.com/stiles/locations/tree/main/abercrombie-fitch) | Clothing & Accessories    |       221 |
| [Aldi](https://github.com/stiles/locations/tree/main/aldi)                             | Retail Stores             |     2,362 |
| [AMC theaters](https://github.com/stiles/locations/tree/main/amc-theaters)                             | Entertainment             |     554 |
| [Apple Stores](https://github.com/stiles/locations/tree/main/apple-stores)             | Electronics & Appliances  |       526 |
| [Arby's](https://github.com/stiles/locations/tree/main/arbys)                          | Fast Food & Quick Service |     3,388 |
| [Au Bon Pain](https://github.com/stiles/locations/tree/main/au-bon-pain)               | Food & Beverage           |        71 |
| [Bank of America](https://github.com/stiles/locations/tree/main/bank-of-america)       | Banking                   |     6,066 |
| [Bass Pro/Cabela's](https://github.com/stiles/locations/tree/main/bass-pro-shops)       | Retail Stores                   |     155 |
| [Buc-ee's](https://github.com/stiles/locations/tree/main/buc-ees)                   | Retail Stores |     47 |
| [Carl's Jr.](https://github.com/stiles/locations/tree/main/carls-jr)                   | Fast Food & Quick Service |     1,026 |
| [Chick-Fil-A](https://github.com/stiles/locations/tree/main/chick-fil-a)               | Fast Food & Quick Service |     2,896 |
| [Chili's](https://github.com/stiles/locations/tree/main/chilis)                        | Casual Dining             |     1,229 |
| [Chipotle](https://github.com/stiles/locations/tree/main/chipotle)                     | Fast Food & Quick Service |     3,385 |
| [Cinemark theaters](https://github.com/stiles/locations/tree/main/cinemark)                     | Entertainment |     314 |
| [Costco](https://github.com/stiles/locations/tree/main/costco)                         | Retail Stores             |       588 |
| [California Pizza Kitchen](https://github.com/stiles/locations/tree/main/cpk)          | Casual Dining             |       121 |
| [Cracker Barrel](https://github.com/stiles/locations/tree/main/cracker-barrel)         | Casual Dining             |       662 |
| [Crumbl](https://github.com/stiles/locations/tree/main/crumbl)         | Coffee Shops & Dessert             |       1,717 |
| [Culver's](https://github.com/stiles/locations/tree/main/culvers)           | Fast Food & Quick Service |     794 |
| [CVS](https://github.com/stiles/locations/tree/main/cvs)                               | Retail Stores             |     9,333 |
| [Del Taco](https://github.com/stiles/locations/tree/main/del-taco)                     | Fast Food & Quick Service |       328 |
| [Dollar General](https://github.com/stiles/locations/tree/main/dollar-general)                     | Retail Stores |       19,780 |
| [Dollar Tree](https://github.com/stiles/locations/tree/main/dollar-tree)                     | Retail Stores |       8,159 |
| [DSW](https://github.com/stiles/locations/tree/main/dsw)                               | Shoes & Accessories       |       439 |
| [Dunkin Donuts](https://github.com/stiles/locations/tree/main/dunkin-donuts)           | Fast Food & Quick Service |     9,538 |
| [El Pollo Loco](https://github.com/stiles/locations/tree/main/el-pollo-loco)           | Fast Food & Quick Service |       500 |
| [Family Dollar](https://github.com/stiles/locations/tree/main/family-dollar)                     | Retail Stores |       8,389 |
| [Five Below](https://github.com/stiles/locations/tree/main/five-below)                     | Retail Stores |       1,975 |
| [Ford dealers](https://github.com/stiles/locations/tree/main/ford)           | Automotive |       2,901 |
| [Forever 21](https://github.com/stiles/locations/tree/main/forever-21)                               | Retail Stores             |     380 |
| [Giant Food Stores](https://github.com/stiles/locations/tree/main/giant)               | Food & Beverage           |       165 |
| [Hardee's](https://github.com/stiles/locations/tree/main/hardees)                      | Fast Food & Quick Service |     1,419 |
| [Hmart](https://github.com/stiles/locations/tree/main/hmart)                           | Specialty Foods           |        80 |
| [Hollister](https://github.com/stiles/locations/tree/main/hollister)                   | Clothing & Accessories    |       104 |
| [Home Depot](https://github.com/stiles/locations/tree/main/home-depot)                 | Home Improvement          |     2,002 |
| [Hyundai dealers](https://github.com/stiles/locations/tree/main/hyundai)                 | Automotive          |     833 |
| [In-N-Out Burger](https://github.com/stiles/locations/tree/main/in-n-out)              | Fast Food & Quick Service |       401 |
| [Jared](https://github.com/stiles/locations/tree/main/jared)                           | Jewelry                   |       234 |
| [JCPenney](https://github.com/stiles/locations/tree/main/jcpenney)                     | Retail Stores             |       663 |
| [Kentucky Fried Chicken](https://github.com/stiles/locations/tree/main/kfc)            | Fast Food & Quick Service |     4,276 |
| [King Taco](https://github.com/stiles/locations/tree/main/king-taco)            | Fast Food & Quick Service |     21 |
| [Krispy Kreme](https://github.com/stiles/locations/tree/main/krispy-kreme)             | Coffee Shops & Desserts   |     4,646 |
| [Kroger](https://github.com/stiles/locations/tree/main/kroger)                         | Retail Stores             |     1,244 |
| [Kung Fu Tea](https://github.com/stiles/locations/tree/main/kung-fu-tea)               | Coffee Shops & Desserts   |       425 |
| [Macy's](https://github.com/stiles/locations/tree/main/macys)                          | Retail Stores             |       520 |
| [McDonald's](https://github.com/stiles/locations/tree/main/mcdonalds)                     | Fast Food & Quick Service             |       11,197 |
| [Menchies](https://github.com/stiles/locations/tree/main/menchies)                     | Frozen Yogurt             |       324 |
| [Nike Stores](https://github.com/stiles/locations/tree/main/nike-stores)               | Clothing & Accessories    |       295 |
| [Nordstrom](https://github.com/stiles/locations/tree/main/nordstrom)               | Clothing & Accessories    |       358 |
| [Olive Garden](https://github.com/stiles/locations/tree/main/olive-garden)               | Casual Dining    |       911 |
| [PetSmart](https://github.com/stiles/locations/tree/main/pei-wei)                      | Pet Supplies              |       121 |
| [Pei Wei](https://github.com/stiles/locations/tree/main/petsmart)                      | Specialty Foods           |     1,544 |
| [Pinkberry](https://github.com/stiles/locations/tree/main/pinkberry)                   | Frozen Yogurt             |        70 |
| [Pizza Hut](https://github.com/stiles/locations/tree/main/pizza-hut)                   | Fast Food & Quick Service |     5,204 |
| [Pollo Tropical](https://github.com/stiles/locations/tree/main/pollo-tropical)           | Fast Food & Quick Service |     126 |
| [Publix](https://github.com/stiles/locations/tree/main/publix)                         | Retail Stores             |     1,407 |
| [Red Lobster](https://github.com/stiles/locations/tree/main/red-lobster)                         | Casual Dining             |     671 |
| [Safeway](https://github.com/stiles/locations/tree/main/safeway)                       | Retail Stores             |       865 |
| [Sephora](https://github.com/stiles/locations/tree/main/sephora)                       | Beauty Products           |     1,602 |
| [Sonic](https://github.com/stiles/locations/tree/main/shipley-donuts)                  | Fast Food & Quick Service |     3,529 |
| [Shipley Do-Nuts](https://github.com/stiles/locations/tree/main/sonic)                 | Coffee Shops & Desserts   |       374 |
| [Subway](https://github.com/stiles/locations/tree/main/subway)                 | Fast Food & Quick Service   |       21,229 |
| [Superior Grocers](https://github.com/stiles/locations/tree/main/superior-grocers)                 | Retail Stores   |       73 |
| [Starbucks](https://github.com/stiles/locations/tree/main/starbucks)                   | Coffee Shops & Desserts   |    16,288 |
| [Taco Bell](https://github.com/stiles/locations/tree/main/taco-bell)                   | Fast Food & Quick Service |     7,148 |
| [TCBY](https://github.com/stiles/locations/tree/main/tcby)                             | Frozen Yogurt             |       135 |
| [Torchy's Tacos](https://github.com/stiles/locations/tree/main/torchys-tacos)          | Specialty Foods           |       124 |
| [Trader Joe's](https://github.com/stiles/locations/tree/main/trader-joes)              | Retail Stores             |       558 |
| [Ulta](https://github.com/stiles/locations/tree/main/ulta)                             | Beauty Products           |     1,411 |
| [Vons](https://github.com/stiles/locations/tree/main/vons)                             | Retail Stores             |       186 |
| [Wahoo's](https://github.com/stiles/locations/tree/main/wahoos)                        | Specialty Foods           |        46 |
| [Walgreens](https://github.com/stiles/locations/tree/main/walgreens)                   | Retail Stores             |     8,446 |
| [Wawa](https://github.com/stiles/locations/tree/main/wawa)                   | Retail Stores             |     860 |
| [Wendy's](https://github.com/stiles/locations/tree/main/wendys)                        | Fast Food & Quick Service |     6,150 |
| [Whataburger](https://github.com/stiles/locations/tree/main/whataburger)               | Fast Food & Quick Service |     1,014 |
| [Wienerschnitzel](https://github.com/stiles/locations/tree/main/wienerschnitzel)       | Fast Food & Quick Service |       320 |

---

## Notes

This repository serves as a non-commercial project to practice data scraping skills (though sometimes the data ends up [getting](https://www.cnn.com/2024/05/20/us/red-lobster-locations-closed-open-dg) [published](https://www.cnn.com/2024/03/15/business/family-dollar-closure-city-leaders-reactions/index.html)). The scrapers get location data from the store lookup directories found on each company’s website. While the findings are consistent with public estimates and company disclosures about inventory levels, they likely aren't complete, as locations open and close and some may have been unintentionally missed in the scraping process.

*Please [let me know](mailto:mattstiles@gmail.com) if you have questions or concerns — or if there's a company you'd like to see on this list.*

---

## Use this code

### Prerequisites

Before you begin, ensure you have [`uv`](https://docs.astral.sh/uv/getting-started/installation/) installed on your system. It manages Python versions, the virtual environment and dependencies for this repo.

### Getting started

Follow these steps to prepare your environment:

#### 1. Clone the repo

First, clone this repository to your local machine and navigate into it using your terminal:

```bash
git clone <repository-url>
cd <repository-name>
```

#### 2. Install dependencies

Inside the repository directory, run:

```bash
uv sync
```

This command creates a virtual environment at `.venv` and installs the required dependencies, including [Pandas](https://pandas.pydata.org/), [Geopandas](https://geopandas.org/en/stable/) and others.

### Launching Jupyter Lab

With your environment set up and dependencies installed, you are ready to start working with the notebooks:

```bash
uv run jupyter lab
```

This command launches Jupyter Lab in your browser, where you can open, edit and run the notebooks.

### Scrape away!

Please be mindful of each company's service terms and also polite to its servers.

locations

locations 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

locations

locations 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README