Skip to content

ashtonav/addressdata.net

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AddressData.net

AddressData.net logo

deployment license

This repository contains the source code for AddressData.net — a website that displays street addresses by city alongside an interactive map.

  • Self-hosting: run your own instance; see Installation. A self-hosted instance is functionally identical to the public site.
  • Coverage: millions of addresses across 1,500+ cities worldwide.
  • Baked Data: no external databases or services are required. A read-only SQLite database containing all addresses is bundled inside the Docker image. See: the “Baked Data” architectural pattern.

Screenshots

Screenshot 1

Screenshot 2

Installation

Using Docker (recommended for self-hosting)

  1. From the repository root, build and run the container:

    docker build -t addressdatanet ./src
    docker run -it -p 8001:8001 addressdatanet
  2. The website can be accessed at http://localhost:8001.

Note: The Docker build can take 20 minutes or more to complete.

Acknowledgments

Contributing

Pull requests are accepted.

License

  • Code: MIT.
  • Data: Street-address data retrieved using the AddressData tool includes information from OpenStreetMap. © OpenStreetMap contributors. The data is available under the Open Database License (ODbL) v1.0.