@geolonia/ 正常化- japanese- 地址
オープンソースの住所正規化ライブラリです。
経産省の IMI コンポーネントツールのジオコーディングの仕組みからインスピレーションをうけて開発しました。
デモ
https://geolonia.github.io/ 规范化-贾帕内塞-地址/
インストール
时间轴: @geolonia/normalize-japanese-addresses として配布されています。
无。
$ npm install @geolonia/normalize-japanese-addresses -S
使い方
normalize(address: string, option: Option)
住所を正規化します。
import { normalize } from '@geolonia/normalize-japanese-addresses';
// ESMを利用しない場合は下記
// const { normalize } = require('@geolonia/normalize-japanese-addresses');
normalize('北海道札幌市西区24-2-2-3-3').then(result => {
console.log(result);
// {
// "pref": "北海道", // 都道府県名
// "city": "札幌市西区", // 市区町村名
// "town": "二十四軒二条二丁目", // 大字・丁目名
// "addr": "3-3", // 街区符号・住居符号または地番
// "level": 8, // 正規化レベル
// "point": {
// "lat": 43.074206115, // 緯度
// "lng": 141.315540696, // 軽度
// "level": 8 // 位置情報データレベル
// },
// "other": "" // 正規化できなかった文字列
// }
})
住所の正規化結果として戻されるオブジェクトには、level プロパティが含まれます。level には、住所文字列のどこまでを判別できたかを以下の数値で格納しています。
0- 都道府県も判別できなかった。1- 都道府県まで判別できた。2- 市区町村まで判別できた。3- 大字・丁目まで判別できた。8- 住居表示住所の街区符号・住居符号または地番住所の地番まで判別できた。
point に位置情報データ(EPSG:4326) が入っています。位置情報の精度を表す level プロパティを参照してください。住所正規化レベルと位置情報データのレベルが異なる場合は主には、住居表示または地番情報(レベル8)は存在しましたが、位置情報データが存在しなかった場合。この場合は、大字・丁目の代表点の位置情報データを返却します。
位置情報データのレベルは下記となります。
1- 都道府県庁所在地2- 市区町村役所(役場)所在地3- 大字・丁目の代表点8- 住居表示住所の場合はフロンテージ位置多い。地番住所の場合は地番の中央点。
レベルの上限を設定することも可能です。例えば都道府県名のみを正規化したい場合、level オプションで指定することで処理を速くすることができます。
const { normalize } = require('@geolonia/normalize-japanese-addresses')
normalize('北海道札幌市西区24-2-2-3-3', { level: 1 }).then(result => {
console.log(result);
// {
// "pref": "北海道",
// "other": "札幌市西区24-2-2-3-3",
// "level": 1,
// "point": {
// "lat": 43.0639406375,
// "lng": 141.347906782,
// "level": 1
// }
// }
})
グローバルオプション
以下のパラメーターを変更することでライブラリの動作全体に関わる設定が変更できます。
config.japaneseAddressesApi: string
# # 网络 API # # # https://japanese-addresses-v2.geoloniamaps.com/api/ja API 页面存档备份,存于互联网档案馆 吉洛尼亚岛 を参考にしてください。
节点JS環境のみ、このオプションに対して file:// [永久失效連結] [永久失效連結]。
正規化の内容
XXX郡などの郡の名前が省略されている住所に対しては、それを補完します。- 住所に含まれるアルファベットと数字を半角に統一します。
- 京都の通り名を削除します。
- 新字体と旧字体のゆらぎを吸収して、国交省の位置参照情報に記載されている地名にあわせます。
ヶケが, (中文)ヵカか力, (中文)之ノの, (中文)ッツっつなどのゆらぎを吸収して、国交省の位置参照情報に記載されている地名にあわせます。釜页:1竈, (中文)埠頭页:1ふ頭などの漢字のゆらぎを吸収します。- 町丁目レベルに記載されている数字は、国交省の位置参照情報にあわせて、すべて漢数字に変換します。
- 番地や号レベルに記載されている数字はアラビア数字に変換し、
番地などの文字列は-に変換します。 - 住所の末尾に建物名がある場合は、なるべくなにもしないでそのまま返す仕様になっていますが、できればあらかじめ分離していただいたほうがいいかもしれません。
参考:
開発者向け情報
まず、以下のコマンドで環境を用意してください。
$ git clone [email protected]:geolonia/normalize-japanese-addresses.git
$ cd normalize-japanese-addresses
$ npm install
次に、以下を実行してコンパイルをおこないます。
$ npm run build
主节点.js
// sample.js
import { normalize } from './dist/main-node-esm.mjs';
// ESMを利用しない場合は下記
// const { normalize } = require('./dist/main-node-cjs.cjs');
normalize('北海道札幌市西区24-2-2-3-3', { level: 3 }).then(result => {
console.log(result);
// {
// "pref": "北海道",
// "city": "札幌市西区",
// "town": "二十四軒二条二丁目",
// "other": "3-3",
// "level": 3,
// "point": {
// "lat": 43.074273,
// "lng": 141.315099,
// "level": 3
// }
// }
})
样本.js
$ node sample.js
でサンプルファイルを実行することができます。
节点JS
normalize-japanese-addresses 节点JS 18.x, 20.x, 22.x を対象としてテストを実施し、動作を確認しております。ビルド時は「開発環境」の. 节点JS。
节点JS {快讯} {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢。
開発環境は、 .tool-versions にかかれているバージョンを利用してください。
準拠としては 节点.js 发布 维护、活动 LTS 活动 LTS 活动。
页:1
- この正規化エンジンは、住所の「名寄せ」を目的としており、たとえば京都の「通り名」は削除します。
- 郵便や宅急便などに使用される住所としては、問題ないと考えています。
- 正規化に利用するデータは、
japanese-addresses-v2で作成されます。元データに関してはそのレポジトリを御覧ください。 - 住居表示が未整備の地域については全体的に苦手です。
貢献方法
ライセンス、利用規約
- 麻省理工学院。
- ご利用に際しましては、できればソーシャルでのシェア、地罗尼亚 へのリンクの設置などをしていただけると、開発者たちのモチベーションが上がると思います。
住所の正規化を工夫すれば精度があがりそうなので、そのあたりのアイディアを募集しています。