Skip to main content

Translate raw address strings into the OSM tagging scheme.

Project description

Atlus

GitHub License GitHub last commit PyPI - Version Pepy Total Downlods

This Python project translates raw address strings into the OpenStreetMap (OSM) tagging scheme. The package only supports US (and to some extent Canadian) addresses. You can try out the package without installing it at the Atlus website.

[!NOTE] Use of this package does not absolve you from following OSM's import guidelines.

Table of Contents

Features

  • Expand common street and name abbreviations.
  • Parse address parts correctly and reliably.
  • Get rid of address junk that is not needed for OpenStreetMap tagging.
  • Parse US and Canadian phone numbers into the standard format.

Usage

This package is meant to work with GeoJSON files containing raw address data, including those produced by the All the Places project or Overture maps.

pip install atlus
>>> import atlus
>>> atlus.abbrs("St. Francis")
"Saint Francis"
>>> atlus.get_address("789 Oak Dr, Smallville California, 98765")[0]
{"addr:housenumber": "789", "addr:street": "Oak Drive", "addr:city": "Smallville", "addr:state": "CA", "addr:postcode": "98765"}
>>> atlus.get_phone("(202) 900-9019")
"+1-202-900-9019"

Docs

The documentation for our package is available online at our documentation page. We would greatly appreciate your contributions to help improve the auto-generated docs; please submit any updates or corrections via pull requests.

License

This project is licensed under the MIT License. See the LICENSE file for details.

See also

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atlus-1.0.1.tar.gz (15.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

atlus-1.0.1-py3-none-any.whl (11.9 kB view details)

Uploaded Python 3

File details

Details for the file atlus-1.0.1.tar.gz.

File metadata

  • Download URL: atlus-1.0.1.tar.gz
  • Upload date:
  • Size: 15.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for atlus-1.0.1.tar.gz
Algorithm Hash digest
SHA256 d5838452628808c93e5eaed051f5c8f14c6c911c3927ef13f125782266748cd9
MD5 a23557b18bcb4a13ac1a681e09afeca2
BLAKE2b-256 1576df67e361bbe73ab74f5211fd74c106e846366014a79519802f1cd718ef1d

See more details on using hashes here.

File details

Details for the file atlus-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: atlus-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 11.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for atlus-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e629a492ebc1db3a0496b00a62f62cc37bb3d177415b3c7a522311a141ab654f
MD5 4aaceaab6ddf1de371af09fdb785c1e8
BLAKE2b-256 75067f09a2feb2d68935eab52936f50895ab195b22db50d2db1063da17e548f1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page