# japanese-address-parser-py
A Python toolkit for processing Japanese addresses
[](https://pypi.org/project/japanese-address-parser-py/)
[](https://pypi.org/project/japanese-address-parser-py/#history)
[](https://github.com/YuukiToriyama/japanese-address-parser/actions/workflows/run-test.yaml)
## What is it?
**japanese-address-parser-py** is a Python package for parsing Japanese addresses.
Any address can be parsed into structured data.
## Installation from PyPI
```bash
pip install japanese-address-parser-py
```
## Usage
```python
from japanese_address_parser_py import Parser
address_list = [
"埼玉県さいたま市浦和区高砂3-15-1",
"千葉県千葉市中央区市場町1-1",
"東京都新宿区西新宿2-8-1",
"神奈川県横浜市中区日本大通1"
]
parser = Parser()
for address in address_list:
parse_result = parser.parse(address)
print(parse_result.address)
```
```text
{'prefecture': '埼玉県', 'town': '高砂三丁目', 'rest': '15-1', 'city': 'さいたま市浦和区'}
{'rest': '1-1', 'town': '市場町', 'prefecture': '千葉県', 'city': '千葉市中央区'}
{'prefecture': '東京都', 'rest': '8-1', 'town': '西新宿二丁目', 'city': '新宿区'}
{'town': '日本大通', 'city': '横浜市中区', 'prefecture': '神奈川県', 'rest': '1'}
```
```python
from japanese_address_parser_py import Parser
parser = Parser()
address = "神奈川県横浜市中区本町6丁目50-10"
parse_result = parser.parse(address)
print(parse_result.address["prefecture"])
print(parse_result.address["city"])
print(parse_result.address["town"])
print(parse_result.address["rest"])
```
```text
神奈川県
横浜市中区
本町六丁目
50-10
```
## Development
This library is written in Rust. You need to set up a Rust development environment to build this library.
Also, you need to install `maturin` as this library uses it in order to generate Python bindings.
```bash
# Install maturin
cargo install --locked maturin
# Clone repository
git clone https://github.com/YuukiToriyama/japanese-address-parser.git
# Build python module
cd japanse-address-parser/python
maturin build --release --out dist --find-interpreter
# Install the built library
python3 -m venv .venv
pip3 install dist/japanese_address_parser_py-[version]-cp37-abi3-[arch].whl
```
## Support
This software is maintained by [YuukiToriyama](https://github.com/yuukitoriyama).
If you have any questions, please create a new issue.
## Where to get source code
The source code is hosted on GitHub at:
https://github.com/YuukiToriyama/japanese-address-parser
## Acknowledgements
This software was inspired
by [@geolonia/normalize-japanese-addresses](https://github.com/geolonia/normalize-japanese-addresses).
In addition, the parsing process uses [Geolonia 住所データ](https://github.com/geolonia/japanese-addresses) which is
provided by [株式会社Geolonia](https://www.geolonia.com/company/).
## License
This crate is distributed under the terms of the MIT license.
Raw data
{
"_id": null,
"home_page": null,
"name": "japanese-address-parser-py",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "converter, utility, geo, rust",
"author": "Yuuki Toriyama <github@toriyama.dev>",
"author_email": "Yuuki Toriyama <github@toriyama.dev>",
"download_url": "https://files.pythonhosted.org/packages/5a/48/5a30efb29df6412a2f0a34d8f7f649d83cbcb6c9b82a4a6a5a2702ac9557/japanese_address_parser_py-0.2.7.tar.gz",
"platform": null,
"description": "# japanese-address-parser-py\n\nA Python toolkit for processing Japanese addresses\n\n[](https://pypi.org/project/japanese-address-parser-py/)\n[](https://pypi.org/project/japanese-address-parser-py/#history)\n[](https://github.com/YuukiToriyama/japanese-address-parser/actions/workflows/run-test.yaml)\n\n## What is it?\n\n**japanese-address-parser-py** is a Python package for parsing Japanese addresses.\nAny address can be parsed into structured data.\n\n## Installation from PyPI\n\n```bash\npip install japanese-address-parser-py\n```\n\n## Usage\n\n```python\nfrom japanese_address_parser_py import Parser\n\naddress_list = [\n \"\u57fc\u7389\u770c\u3055\u3044\u305f\u307e\u5e02\u6d66\u548c\u533a\u9ad8\u78023-15-1\",\n \"\u5343\u8449\u770c\u5343\u8449\u5e02\u4e2d\u592e\u533a\u5e02\u5834\u753a1-1\",\n \"\u6771\u4eac\u90fd\u65b0\u5bbf\u533a\u897f\u65b0\u5bbf2-8-1\",\n \"\u795e\u5948\u5ddd\u770c\u6a2a\u6d5c\u5e02\u4e2d\u533a\u65e5\u672c\u5927\u901a1\"\n]\nparser = Parser()\nfor address in address_list:\n parse_result = parser.parse(address)\n print(parse_result.address)\n```\n\n```text\n{'prefecture': '\u57fc\u7389\u770c', 'town': '\u9ad8\u7802\u4e09\u4e01\u76ee', 'rest': '15-1', 'city': '\u3055\u3044\u305f\u307e\u5e02\u6d66\u548c\u533a'}\n{'rest': '1-1', 'town': '\u5e02\u5834\u753a', 'prefecture': '\u5343\u8449\u770c', 'city': '\u5343\u8449\u5e02\u4e2d\u592e\u533a'}\n{'prefecture': '\u6771\u4eac\u90fd', 'rest': '8-1', 'town': '\u897f\u65b0\u5bbf\u4e8c\u4e01\u76ee', 'city': '\u65b0\u5bbf\u533a'}\n{'town': '\u65e5\u672c\u5927\u901a', 'city': '\u6a2a\u6d5c\u5e02\u4e2d\u533a', 'prefecture': '\u795e\u5948\u5ddd\u770c', 'rest': '1'}\n```\n\n```python\nfrom japanese_address_parser_py import Parser\n\nparser = Parser()\naddress = \"\u795e\u5948\u5ddd\u770c\u6a2a\u6d5c\u5e02\u4e2d\u533a\u672c\u753a6\u4e01\u76ee50-10\"\nparse_result = parser.parse(address)\nprint(parse_result.address[\"prefecture\"])\nprint(parse_result.address[\"city\"])\nprint(parse_result.address[\"town\"])\nprint(parse_result.address[\"rest\"])\n```\n\n```text\n\u795e\u5948\u5ddd\u770c\n\u6a2a\u6d5c\u5e02\u4e2d\u533a\n\u672c\u753a\u516d\u4e01\u76ee\n50-10\n```\n\n## Development\n\nThis library is written in Rust. You need to set up a Rust development environment to build this library.\nAlso, you need to install `maturin` as this library uses it in order to generate Python bindings.\n\n```bash\n# Install maturin\ncargo install --locked maturin\n# Clone repository\ngit clone https://github.com/YuukiToriyama/japanese-address-parser.git\n# Build python module\ncd japanse-address-parser/python\nmaturin build --release --out dist --find-interpreter\n# Install the built library\npython3 -m venv .venv\npip3 install dist/japanese_address_parser_py-[version]-cp37-abi3-[arch].whl\n```\n\n## Support\n\nThis software is maintained by [YuukiToriyama](https://github.com/yuukitoriyama).\nIf you have any questions, please create a new issue.\n\n## Where to get source code\n\nThe source code is hosted on GitHub at:\nhttps://github.com/YuukiToriyama/japanese-address-parser\n\n## Acknowledgements\n\nThis software was inspired\nby [@geolonia/normalize-japanese-addresses](https://github.com/geolonia/normalize-japanese-addresses). \nIn addition, the parsing process uses [Geolonia \u4f4f\u6240\u30c7\u30fc\u30bf](https://github.com/geolonia/japanese-addresses) which is\nprovided by [\u682a\u5f0f\u4f1a\u793eGeolonia](https://www.geolonia.com/company/).\n\n## License\n\nThis crate is distributed under the terms of the MIT license.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A library for processing addresses of Japan",
"version": "0.2.7",
"project_urls": {
"Source Code": "https://github.com/YuukiToriyama/japanese-address-parser"
},
"split_keywords": [
"converter",
" utility",
" geo",
" rust"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a269d82e13d26c4ff34a22b48e182f42f0db4cf6d53f69450490610d0aef270f",
"md5": "1b97ba0d3897b50cacac513485494fdb",
"sha256": "970c8c8de1a4d5c1be5dba1c423fdcbd590a80804add89b0ac812c203e46eb31"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-macosx_10_12_x86_64.whl",
"has_sig": false,
"md5_digest": "1b97ba0d3897b50cacac513485494fdb",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 2134961,
"upload_time": "2025-08-10T04:33:01",
"upload_time_iso_8601": "2025-08-10T04:33:01.690443Z",
"url": "https://files.pythonhosted.org/packages/a2/69/d82e13d26c4ff34a22b48e182f42f0db4cf6d53f69450490610d0aef270f/japanese_address_parser_py-0.2.7-cp37-abi3-macosx_10_12_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "988be4e58844734da05e56f601475ba981d0d110a186a050d7778c88530926d7",
"md5": "1c40d3882c98eebe2bb34cc1a185eb89",
"sha256": "8bca8bb58380e6f05ef754ea97824cb22563baf222abdfe658ad120c8fbebff5"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "1c40d3882c98eebe2bb34cc1a185eb89",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 2048629,
"upload_time": "2025-08-10T04:33:00",
"upload_time_iso_8601": "2025-08-10T04:33:00.307781Z",
"url": "https://files.pythonhosted.org/packages/98/8b/e4e58844734da05e56f601475ba981d0d110a186a050d7778c88530926d7/japanese_address_parser_py-0.2.7-cp37-abi3-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b52831282e877ffabc7cfa7353b7f35f3145f53fc40910031a77de9b347cb5fa",
"md5": "21ada346413103a2687ad762a1ef8ac4",
"sha256": "7e63b1c074e7a80cb64c7310df4477e0a715b875eff2d2291dc3f0bd76a00055"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "21ada346413103a2687ad762a1ef8ac4",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 1861870,
"upload_time": "2025-08-10T04:32:51",
"upload_time_iso_8601": "2025-08-10T04:32:51.814673Z",
"url": "https://files.pythonhosted.org/packages/b5/28/31282e877ffabc7cfa7353b7f35f3145f53fc40910031a77de9b347cb5fa/japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b6176a0fa0c5e48c239fcee79061993fd3eafe340c6fbd82272e0a49aa74b115",
"md5": "32a8ac30def8be38906157e1646c0fe2",
"sha256": "069827856f94cecd7a8f5b0ab0395106bf2686ff483855bcfedd827dbf991059"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl",
"has_sig": false,
"md5_digest": "32a8ac30def8be38906157e1646c0fe2",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 1656025,
"upload_time": "2025-08-10T04:32:53",
"upload_time_iso_8601": "2025-08-10T04:32:53.665090Z",
"url": "https://files.pythonhosted.org/packages/b6/17/6a0fa0c5e48c239fcee79061993fd3eafe340c6fbd82272e0a49aa74b115/japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a9f111941f5b7109e51dedbc0ee30901fbdc4aac828754170cb5ec8ffb4b33c7",
"md5": "da6dfd0281e7768c824595ff51a821b1",
"sha256": "535b9901f6f99974ba62bfd5bbc1f4d6129a40cd3f11ea7c67f98059dc4b06e8"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_i686.manylinux2014_i686.whl",
"has_sig": false,
"md5_digest": "da6dfd0281e7768c824595ff51a821b1",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 1974725,
"upload_time": "2025-08-10T04:32:57",
"upload_time_iso_8601": "2025-08-10T04:32:57.613163Z",
"url": "https://files.pythonhosted.org/packages/a9/f1/11941f5b7109e51dedbc0ee30901fbdc4aac828754170cb5ec8ffb4b33c7/japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_i686.manylinux2014_i686.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f88264dbc0aed46c44ddb5d1a2aa9b808035edd5805203c34b975d0dfaa981fc",
"md5": "5121bb5fea1a7f2adc98f3355685af33",
"sha256": "35e79ca237e1faa8caf94a6c9bca598e58ed7bd164ae4f684073e352a3a4e815"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl",
"has_sig": false,
"md5_digest": "5121bb5fea1a7f2adc98f3355685af33",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 2169691,
"upload_time": "2025-08-10T04:32:54",
"upload_time_iso_8601": "2025-08-10T04:32:54.822549Z",
"url": "https://files.pythonhosted.org/packages/f8/82/64dbc0aed46c44ddb5d1a2aa9b808035edd5805203c34b975d0dfaa981fc/japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e9393828e778d250fb3a9aca0bba31b43d2315fbeb49eb01e46373edf2118dfc",
"md5": "4d8abdb89c8f25c3927a946897895279",
"sha256": "92815f2c7c957b0d464420eb90474d3d2f94eba05f4c3a5518458971ce2cccf7"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl",
"has_sig": false,
"md5_digest": "4d8abdb89c8f25c3927a946897895279",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 2215239,
"upload_time": "2025-08-10T04:32:56",
"upload_time_iso_8601": "2025-08-10T04:32:56.273765Z",
"url": "https://files.pythonhosted.org/packages/e9/39/3828e778d250fb3a9aca0bba31b43d2315fbeb49eb01e46373edf2118dfc/japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8cdc796123e0fe0ca86eb3b50265c07749414093d22794265f9cde5caeb3e44f",
"md5": "56c4d6dbe0d100c38adf0a69dd010068",
"sha256": "c9c2cd64f3823404cb26585020ac21d0986db3dffa37c52f6d32848e18ce4b9a"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "56c4d6dbe0d100c38adf0a69dd010068",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 2000025,
"upload_time": "2025-08-10T04:32:59",
"upload_time_iso_8601": "2025-08-10T04:32:59.183376Z",
"url": "https://files.pythonhosted.org/packages/8c/dc/796123e0fe0ca86eb3b50265c07749414093d22794265f9cde5caeb3e44f/japanese_address_parser_py-0.2.7-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "da0d1d7d4a34e817017944a5e986bad86156bcb8b413350fec6b0724303ecfa1",
"md5": "36fdf256b05c6e8f9070598cf02f7416",
"sha256": "669a5c7aa4b9a94b2181a2d597992108e450dbfb1df628256611b536eee48abe"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-win32.whl",
"has_sig": false,
"md5_digest": "36fdf256b05c6e8f9070598cf02f7416",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 1570816,
"upload_time": "2025-08-10T04:33:05",
"upload_time_iso_8601": "2025-08-10T04:33:05.486807Z",
"url": "https://files.pythonhosted.org/packages/da/0d/1d7d4a34e817017944a5e986bad86156bcb8b413350fec6b0724303ecfa1/japanese_address_parser_py-0.2.7-cp37-abi3-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "17a557056ef057bdf087f8a62d7e210c36c18b364f1d45729f31cc18c47d882e",
"md5": "9dd50fa9dad82d63a050e6e5f6b2e274",
"sha256": "93aacd7b033fed701857a6b5e5ea588bfda08656e24ac303c07f6dc1843e7ce2"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7-cp37-abi3-win_amd64.whl",
"has_sig": false,
"md5_digest": "9dd50fa9dad82d63a050e6e5f6b2e274",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 1858193,
"upload_time": "2025-08-10T04:33:03",
"upload_time_iso_8601": "2025-08-10T04:33:03.945448Z",
"url": "https://files.pythonhosted.org/packages/17/a5/57056ef057bdf087f8a62d7e210c36c18b364f1d45729f31cc18c47d882e/japanese_address_parser_py-0.2.7-cp37-abi3-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5a485a30efb29df6412a2f0a34d8f7f649d83cbcb6c9b82a4a6a5a2702ac9557",
"md5": "b83a91172d30baa163d046f8ce6d8f37",
"sha256": "d8bdaf872d15dc9cea66dcace14e45eb5333ac94da56d738dd319cc4930c32ee"
},
"downloads": -1,
"filename": "japanese_address_parser_py-0.2.7.tar.gz",
"has_sig": false,
"md5_digest": "b83a91172d30baa163d046f8ce6d8f37",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 47949,
"upload_time": "2025-08-10T04:33:02",
"upload_time_iso_8601": "2025-08-10T04:33:02.925403Z",
"url": "https://files.pythonhosted.org/packages/5a/48/5a30efb29df6412a2f0a34d8f7f649d83cbcb6c9b82a4a6a5a2702ac9557/japanese_address_parser_py-0.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-10 04:33:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "YuukiToriyama",
"github_project": "japanese-address-parser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "japanese-address-parser-py"
}
JSON
