jageocoder 2.1.2__tar.gz → 2.1.4__tar.gz

{jageocoder-2.1.2 → jageocoder-2.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: jageocoder
-Version: 2.1.2
+Version: 2.1.4
 Summary: A Japanese-address geocoder for Python.
 Home-page: https://github.com/t-sagara/jageocoder/
 License: The MIT License
@@ -18,17 +18,17 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3
-Requires-Dist: Werkzeug (>=2.2.3)
+Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: certifi (>=2023.7.22)
-Requires-Dist: cryptography (>=41.0.4)
+Requires-Dist: cryptography (>=42.0.4)
 Requires-Dist: deprecated (>=1.2.13,<2.0.0)
 Requires-Dist: docopt (>=0.6.2,<0.7.0)
 Requires-Dist: geographiclib (>=2.0,<3.0)
+Requires-Dist: idna (>=3.7)
 Requires-Dist: jaconv (>=0.3.4,<0.4.0)
 Requires-Dist: marisa-trie (>=0.7.8,<0.8.0)
 Requires-Dist: portabletab (>=0.3.3)
-Requires-Dist: pycapnp (>=1.3.0,<2.0.0)
+Requires-Dist: pycapnp
 Requires-Dist: rtree (>=1.0.0,<2.0.0)
 Requires-Dist: tqdm (>=4.00.0,<5.0.0)
 Requires-Dist: urllib3 (>=2.0.6)

{jageocoder-2.1.2 → jageocoder-2.1.4}/jageocoder/__init__.py

@@ -19,7 +19,7 @@ running the following steps.
     >>> jageocoder.searchNode('<Japanese-address>')
 """
 
-__version__ = '2.1.2'  # The package version
+__version__ = '2.1.4'  # The package version
 __dictionary_version__ = '20230927'  # Compatible dictionary version
 __author__ = 'Takeshi Sagara <sagara@info-proto.com>'
 

{jageocoder-2.1.2 → jageocoder-2.1.4}/jageocoder/aza_master.py

@@ -26,80 +26,15 @@ class AzaMaster(BaseTable):
         Standardized names for retrieval
     aza_class: int
         町字区分コード
-        1:大字・町, 2:丁目, 3:小字
-    pref: str
-        都道府県名
-    pref_kana: str
-        都道府県名_カナ
-    pref_eng: str
-        都道府県名_英字
-    county: str
-        郡名
-    county_kana: str
-        郡名_カナ
-    county_eng: str
-        郡名_英字
-    city: str
-        市区町村名
-    city_kana: str
-        市区町村名_カナ
-    city_eng: str
-        市区町村名_英字
-    ward: str
-        政令市区名
-    ward_kana: str
-        政令市区名_カナ
-    ward_eng: str
-        政令市区名_英字
-    oaza: str
-        大字・町名
-    oaza_kana: str
-        大字・町名_カナ
-    oaza_eng: str
-        大字・町名_英字
-    chome: str
-        丁目名
-    chome_kana: str
-        丁目名_カナ
-    chome_num: str
-        丁目名_数字
-    koaza: str
-        小字名
-    koaza_kana: str
-        小字名_カナ
-    koaza_eng: str
-        小字名_英字
+        1:大字・町, 2:丁目, 3:小字, 4:なし, 5:道路方式の道路名
     is_jukyo: bool
         住居表示フラグ
-    jukyo_code: int
-        住居表示方式コード
-        1:街区方式, 2:道路方式, 0:住居表示でない
-    is_oaza_alias: bool
-        大字・町_通称フラグ
-    is_koaza_alias: bool
-        小字_通称フラグ
-    is_oaza_gaiji: bool
-        大字・町_外字フラグ
-    is_koaza_gaiji: bool
-        小字_外字フラグ
-    status: int
-        状態フラグ
-        0:自治体確認待ち, 1:地方自治法の町字に該当, 2:地方自治法の町字に非該当, 3:不明
+        1:住居表示実施, 0:住居表示非実施, 2:実施・非実施区域が併存
     start_count_type: int
         起番フラグ
         1:起番, 2:非起番, 0:登記情報に存在しない
-    valid_from: date
-        効力発生日
-    valid_to: date
-        廃止日
-    reference_code: int
-        原典資料コード
-        1:自治体資料, 11:位置参照情報・自治体資料, 12:位置参照情報・街区レベル,
-        13:位置参照情報・1/2500地形図, 10:位置参照情報・その他資料, 0:その他資料
     postcode: str
         郵便番号（セミコロン区切り）
-    note: str
-        備考
     """
 
     __tablename__ = "aza_master"
@@ -123,44 +58,13 @@ class AzaMaster(BaseTable):
     def from_csvrow(self, row: dict) -> dict:
         names = self.get_names_from_csvrow(row)
         aza_master_row = {
-            "code": row["全国地方公共団体コード"][0:5] + row["町字id"],
+            "code": row["lg_code"][0:5] + row["machiaza_id"],
             "names": json.dumps(names, ensure_ascii=False),
             "namesIndex": self.__class__.standardize_aza_name(names),
-            "azaClass": row.get("町字区分コード"),
-            # "pref": row["都道府県名"],
-            # "pref_kana": row.get("都道府県名_カナ", ""),
-            # "pref_eng": row.get("都道府県名_英字", ""),
-            # "county": row.get("郡名", ""),
-            # "county_kana": row.get("郡名_カナ", ""),
-            # "county_eng": row.get("郡名_英字", ""),
-            # "city": row.get("市区町村名", ""),
-            # "city_kana": row.get("市区町村名_カナ", ""),
-            # "city_eng": row.get("市区町村名_英字", ""),
-            # "ward": row.get("政令市区名", ""),
-            # "ward_kana": row.get("政令市区名_カナ", ""),
-            # "ward_eng": row.get("政令市区名_英字", ""),
-            # "oaza": row.get("大字・町名", ""),
-            # "oaza_kana": row.get("大字・町名_カナ", ""),
-            # "oaza_eng": row.get("大字・町名_英字", ""),
-            # "chome": row.get("丁目名", ""),
-            # "chome_kana": row.get("丁目名_カナ", ""),
-            # "chome_num": row.get("丁目名_数字", ""),
-            # "koaza": row.get("小字名", ""),
-            # "koaza_kana": row.get("小字名_カナ", ""),
-            # "koaza_eng": row.get("小字名_英字", ""),
-            "isJukyo": row.get("住居表示フラグ", "") == "1",
-            # "jukyo_code": row.get("住居表示方式コード"),
-            # "is_oaza_alias": row.get("大字・町_通称フラグ", "") == "1",
-            # "is_koaza_alias": row.get("小字_通称フラグ", "") == "1",
-            # "is_oaza_gaiji": row.get("大字・町_外字フラグ", "") == "1",
-            # "is_koaza_gaiji": row.get("小字_外字フラグ", "") == "1",
-            # "status": row.get("状態フラグ"),
-            "startCountType": row.get("起番フラグ"),
-            # "valid_from": row.get("効力発生日"),
-            # "valid_to": row.get("廃止日"),
-            # "reference_code": row.get("原典資料コード"),
-            "postcode": row.get("郵便番号"),
-            # "note": row.get("備考"),
+            "azaClass": row.get("machiaza_type"),
+            "isJukyo": row.get("rsdt_addr_flg", "") == "1",
+            "startCountType": row.get("wake_num_flg"),
+            "postcode": row.get("post_code"),
         }
         for key in ("azaClass", "jukyoCode", "status",
                     "startCountType", "referenceCode",):
@@ -187,75 +91,75 @@ class AzaMaster(BaseTable):
         return aza_master_row
 
     def get_names_from_csvrow(self, row: dict) -> list:
-        code = row["全国地方公共団体コード"][0:5] + row["町字id"]
+        code = row["lg_code"][0:5] + row["machiaza_id"]
         names = []
-        pref = row['都道府県名']
+        pref = row["pref"]
         if pref:
             names.append([
                 AddressLevel.PREF,
                 pref,
-                row['都道府県名_カナ'],
-                row['都道府県名_英字'],
+                row["pref_kana"],
+                row["pref_roma"],
                 code[0:2]])
 
-        county = row['郡名']
+        county = row["county"]
         if county:
             names.append([
                 AddressLevel.COUNTY,
                 county,
-                row['郡名_カナ'],
-                row['郡名_英字'],
+                row["county_kana"],
+                row["county_roma"],
                 code[0:3]])
 
-        city = row['市区町村名']
-        ward = row['政令市区名']
+        city = row["city"]
+        ward = row["ward"]
         if ward:
             names.append([
                 AddressLevel.CITY,
                 city,
-                row['市区町村名_カナ'],
-                row['市区町村名_英字'],
+                row["city_kana"],
+                row["city_roma"],
                 code[0:3]])
 
             names.append([
                 AddressLevel.WARD,
                 ward,
-                row['政令市区名_カナ'],
-                row['政令市区名_英字'],
+                row["ward_kana"],
+                row["ward_roma"],
                 code[0:5]])
         else:
             names.append([
                 AddressLevel.CITY,
                 city,
-                row['市区町村名_カナ'],
-                row['市区町村名_英字'],
+                row["city_kana"],
+                row["city_roma"],
                 code[0:5]])
 
-        oaza = row['大字・町名']
+        oaza = row["oaza_cho"]
         if oaza:
             names.append([
                 AddressLevel.OAZA,
                 oaza,
-                row['大字・町名_カナ'],
-                row['大字・町名_英字'],
+                row["oaza_cho_kana"],
+                row["oaza_cho_roma"],
                 code[0:9]])
 
-        chome = row['丁目名']
+        chome = row["chome"]
         if chome:
             names.append([
                 AddressLevel.AZA,
                 chome,
-                row['丁目名_カナ'],
-                row['丁目名_数字'] + 'chome',
+                row["chome_kana"],
+                row["chome_number"] + 'chome',
                 code])
 
-        aza = row['小字名']
+        aza = row["koaza"]
         if aza:
             names.append([
                 AddressLevel.AZA,
                 aza,
-                row['小字名_カナ'],
-                row['小字名_英字'],
+                row["koaza_kana"],
+                row["koaza_roma"],
                 code])
 
         return names

{jageocoder-2.1.2 → jageocoder-2.1.4}/jageocoder/itaiji.py

@@ -122,11 +122,11 @@ class Converter(object):
         # Patterns that cannot be omitted as AZA names
         hyphens = re.escape(strlib.hyphen)
         self.re_not_ommisible_aza_patterns = re.compile(
-            '(' +
+            r'([^。、，．0-9a-zA-Z\t\n\r\f\v]{,15}?)(' +
             rf'{numbers}[条線丁区番号{hyphens}]|' +
             rf'[{self.chiban_heads}]{numbers}|' +
             rf'{numbers}$' +
-            ')'
+            r')'
         )
 
         # Patterns that do not follow behind nodes at that level
@@ -475,11 +475,12 @@ class Converter(object):
         int
             Number of characters that can be omitted.
         """
-        m = self.re_not_ommisible_aza_patterns.search(string[pos:])
+        m = self.re_not_ommisible_aza_patterns.match(string[pos:])
         if m is None:
             return 0
 
-        n = string[pos:].find(m.group(0))
+        n = len(m.group(1))
+        # n = string[pos:].find(m.group(0))
         return n
 
         candidates = []

{jageocoder-2.1.2 → jageocoder-2.1.4}/jageocoder/node.py

@@ -507,12 +507,12 @@ class AddressNode(object):
         return new_node
 
     def search_child_with_criteria(
-            self,
-            pattern: str,
-            min_candidate: Optional[str] = None,
-            gt_candidate: Optional[str] = None,
-            max_level: Optional[int] = None,
-            require_coordinates: bool = False) -> List[AddressNode]:
+        self,
+        pattern: str,
+        min_candidate: Optional[str] = None,
+        gt_candidate: Optional[str] = None,
+        max_level: Optional[int] = None,
+    ) -> List[AddressNode]:
         """
         Search for children nodes that satisfy the specified conditions.
 
@@ -528,8 +528,6 @@ class AddressNode(object):
             that satisfies the condition as the name of a child node.
         max_level: int, optional
             Maximum level of child nodes; unlimited if None.
-        require_coordinates: bool [False]
-            If set to True, the child node must have valid coordinates.
 
         Returns
         -------
@@ -537,8 +535,7 @@ class AddressNode(object):
             A list of all child nodes that satisfy the specified condition.
         """
         logger.debug((
-            "Called with self:'{}'({}), pattern:{}, min:'{}', gt:'{}', "
-            "max_level: {}, require_coordinates: {}."
+            "Called with self:'{}'({}), pattern:{}, min:'{}', gt:'{}', max_level: {}."
         ).format(
             self.name,
             self.id,
@@ -546,7 +543,6 @@ class AddressNode(object):
             min_candidate,
             gt_candidate,
             max_level,
-            require_coordinates
         ))
         re_pattern = re.compile(pattern)
         address_node = self.table.get_record(pos=self.id)
@@ -598,12 +594,10 @@ class AddressNode(object):
 
             if re_pattern.match(candidate.name_index) and \
                     (max_level is None or candidate.level <= max_level):
-                if require_coordinates is False or candidate.y <= 90.0:
-                    children.append(candidate)
-                else:
+                if candidate.y > 90.0:
                     candidate = candidate.add_dummy_coordinates()
-                    if candidate.y <= 90.0:
-                        children.append(candidate)
+
+                children.append(candidate)
 
             next_pos = candidate.sibling_id
 
@@ -686,7 +680,7 @@ class AddressNode(object):
             min_candidate=min_candidate,
             gt_candidate=gt_candidate,
             max_level=max_level,
-            require_coordinates=tree.get_config('require_coordinates'))
+        )
 
         # Check if the index begins with an extra character of
         # the current node.
@@ -702,12 +696,17 @@ class AddressNode(object):
             if len(candidates) > 0:
                 new_candidates = []
                 for candidate in candidates:
+                    if candidate.node.id == self.id:
+                        new_candidates.append(candidate)
+                        continue
+
                     new_candidate = Result(
                         candidate.node,
                         index[0] + candidate.matched,
                         l_optional_prefix + candidate.nchars)
                     new_candidates.append(new_candidate)
 
+                new_candidates.append(Result(self, "", 0))
                 return new_candidates
 
             return []
@@ -738,6 +737,7 @@ class AddressNode(object):
 
             if len(new_candidates) > 0:
                 candidates += new_candidates
+                candidates.append(Result(self, "", 0))
 
         # Processes the region's own rules.
         parent_node = self.get_parent()
@@ -757,10 +757,11 @@ class AddressNode(object):
                     "child:{} match {} chars".format(child, offset))
                 processed_nodes.add(child.id)
                 logger.debug(f"{child.name}({child.id}) marked as processed")
-                for cand in child.search_recursive(
-                        tree=tree,
-                        index=rest_index,
-                        processed_nodes=processed_nodes):
+                new_candidates = child.search_recursive(
+                    tree=tree,
+                    index=rest_index,
+                    processed_nodes=processed_nodes)
+                for cand in new_candidates:
                     candidates.append(Result(
                         cand[0],
                         optional_prefix +
@@ -768,12 +769,15 @@ class AddressNode(object):
                         l_optional_prefix +
                         len(child.name_index) + len(cand[1])))
 
-        if len(candidates) == 0:
-            candidates += self.check_redirect(
-                tree, index, processed_nodes
-            )
+                if len(new_candidates) > 0:
+                    candidates.append(Result(self, "", 0))
 
-        # Search for subnodes with queries excludes Aza-name candidates
+        # Search for nodes with possible address changes.
+        candidates += self.check_redirect(
+            tree, index, processed_nodes
+        )
+
+        # Search for subnodes with queries excludes Aza-name candidates.
         omissible_index = None
         aza_skip = tree.get_config('aza_skip')
         if len(candidates) == 0 or \
@@ -818,6 +822,7 @@ class AddressNode(object):
                     processed_nodes=processed_nodes)
                 tree.set_config(aza_skip=aza_skip)
                 if sub_candidates[0].matched != '':
+                    added = 0
                     for cand in sub_candidates:
                         if cand.node.level < AddressLevel.BLOCK and \
                                 cand.node.name_index not in \
@@ -831,6 +836,10 @@ class AddressNode(object):
                             optional_prefix +
                             index[0:azalen] + cand.matched,
                             l_optional_prefix + cand.nchars))
+                        added += 1
+
+                    if added > 0:
+                        candidates.append(Result(self, "", 0))
 
         if False and len(candidates) == 0:
             # Search common names
@@ -879,6 +888,7 @@ class AddressNode(object):
         processed_nodes: Set[int]
     ) -> List[Result]:
         auto_redirect = tree.get_config('auto_redirect')
+        require_coordinates = tree.get_config('require_coordinates')
         if auto_redirect is False:
             return []
 
@@ -895,9 +905,12 @@ class AddressNode(object):
                 processed_nodes.add(self.id)
                 logger.debug(
                     f"{self.name}({self.id}) marked as processed")
-                tree.set_config(auto_redirect=False)
+                tree.set_config(auto_redirect=False, require_coordinates=False)
                 redirect_results = tree.search_by_trie(ref)
-                tree.set_config(auto_redirect=auto_redirect)
+                tree.set_config(
+                    auto_redirect=auto_redirect,
+                    require_coordinates=require_coordinates
+                )
                 for node_id, val in redirect_results.items():
                     if node_id in processed_nodes:
                         continue
@@ -1087,6 +1100,7 @@ class AddressNode(object):
 
                         if pos == 0:
                             break
+
         else:  # strict mode
             # Consider omittable only those portions that can be omitted
             # with by Aza-master.

{jageocoder-2.1.2 → jageocoder-2.1.4}/jageocoder/tree.py

@@ -1223,10 +1223,10 @@ class AddressTree(object):
 
                 if node.y > 90.0 and self.get_config('require_coordinates'):
                     node = node.add_dummy_coordinates()
-                    if node.y > 90.0:
-                        logger.debug("Node {}({}) has no coordinates.".format(
-                            node.name, node.id))
-                        continue
+                    # if node.y > 90.0:
+                    #     logger.debug("Node {}({}) has no coordinates.".format(
+                    #         node.name, node.id))
+                    #     continue
 
                 if min_key == '' and node.level <= AddressLevel.WARD:
                     # To make the process quicker, once a node higher
@@ -1315,9 +1315,16 @@ class AddressTree(object):
 
                         if inside != 1:
                             msg = "Node {}({}) is not in the target area."
-                            logger.debug(msg.format(node.name, node.id))
+                            logger.debug(msg.format(
+                                cand.node.name, cand.node.id))
                             continue
 
+                    if self.get_config("require_coordinates") and cand.node.y > 90.0:
+                        logger.debug("Node {}({}) has no coordinates.".format(
+                            cand.node.name, cand.node.id
+                        ))
+                        continue
+
                     _len = offset + cand.nchars
                     _part = offset + len(cand.matched)
                     msg = "candidate: {} ({})"

{jageocoder-2.1.2 → jageocoder-2.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "jageocoder"
-version = "2.1.2"
+version = "2.1.4"
 description = "A Japanese-address geocoder for Python."
 authors = ["Takeshi Sagara <sagara@info-proto.com>"]
 repository = "https://github.com/t-sagara/jageocoder/"
@@ -21,28 +21,31 @@ include = ["itaiji_dic.json", "islands.json"]
 
 [tool.poetry.dependencies]
 python = "^3.7"
-marisa-trie = "^0.7.8"
-jaconv = "^0.3.4"
-docopt = "^0.6.2"
+certifi = ">=2023.7.22"
+cryptography = ">=42.0.4"
 deprecated = "^1.2.13"
-Werkzeug = ">=2.2.3"
-pycapnp = "^1.3.0"
+docopt = "^0.6.2"
+geographiclib = "^2.0"
+idna = ">=3.7"
+jaconv = "^0.3.4"
+marisa-trie = "^0.7.8"
+pycapnp = "*"
 portabletab = ">=0.3.3"
-tqdm = "^4.00.0"
 rtree = "^1.0.0"
-geographiclib = "^2.0"
-certifi = ">=2023.7.22"
-cryptography = ">=41.0.4"
+tqdm = "^4.00.0"
 urllib3 = ">=2.0.6"
 
 [tool.poetry.group.dev.dependencies]
-pytest = "^7.2.1"
-flask = "^2.2.5"
-flask-cors = "^3.0.10"
-sphinx = ">=5.0.0,<6.0.0"
-sphinx-rtd-theme = "^1.2.0"
 twine = "^4.0.2"
 
+
+[tool.poetry.group.doc.dependencies]
+sphinx-rtd-theme = "^1.2.0"
+
+
+[tool.poetry.group.test.dependencies]
+pytest = "^7.2.1"
+
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"

jageocoder-2.1.2/setup.py

@@ -1,46 +0,0 @@
-# -*- coding: utf-8 -*-
-from setuptools import setup
-
-packages = \
-['jageocoder']
-
-package_data = \
-{'': ['*']}
-
-install_requires = \
-['Werkzeug>=2.2.3',
- 'certifi>=2023.7.22',
- 'cryptography>=41.0.4',
- 'deprecated>=1.2.13,<2.0.0',
- 'docopt>=0.6.2,<0.7.0',
- 'geographiclib>=2.0,<3.0',
- 'jaconv>=0.3.4,<0.4.0',
- 'marisa-trie>=0.7.8,<0.8.0',
- 'portabletab>=0.3.3',
- 'pycapnp>=1.3.0,<2.0.0',
- 'rtree>=1.0.0,<2.0.0',
- 'tqdm>=4.00.0,<5.0.0',
- 'urllib3>=2.0.6']
-
-entry_points = \
-{'console_scripts': ['jageocoder = jageocoder.__main__:main']}
-
-setup_kwargs = {
-    'name': 'jageocoder',
-    'version': '2.1.2',
-    'description': 'A Japanese-address geocoder for Python.',
-    'long_description': '# jageocoder - A Python Japanese geocoder\n\n日本語版は README_ja.md をお読みください。\n\nThis is a Python port of the Japanese-address geocoder used in CSIS at the University of Tokyo\'s ["Address Matching Service"](https://newspat.csis.u-tokyo.ac.jp/geocode/modules/addmatch/index.php?content_id=1) and [GSI Maps](https://maps.gsi.go.jp/).\n\n# Getting Started\n\nThis package provides address-geocoding functionality for Python programs. The basic usage is to specify a dictionary with `init()` then call `search()` to get geocoding results.\n\n```python\npython\n>>> import jageocoder\n>>> jageocoder.init()\n>>> jageocoder.search(\'新宿区西新宿2-8-1\')\n{\'matched\': \'新宿区西新宿2-8-\', \'candidates\': [{\'id\': 5961406, \'name\': \'8番\', \'x\': 139.691778, \'y\': 35.689627, \'level\': 7, \'note\': None, \'fullname\': [\'東京都\', \'新宿区\', \'西新宿\', \'二丁目\', \'8番\']}]}\n```\n\n# How to install\n\n## Prerequisites\n\nRequires Python 3.7.x or later.\n\nAll other required packages will be installed automatically.\n\n## Install instructions\n\n- Install the package with `pip install jageocoder`\n- Download an address database file compatible with that version from \n  [here](https://www.info-proto.com/static/jageocoder/latest/v2/)\n- Install the dictionary with `install-dictionary` command\n\n```sh\npip install jageocoder\nwget https://www.info-proto.com/static/jageocoder/latest/v2/jukyo_all_v20.zip\njageocoder install-dictionary jukyo_all_v20.zip\n```\n\nThe dictionary database will be installed under\n`{sys.prefix}/jageocoder/db2/` by default,\nhowever if the user doesn\'t have write permission there,\n`{site.USER_DATA}/jageocoder/db2/` instead.\n\nIf you need to know the location of the dictionary directory,\nperform `get-db-dir` command as follows. (Or call\n`jageocoder.get_db_dir()` in your script)\n\n```sh\njageocoder get-db-dir\n```\n\nIf you prefer to create it in another location, set the environment\nvariable `JAGEOCODER_DB2_DIR` before executing `install_dictionary()`\nto specify the directory.\n\n```sh\nexport JAGEOCODER_DB2_DIR=\'/usr/local/share/jageocoder/db2\'\ninstall-dictionary <db-file>\n```\n\n## Uninstall instructions\n\nRemove the directory containing the database, or perform \n`uninstall-dictionary` command as follows.\n\n```sh\njageocoder uninstall-dictionary\n```\n\nThen, uninstall the package with `pip` command.\n\n```sh\npip uninstall jageocoder\n```\n\n# How to use\n\n## Use from the command line\n\nWe assume that jageocoder will be embedded in applications\nas a library and used by calling the API, but for testing purposes,\nyou can check the geocoding results with the following command.\n\n```sh\njageocoder search 新宿区西新宿２－８－１\n```\n\nYou can check the list of available commands with `--help`.\n\n```sh\njageocoder --help\n```\n\n## Using API\n\nFirst, import jageocoder and initialize it with `init()`.\n\n```\n>>> import jageocoder\n>>> jageocoder.init()\n```\n\n### Search for latitude and longitude by address\n\nUse `search()` to search for the address you want to check the longitude and latitude of.\n\nThe `search()` function returns a dict with `matched` as\nthe matched string and `candidates` as the list of search results.\n(The results are formatted for better viewing)\n\nEach element of `candidates` contains the information of an address node (AddressNode).\n\n```\n>>> jageocoder.search(\'新宿区西新宿２－８－１\')\n{\n  \'matched\': \'新宿区西新宿２－８－\',\n  \'candidates\': [{\n    \'id\': 12299846, \'name\': \'8番\',\n    \'x\': 139.691778, \'y\': 35.689627, \'level\': 7, \'note\': None,\n    \'fullname\': [\'東京都\', \'新宿区\', \'西新宿\', \'二丁目\', \'8番\']\n  }]\n}\n```\n\nThe meaning of the items is as follows\n\n- id: ID in the database\n- name: Address notation\n- x: longitude\n- y: latitude\n- level: Address level (1:Prefecture, 2:County, 3:City and 23 district,\n    4:Ward, 5:Oaza, 6:Aza and Chome, 7:Block, 8:Building)\n- note: Notes such as city codes\n- fullname: List of address notations from the prefecture level to this node\n\n### Search for addresses by longitude and latitude\n\nNote: This method is not available in v2 series.\n\n### Explore the attribute information of an address\n\nUse `searchNode()` to retrieve information about an address.\n\nThis function returns a list of type `jageocoder.result.Result` .\nYou can access the address node from node element of the Result object.\n\n```\n>>> results = jageocoder.searchNode(\'新宿区西新宿２－８－１\')\n>>> len(results)\n1\n>>> results[0].matched\n\'新宿区西新宿２－８－\'\n>>> type(results[0].node)\n<class \'jageocoder.node.AddressNode\'>\n>>> node = results[0].node\n>>> node.get_fullname()\n[\'東京都\', \'新宿区\', \'西新宿\', \'二丁目\', \'8番\']\n```\n\n#### Get GeoJSON representation\n\nYou can use the `as_geojson()` method of the Result and AddressNode\nobjects to obtain the GeoJSON representation.\n\n```\n>>> results[0].as_geojson()\n{\'type\': \'Feature\', \'geometry\': {\'type\': \'Point\', \'coordinates\': [139.691778, 35.689627]}, \'properties\': {\'id\': 12299851, \'name\': \'8番\', \'level\': 7, \'note\': None, \'fullname\': [\'東京都\', \'新宿区\', \'西新宿\', \'二丁目\', \'8番\'], \'matched\': \'新宿区西新宿２－８－\'}}\n>>> results[0].node.as_geojson()\n{\'type\': \'Feature\', \'geometry\': {\'type\': \'Point\', \'coordinates\': [139.691778, 35.689627]}, \'properties\': {\'id\': 12299851, \'name\': \'8番\', \'level\': 7, \'note\': None, \'fullname\': [\'東京都\', \'新宿区\', \'西新宿\', \'二丁目\', \'8番\']}}\n```\n\n#### Get the local government codes\n\nThere are two types of local government codes: JISX0402 (5-digit) and\nLocal Government Code (6-digit).\n\nYou can also obtain the prefecture code JISX0401 (2 digits).\n\n```\n>>> node.get_city_jiscode()  # 5-digit code\n\'13104\'\n>>> node.get_city_local_authority_code() # 6-digit code\n\'131041\'\n>>> node.get_pref_jiscode()  # prefecture code\n\'13\'\n```\n\n#### Get link URLs to maps\n\nGenerate URLs to link to GSI and Google maps.\n\n```\n>>> node.get_gsimap_link()\n\'https://maps.gsi.go.jp/#16/35.689627/139.691778/\'\n>>> node.get_googlemap_link()\n\'https://maps.google.com/maps?q=35.689627,139.691778&z=16\'\n```\n\n#### Traverse the parent node\n\nA "parent node" is a node that represents a level above the address.\nGet the node by attribute `parent`.\n\nNow the `node` points to \'8番\', so the parent node will be \'二丁目\'.\n\n```\n>>> parent = node.parent\n>>> parent.get_fullname()\n[\'東京都\', \'新宿区\', \'西新宿\', \'二丁目\']\n>>> parent.x, parent.y\n(139.691774, 35.68945)\n```\n\n#### Traverse the child nodes\n\nA "child node" is a node that represents a level below the address.\nGet the node by attribute `children`.\n\nThere is one parent node, but there are multiple child nodes.\nThe actual return is a SQL query object, but it can be looped through\nwith an iterator or cast to a list.\n\nNow the `parent` points to \'二丁目\', so the child node will be\nthe block number (○番) contained therein.\n\n```\n>>> parent.children\n<sqlalchemy.orm.dynamic.AppenderQuery object at 0x7fbc08404b38>\n>>> [child.name for child in parent.children]\n[\'10番\', \'11番\', \'1番\', \'2番\', \'3番\', \'4番\', \'5番\', \'6番\', \'7番\', \'8番\', \'9番\']\n```\n\n## Create your own dictionary\n\nConsider using [jageocoder-converter](https://github.com/t-sagara/jageocoder-converter).\n\n## ToDos\n\n- Supporting address changes\n\n    The functionality to handle address changes due to municipal consolidation, etc.\n    has already been implemented in the C++ version, but will be implemented\n    in this package in the future.\n\n## Contributing\n\nAddress notation varies. So suggestions for logic improvements are welcome.\nPlease submit an issue with examples of address notations in use and how they should be parsed.\n\n## Authors\n\n* **Takeshi SAGARA** - [Info-proto Co.,Ltd.](https://www.info-proto.com/)\n\n## License\n\nThis project is licensed under [the MIT License](https://opensource.org/licenses/mit-license.php).\n\nThis is not the scope of the dictionary data license. Please follow the license of the respective dictionary data.\n\n## Acknowledgements\n\nWe would like to thank CSIS for allowing us to provide address matching services\non their institutional website for over 20 years.\n\nWe would also like to thank Professor Asanobu Kitamoto of NII for providing us\nwith a large sample of areas using the older address system and for his many help\nin confirming the results of our analysis.\n',
-    'author': 'Takeshi Sagara',
-    'author_email': 'sagara@info-proto.com',
-    'maintainer': 'None',
-    'maintainer_email': 'None',
-    'url': 'https://github.com/t-sagara/jageocoder/',
-    'packages': packages,
-    'package_data': package_data,
-    'install_requires': install_requires,
-    'entry_points': entry_points,
-    'python_requires': '>=3.7,<4.0',
-}
-
-
-setup(**setup_kwargs)