https://github.com/ashtonav/addressdata
AddressData.net is a website containing millions of real addresses and maps from 1,500+ cities.
https://github.com/ashtonav/addressdata
address-search addressdata addresses cities city-data crowdsourced-data csv-data data-aggregation data-collection data-mining data-visualization datasette geospatial lat-long maps openstreetmap overpass-turbo world-cities-csv world-cities-database
Last synced: 15 days ago
JSON representation
AddressData.net is a website containing millions of real addresses and maps from 1,500+ cities.
- Host: GitHub
- URL: https://github.com/ashtonav/addressdata
- Owner: ashtonav
- License: mit
- Created: 2025-02-21T17:38:53.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-09-16T03:44:15.000Z (21 days ago)
- Last Synced: 2025-09-16T04:23:15.627Z (21 days ago)
- Topics: address-search, addressdata, addresses, cities, city-data, crowdsourced-data, csv-data, data-aggregation, data-collection, data-mining, data-visualization, datasette, geospatial, lat-long, maps, openstreetmap, overpass-turbo, world-cities-csv, world-cities-database
- Language: C#
- Homepage: https://addressdata.net
- Size: 47.9 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AddressData
[](https://codecov.io/gh/ashtonav/addressdata)
[](https://github.com/ashtonav/addressdata/actions/workflows/dotnet.yml)
[](LICENSE)
AddressData is a tool that collects addresses from real cities around the world, along with their latitude and longitude coordinates.
After addresses are collected, they are used by [github.com/ashtonav/addressdata.net](https://github.com/ashtonav/addressdata.net) to power [AddressData.net](https://AddressData.net), a site that displays all known addresses by city, alongside an interactive map.
Currently, [AddressData.net](https://AddressData.net) contains millions of addresses for over 1,500 cities around the world.
## Table of Contents
- [Installation](#installation)
- [Using Visual Studio](#using-visual-studio)
- [Requirements](#requirements)
- [How to Run](#how-to-run)
- [How to Test](#how-to-test)
- [Usage](#usage)
- [Acknowledgments](#acknowledgments)
- [Contributing](#contributing)
- [License](#license)
## Installation
### Using Visual Studio
#### Requirements
- Visual Studio 2022
- With ASP.NET and web development installed from the Visual Studio Installer
- .NET 8 SDK
- Any Operating System
#### How to Run
1. Open the solution in Visual Studio 2022.
2. Build and launch the AddressData.WebApi project.
3. The API can be accessed at [https://localhost:5280](https://localhost:5280).
#### How to Test
1. Open the solution in Visual Studio 2022.
2. Run the tests in Test Explorer.
## Usage
1. **Start the Web API**: Run the `AddressData.WebApi` project.
2. **Seed the Data**:
- Navigate to [https://localhost:5280](https://localhost:5280).
- Make a `POST` request to the `/documents/seed` endpoint.
3. **Monitor Output**:
- After a while, you’ll see a newly created folder structure (in your solution’s output directory) containing country and city CSV files with addresses.
- Note that the *full* seeding process can take up to **1 day** to complete, depending on how many records you are collecting.
- If you’re in a hurry, you can provide a **limit** parameter in your POST request to `/documents/seed` to only generate a smaller subset of data.
## Acknowledgments
- **Overpass Turbo API**:
Addresses are retrieved from [Overpass Turbo](https://overpass-turbo.eu/)—a web-based data mining tool for OpenStreetMap. It provides a powerful query language for extracting location-based data (like street addresses) from the OpenStreetMap database.
## Contributing
Pull requests are accepted.
## License
[MIT](https://choosealicense.com/licenses/mit/)