Atlus
| Atlus | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
 | ||||||||||||||||||||
| Author: | whammo | |||||||||||||||||||
| License: | MIT License | |||||||||||||||||||
| Platform: | Web | |||||||||||||||||||
| Status: | Broken | |||||||||||||||||||
| Website: | https://atlus.dev | |||||||||||||||||||
| Source code: | https://github.com/whubsch/atlus_website | |||||||||||||||||||
| Programming language: | Python | |||||||||||||||||||
|
API to parse US addresses with simple web interface |
||||||||||||||||||||
| ||||||||||||||||||||
Atlus (or atlus.dev) was an API that normalized and split up addresses into various addr:=* fields. It was intended primarily for addresses in the United States but was also able to be used somewhat reliably for addresses in Canada. The application also parsed and formatted United States and Canadian phone numbers (in the format +1 XXX-XXX-XXXX). Feel free to contribute at the repository's GitHub page.
In December 2025, the website stopped working; going to the URL will result in a PR_END_OF_FILE_ERROR error.[1]
Web interface
Users accessed a simple web UI at the site's home page, a good way to quickly get a feel for what types of address and phone strings Atlus could have handled. Users could only process one address at a time using this method. This frontend was written in TypeScript with React.
Once results were displayed, clicking the Copy button put the parsed information into the user's clipboard so that it could easily be pasted into JOSM or the raw tag sections of iD or Rapid.
API
The API, which powers the whole application, is much more powerful and can process up to 10,000 address or phone strings per request from the /batch endpoints. There are rate-limits of 4 requests per second; this should be more than enough for most use cases. This backend is built using Python and FastAPI. The API can be accessed at the API base URL, which will also demonstrate that Atlus is running and the current API version. The auto-generated Swagger UI docs for the API can be viewed at the docs URL.
Python package
The code that powers Atlus is also accessible programmatically as its own Python package. Install using the following command:
pip install atlus
Documentation for the package is available here.
See also
- Addresses
addr:=*- United States OSM community
- overturetoosm Python package