japanese_address_parser 3.0.2 → 3.0.3

data/js/node_modules/@geolonia/normalize-japanese-addresses/dist/main-node.js

@@ -76,8 +76,9 @@ function __generator(thisArg, body) {
     }
 }
 
+var gh_pages_endpoint = 'https://geolonia.github.io/japanese-addresses/api/ja';
 var currentConfig = {
-    japaneseAddressesApi: 'https://geolonia.github.io/japanese-addresses/api/ja',
+    japaneseAddressesApi: gh_pages_endpoint,
     townCacheSize: 1000,
 };
 
@@ -187,9 +188,11 @@ var cachedPrefecturePatterns = undefined;
 var cachedCityPatterns = {};
 var cachedPrefectures = undefined;
 var cachedTowns = {};
+var cachedGaikuListItem = {};
+var cachedResidentials = {};
 var cachedSameNamedPrefectureCityRegexPatterns = undefined;
 var getPrefectures = function () { return __awaiter(void 0, void 0, void 0, function () {
-    var resp, data;
+    var prefsResp, data;
     return __generator(this, function (_a) {
         switch (_a.label) {
             case 0:
@@ -198,9 +201,9 @@ var getPrefectures = function () { return __awaiter(void 0, void 0, void 0, func
                 }
                 return [4 /*yield*/, __internals.fetch('.json')]; // ja.json
             case 1:
-                resp = _a.sent() // ja.json
+                prefsResp = _a.sent() // ja.json
                 ;
-                return [4 /*yield*/, resp.json()];
+                return [4 /*yield*/, prefsResp.json()];
             case 2:
                 data = (_a.sent());
                 return [2 /*return*/, cachePrefectures(data)];
@@ -241,7 +244,7 @@ var getCityRegexPatterns = function (pref, cities) {
     return patterns;
 };
 var getTowns = function (pref, city) { return __awaiter(void 0, void 0, void 0, function () {
-    var cacheKey, cachedTown, responseTownsResp, towns;
+    var cacheKey, cachedTown, townsResp, towns;
     return __generator(this, function (_a) {
         switch (_a.label) {
             case 0:
@@ -252,14 +255,81 @@ var getTowns = function (pref, city) { return __awaiter(void 0, void 0, void 0,
                 }
                 return [4 /*yield*/, __internals.fetch(['', encodeURI(pref), encodeURI(city) + '.json'].join('/'))];
             case 1:
-                responseTownsResp = _a.sent();
-                return [4 /*yield*/, responseTownsResp.json()];
+                townsResp = _a.sent();
+                return [4 /*yield*/, townsResp.json()];
             case 2:
                 towns = (_a.sent());
                 return [2 /*return*/, (cachedTowns[cacheKey] = towns)];
         }
     });
 }); };
+var getGaikuList = function (pref, city, town) { return __awaiter(void 0, void 0, void 0, function () {
+    var cacheKey, cache, gaikuResp, gaikuListItem;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                cacheKey = pref + "-" + city + "-" + town;
+                cache = cachedGaikuListItem[cacheKey];
+                if (typeof cache !== 'undefined') {
+                    return [2 /*return*/, cache];
+                }
+                return [4 /*yield*/, __internals.fetch(['', encodeURI(pref), encodeURI(city), encodeURI(town + '.json')].join('/'))];
+            case 1:
+                gaikuResp = _b.sent();
+                _b.label = 2;
+            case 2:
+                _b.trys.push([2, 4, , 5]);
+                return [4 /*yield*/, gaikuResp.json()];
+            case 3:
+                gaikuListItem = (_b.sent());
+                return [3 /*break*/, 5];
+            case 4:
+                _b.sent();
+                gaikuListItem = [];
+                return [3 /*break*/, 5];
+            case 5: return [2 /*return*/, (cachedGaikuListItem[cacheKey] = gaikuListItem)];
+        }
+    });
+}); };
+var getResidentials = function (pref, city, town) { return __awaiter(void 0, void 0, void 0, function () {
+    var cacheKey, cache, residentialsResp, residentials;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                cacheKey = pref + "-" + city + "-" + town;
+                cache = cachedResidentials[cacheKey];
+                if (typeof cache !== 'undefined') {
+                    return [2 /*return*/, cache];
+                }
+                return [4 /*yield*/, __internals.fetch([
+                        '',
+                        encodeURI(pref),
+                        encodeURI(city),
+                        encodeURI(town),
+                        encodeURI('住居表示.json'),
+                    ].join('/'))];
+            case 1:
+                residentialsResp = _b.sent();
+                _b.label = 2;
+            case 2:
+                _b.trys.push([2, 4, , 5]);
+                return [4 /*yield*/, residentialsResp.json()];
+            case 3:
+                residentials = (_b.sent());
+                return [3 /*break*/, 5];
+            case 4:
+                _b.sent();
+                residentials = [];
+                return [3 /*break*/, 5];
+            case 5:
+                residentials.sort(function (res1, res2) {
+                    return (res2.gaiku + "-" + res2.jyukyo).length -
+                        (res1.gaiku + "-" + res1.jyukyo).length;
+                });
+                return [2 /*return*/, (cachedResidentials[cacheKey] = residentials)];
+        }
+    });
+}); };
 // 十六町 のように漢数字と町が連結しているか
 var isKanjiNumberFollewedByCho = function (targetTownName) {
     var xCho = targetTownName.match(/.町/g);
@@ -385,8 +455,11 @@ var defaultOption = {
 var __internals = {
     // default fetch
     fetch: function (input) {
-        var fileURL = new URL("" + config$1.japaneseAddressesApi + input);
-        return unfetch__default['default'](fileURL.toString());
+        var url = new URL("" + config$1.japaneseAddressesApi + input).toString();
+        if (config$1.geoloniaApiKey) {
+            url += "?geolonia-api-key=" + config$1.geoloniaApiKey;
+        }
+        return unfetch__default['default'](url);
     },
 };
 var normalizeTownName = function (addr, pref, city) { return __awaiter(void 0, void 0, void 0, function () {
@@ -423,13 +496,66 @@ var normalizeTownName = function (addr, pref, city) { return __awaiter(void 0, v
         }
     });
 }); };
-var normalize$1 = function (address, option) {
-    if (option === void 0) { option = defaultOption; }
+var normalizeResidentialPart = function (addr, pref, city, town) { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, gaikuListItem, residentials, match, gaiku_1, jyukyo, jyukyohyoji_1, residential, addr2, gaikuItem, addr2;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0: return [4 /*yield*/, Promise.all([
+                    getGaikuList(pref, city, town),
+                    getResidentials(pref, city, town),
+                ])
+                // 住居表示未整備
+            ];
+            case 1:
+                _a = _b.sent(), gaikuListItem = _a[0], residentials = _a[1];
+                // 住居表示未整備
+                if (gaikuListItem.length === 0) {
+                    return [2 /*return*/, null];
+                }
+                match = addr.match(/^([1-9][0-9]*)-([1-9][0-9]*)/);
+                if (match) {
+                    gaiku_1 = match[1];
+                    jyukyo = match[2];
+                    jyukyohyoji_1 = gaiku_1 + "-" + jyukyo;
+                    residential = residentials.find(function (res) { return res.gaiku + "-" + res.jyukyo === jyukyohyoji_1; });
+                    if (residential) {
+                        addr2 = addr.replace(jyukyohyoji_1, '').trim();
+                        return [2 /*return*/, {
+                                gaiku: gaiku_1,
+                                jyukyo: jyukyo,
+                                addr: addr2,
+                                lat: residential.lat,
+                                lng: residential.lng,
+                            }];
+                    }
+                    gaikuItem = gaikuListItem.find(function (item) { return item.gaiku === gaiku_1; });
+                    if (gaikuItem) {
+                        addr2 = addr.replace(gaikuItem.gaiku, '').trim();
+                        return [2 /*return*/, { gaiku: gaiku_1, addr: addr2, lat: gaikuItem.lat, lng: gaikuItem.lng }];
+                    }
+                }
+                return [2 /*return*/, null];
+        }
+    });
+}); };
+var normalize$1 = function (address, _option) {
+    if (_option === void 0) { _option = defaultOption; }
     return __awaiter(void 0, void 0, void 0, function () {
-        var addr, pref, city, town, lat, lng, level, prefectures, prefs, prefPatterns, sameNamedPrefectureCityRegexPatterns, i, _a, prefectureCity, reg, match, i, _b, _pref, pattern, match, matched, _pref, cities, cityPatterns, i, _c, _city, pattern, match, i, normalized, cities, cityPatterns, i, _d, _city, pattern, match, normalized;
+        var option, addr, pref, city, town, lat, lng, level, normalized, prefectures, prefs, prefPatterns, sameNamedPrefectureCityRegexPatterns, i, _a, prefectureCity, reg, match, i, _b, _pref, pattern, match, matched, _pref, cities, cityPatterns, i, _c, _city, pattern, match, i, normalized_1, cities, cityPatterns, i, _d, _city, pattern, match, result;
         return __generator(this, function (_e) {
             switch (_e.label) {
                 case 0:
+                    option = __assign(__assign({}, defaultOption), _option);
+                    if (option.geoloniaApiKey || config$1.geoloniaApiKey) {
+                        option.level = 8;
+                        option.geoloniaApiKey && (config$1.geoloniaApiKey = option.geoloniaApiKey);
+                        // API キーがある場合は、 Geolonia SaaS に切り替え。
+                        // ただし、config を書き換えて別のエンドポイントを使うようにカスタマイズしているケースがあるので、その場合は config に既に入っている値を優先
+                        if (config$1.japaneseAddressesApi === gh_pages_endpoint) {
+                            config$1.japaneseAddressesApi =
+                                'https://japanese-addresses.geolonia.com/next/ja';
+                        }
+                    }
                     addr = address
                         .normalize('NFC')
                         .replace(/　/g, ' ')
@@ -444,6 +570,9 @@ var normalize$1 = function (address, option) {
                     })
                         .replace(/(.+)(丁目?|番(町|地|丁)|条|軒|線|(の|ノ)町|地割)/, function (match) {
                         return match.replace(/ /g, ''); // 町丁目名以前のスペースはすべて削除
+                    })
+                        .replace(/(.+)((郡.+(町|村))|((市|巿).+(区|區)))/, function (match) {
+                        return match.replace(/ /g, ''); // 区、郡以前のスペースはすべて削除
                     })
                         .replace(/.+?[0-9一二三四五六七八九〇十百千]-/, function (match) {
                         return match.replace(/ /g, ''); // 1番はじめに出てくるアラビア数字以前のスペースを削除
@@ -454,6 +583,7 @@ var normalize$1 = function (address, option) {
                     lat = null;
                     lng = null;
                     level = 0;
+                    normalized = null;
                     return [4 /*yield*/, getPrefectures()];
                 case 1:
                     prefectures = _e.sent();
@@ -507,8 +637,8 @@ var normalize$1 = function (address, option) {
                     if (!(i < matched.length)) return [3 /*break*/, 6];
                     return [4 /*yield*/, normalizeTownName(matched[i].addr, matched[i].pref, matched[i].city)];
                 case 4:
-                    normalized = _e.sent();
-                    if (normalized) {
+                    normalized_1 = _e.sent();
+                    if (normalized_1) {
                         pref = matched[i].pref;
                     }
                     _e.label = 5;
@@ -544,58 +674,85 @@ var normalize$1 = function (address, option) {
                             lng = null;
                         }
                     }
-                    addr = addr
-                        .replace(/^-/, '')
-                        .replace(/([0-9]+)(丁目)/g, function (match) {
-                        return match.replace(/([0-9]+)/g, function (num) {
-                            return japaneseNumeral.number2kanji(Number(num));
-                        });
-                    })
-                        .replace(/(([0-9〇一二三四五六七八九十百千]+)(番地?)([0-9〇一二三四五六七八九十百千]+)号)\s*(.+)/, '$1 $5')
-                        .replace(/([0-9〇一二三四五六七八九十百千]+)(番地?)([0-9〇一二三四五六七八九十百千]+)号?/, '$1-$3')
-                        .replace(/([0-9〇一二三四五六七八九十百千]+)番地?/, '$1')
-                        .replace(/([0-9〇一二三四五六七八九十百千]+)の/g, '$1-')
-                        .replace(/([0-9〇一二三四五六七八九十百千]+)[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]/g, function (match) {
-                        return kan2num(match).replace(/[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]/g, '-');
-                    })
-                        .replace(/[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]([0-9〇一二三四五六七八九十百千]+)/g, function (match) {
-                        return kan2num(match).replace(/[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]/g, '-');
-                    })
-                        .replace(/([0-9〇一二三四五六七八九十百千]+)-/, function (s) {
-                        // `1-` のようなケース
-                        return kan2num(s);
-                    })
-                        .replace(/-([0-9〇一二三四五六七八九十百千]+)/, function (s) {
-                        // `-1` のようなケース
-                        return kan2num(s);
-                    })
-                        .replace(/-[^0-9]+([0-9〇一二三四五六七八九十百千]+)/, function (s) {
-                        // `-あ1` のようなケース
-                        return kan2num(zen2han(s));
-                    })
-                        .replace(/([0-9〇一二三四五六七八九十百千]+)$/, function (s) {
-                        // `串本町串本１２３４` のようなケース
-                        return kan2num(s);
-                    })
-                        .trim();
+                    // townが取得できた場合にのみ、addrに対する各種の変換処理を行う。
+                    if (town) {
+                        addr = addr
+                            .replace(/^-/, '')
+                            .replace(/([0-9]+)(丁目)/g, function (match) {
+                            return match.replace(/([0-9]+)/g, function (num) {
+                                return japaneseNumeral.number2kanji(Number(num));
+                            });
+                        })
+                            .replace(/(([0-9〇一二三四五六七八九十百千]+)(番地?)([0-9〇一二三四五六七八九十百千]+)号)\s*(.+)/, '$1 $5')
+                            .replace(/([0-9〇一二三四五六七八九十百千]+)(番地?)([0-9〇一二三四五六七八九十百千]+)号?/, '$1-$3')
+                            .replace(/([0-9〇一二三四五六七八九十百千]+)番地?/, '$1')
+                            .replace(/([0-9〇一二三四五六七八九十百千]+)の/g, '$1-')
+                            .replace(/([0-9〇一二三四五六七八九十百千]+)[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]/g, function (match) {
+                            return kan2num(match).replace(/[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]/g, '-');
+                        })
+                            .replace(/[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]([0-9〇一二三四五六七八九十百千]+)/g, function (match) {
+                            return kan2num(match).replace(/[-－﹣−‐⁃‑‒–—﹘―⎯⏤ーｰ─━]/g, '-');
+                        })
+                            .replace(/([0-9〇一二三四五六七八九十百千]+)-/, function (s) {
+                            // `1-` のようなケース
+                            return kan2num(s);
+                        })
+                            .replace(/-([0-9〇一二三四五六七八九十百千]+)/, function (s) {
+                            // `-1` のようなケース
+                            return kan2num(s);
+                        })
+                            .replace(/-[^0-9]+([0-9〇一二三四五六七八九十百千]+)/, function (s) {
+                            // `-あ1` のようなケース
+                            return kan2num(zen2han(s));
+                        })
+                            .replace(/([0-9〇一二三四五六七八九十百千]+)$/, function (s) {
+                            // `串本町串本１２３４` のようなケース
+                            return kan2num(s);
+                        })
+                            .trim();
+                    }
                     _e.label = 8;
                 case 8:
                     addr = patchAddr(pref, city, town, addr);
+                    if (!(option.level > 3 && normalized && town)) return [3 /*break*/, 10];
+                    return [4 /*yield*/, normalizeResidentialPart(addr, pref, city, town)];
+                case 9:
+                    normalized = _e.sent();
+                    _e.label = 10;
+                case 10:
+                    if (normalized) {
+                        lat = parseFloat(normalized.lat);
+                        lng = parseFloat(normalized.lng);
+                    }
+                    if (Number.isNaN(lat) || Number.isNaN(lng)) {
+                        lat = null;
+                        lng = null;
+                    }
                     if (pref)
                         level = level + 1;
                     if (city)
                         level = level + 1;
                     if (town)
                         level = level + 1;
-                    return [2 /*return*/, {
-                            pref: pref,
-                            city: city,
-                            town: town,
-                            addr: addr,
-                            lat: lat,
-                            lng: lng,
-                            level: level,
-                        }];
+                    result = {
+                        pref: pref,
+                        city: city,
+                        town: town,
+                        addr: addr,
+                        lat: lat,
+                        lng: lng,
+                        level: level,
+                    };
+                    if (normalized && 'gaiku' in normalized) {
+                        result.addr = normalized.addr;
+                        result.gaiku = normalized.gaiku;
+                        result.level = 7;
+                    }
+                    if (normalized && 'jyukyo' in normalized) {
+                        result.jyukyo = normalized.jyukyo;
+                        result.level = 8;
+                    }
+                    return [2 /*return*/, result];
             }
         });
     });
@@ -606,6 +763,9 @@ var fetchOrReadFile = function (input) { return __awaiter(void 0, void 0, void 0
     return __generator(this, function (_a) {
         fileURL = new URL("" + config$1.japaneseAddressesApi + input);
         if (fileURL.protocol === 'http:' || fileURL.protocol === 'https:') {
+            if (config$1.geoloniaApiKey) {
+                fileURL.search = "?geolonia-api-key=" + config$1.geoloniaApiKey;
+            }
             return [2 /*return*/, unfetch__default['default'](fileURL.toString())];
         }
         else if (fileURL.protocol === 'file:') {

data/js/node_modules/@geolonia/normalize-japanese-addresses/dist/normalize.d.ts

@@ -6,6 +6,7 @@ export interface Config {
     japaneseAddressesApi: string;
     /** 町丁目のデータを何件までキャッシュするか。デフォルト 1,000 */
     townCacheSize: number;
+    geoloniaApiKey?: string;
 }
 export declare const config: Config;
 /**
@@ -18,6 +19,10 @@ export interface NormalizeResult {
     city: string;
     /** 町丁目 */
     town: string;
+    /** 住居表示住所における街区符号 */
+    gaiku?: string;
+    /** 住居表示住所における住居番号 */
+    jyukyo?: string;
     /** 正規化後の住所文字列 */
     addr: string;
     /** 緯度。データが存在しない場合は null */
@@ -30,6 +35,8 @@ export interface NormalizeResult {
      * - 1 - 都道府県まで判別できた。
      * - 2 - 市区町村まで判別できた。
      * - 3 - 町丁目まで判別できた。
+     * - 7 - 住居表示住所の街区までの判別ができた。
+     * - 8 - 住居表示住所の街区符号・住居番号までの判別ができた。
      */
     level: number;
 }
@@ -42,7 +49,9 @@ export interface Option {
      *
      * @see https://github.com/geolonia/normalize-japanese-addresses#normalizeaddress-string
      */
-    level: number;
+    level?: number;
+    /** 指定した場合、Geolonia のバックエンドを利用してより高精度の正規化を行います */
+    geoloniaApiKey?: string;
 }
 /**
  * 住所を正規化します。

data/js/node_modules/@geolonia/normalize-japanese-addresses/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@geolonia/normalize-japanese-addresses",
-  "version": "2.5.8",
+  "version": "2.7.3",
   "description": "",
   "browser": "./dist/main-browser.js",
   "main": "./dist/main-node.js",
   "types": "./dist/normalize.d.ts",
   "scripts": {
-    "test": "npm run test:main && npm run test:addresses && npm run test:node",
+    "test": "npm run test:main && npm run test:addresses && npm run test:node && npm run test:residential",
     "test:main": "jest test/main.test.ts",
     "test:addresses": "jest test/addresses.test.ts",
+    "test:residential": "jest test/residential.test.ts --runInBand",
     "test:node": "curl -sL https://github.com/geolonia/japanese-addresses/archive/refs/heads/master.tar.gz | tar xvfz - -C ./test > /dev/null 2>&1 && jest test/fs.test.ts",
     "test:generate-test-data": "npx ts-node -O '{\"module\":\"commonjs\"}' test/build-test-data.ts > test/addresses.csv",
     "lint": "eslint \"src/**/*.ts\" \"test/**/*.test.ts\" --fix",

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/config.ts

@@ -1,6 +1,9 @@
 import { Config } from './normalize'
 
+export const gh_pages_endpoint =
+  'https://geolonia.github.io/japanese-addresses/api/ja'
+
 export const currentConfig: Config = {
-  japaneseAddressesApi: 'https://geolonia.github.io/japanese-addresses/api/ja',
+  japaneseAddressesApi: gh_pages_endpoint,
   townCacheSize: 1_000,
 }

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/lib/cacheRegexes.ts

@@ -15,6 +15,20 @@ interface SingleTown {
 }
 type TownList = SingleTown[]
 
+interface GaikuListItem {
+  gaiku: string
+  lat: string
+  lng: string
+}
+
+interface SingleResidential {
+  gaiku: string
+  jyukyo: string
+  lat: string
+  lng: string
+}
+type ResidentialList = SingleResidential[]
+
 const cachedTownRegexes = new LRU<string, [SingleTown, string][]>({
   max: currentConfig.townCacheSize,
   maxAge: 60 * 60 * 24 * 7 * 1000, // 7日間
@@ -24,6 +38,8 @@ let cachedPrefecturePatterns: [string, string][] | undefined = undefined
 const cachedCityPatterns: { [key: string]: [string, string][] } = {}
 let cachedPrefectures: PrefectureList | undefined = undefined
 const cachedTowns: { [key: string]: TownList } = {}
+const cachedGaikuListItem: { [key: string]: GaikuListItem[] } = {}
+const cachedResidentials: { [key: string]: ResidentialList } = {}
 let cachedSameNamedPrefectureCityRegexPatterns:
   | [string, string][]
   | undefined = undefined
@@ -33,8 +49,8 @@ export const getPrefectures = async () => {
     return cachedPrefectures
   }
 
-  const resp = await __internals.fetch('.json') // ja.json
-  const data = (await resp.json()) as PrefectureList
+  const prefsResp = await __internals.fetch('.json') // ja.json
+  const data = (await prefsResp.json()) as PrefectureList
   return cachePrefectures(data)
 }
 
@@ -86,13 +102,70 @@ export const getTowns = async (pref: string, city: string) => {
     return cachedTown
   }
 
-  const responseTownsResp = await __internals.fetch(
+  const townsResp = await __internals.fetch(
     ['', encodeURI(pref), encodeURI(city) + '.json'].join('/'),
   )
-  const towns = (await responseTownsResp.json()) as TownList
+  const towns = (await townsResp.json()) as TownList
   return (cachedTowns[cacheKey] = towns)
 }
 
+export const getGaikuList = async (
+  pref: string,
+  city: string,
+  town: string,
+) => {
+  const cacheKey = `${pref}-${city}-${town}`
+  const cache = cachedGaikuListItem[cacheKey]
+  if (typeof cache !== 'undefined') {
+    return cache
+  }
+  const gaikuResp = await __internals.fetch(
+    ['', encodeURI(pref), encodeURI(city), encodeURI(town + '.json')].join('/'),
+  )
+  let gaikuListItem: GaikuListItem[]
+  try {
+    gaikuListItem = (await gaikuResp.json()) as GaikuListItem[]
+  } catch {
+    gaikuListItem = []
+  }
+  return (cachedGaikuListItem[cacheKey] = gaikuListItem)
+}
+
+export const getResidentials = async (
+  pref: string,
+  city: string,
+  town: string,
+) => {
+  const cacheKey = `${pref}-${city}-${town}`
+  const cache = cachedResidentials[cacheKey]
+  if (typeof cache !== 'undefined') {
+    return cache
+  }
+
+  const residentialsResp = await __internals.fetch(
+    [
+      '',
+      encodeURI(pref),
+      encodeURI(city),
+      encodeURI(town),
+      encodeURI('住居表示.json'),
+    ].join('/'),
+  )
+  let residentials: ResidentialList
+  try {
+    residentials = (await residentialsResp.json()) as ResidentialList
+  } catch {
+    residentials = []
+  }
+
+  residentials.sort(
+    (res1, res2) =>
+      `${res2.gaiku}-${res2.jyukyo}`.length -
+      `${res1.gaiku}-${res1.jyukyo}`.length,
+  )
+  return (cachedResidentials[cacheKey] = residentials)
+}
+
 // 十六町 のように漢数字と町が連結しているか
 const isKanjiNumberFollewedByCho = (targetTownName: string) => {
   const xCho = targetTownName.match(/.町/g)

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/main-node.ts

@@ -7,6 +7,9 @@ const fetchOrReadFile = async (
 ): Promise<Response | { json: () => Promise<unknown> }> => {
   const fileURL = new URL(`${Normalize.config.japaneseAddressesApi}${input}`)
   if (fileURL.protocol === 'http:' || fileURL.protocol === 'https:') {
+    if (Normalize.config.geoloniaApiKey) {
+      fileURL.search = `?geolonia-api-key=${Normalize.config.geoloniaApiKey}`
+    }
     return unfetch(fileURL.toString())
   } else if (fileURL.protocol === 'file:') {
     const filePath = decodeURI(fileURL.pathname)