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")
{"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-0.2.3.tar.gz (189.2 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for atlus-0.2.3.tar.gz
Algorithm Hash digest
SHA256 5447f274aa23c0517c9bf1d808fc6466deaea36c361d8d78388c05a8a799743f
MD5 288d5b5c72184f76f810dc4d52b79f07
BLAKE2b-256 7d69d609aa0cca794cf83f388fb020c91ad0479ee5327f7ce4eec37e1c377944

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for atlus-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4c96816213fba9cb37481b307e347346b3c619b435d5ec0bf1f3c56398d4f17b
MD5 1f5aa7dc36629799772e88eb4f60068c
BLAKE2b-256 bc72320c15000a78389674c82a87588239e1205955e740576388c560c9ec812c

See more details on using hashes here.

Supported by

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