[{"data":1,"prerenderedAt":1517},["ShallowReactive",2],{"content-en-\u002Fusage":3},{"id":4,"title":5,"body":6,"description":1511,"extension":1512,"meta":1513,"navigation":75,"path":1514,"seo":1515,"stem":12,"__hash__":1516},"content_en\u002Fusage.md","Usage",{"type":7,"value":8,"toc":1499},"minimark",[9,13,17,22,317,322,333,403,414,527,530,534,541,547,566,570,591,770,808,812,828,1097,1133,1137,1140,1143,1146,1175,1181,1213,1219,1222,1314,1375,1383,1387,1390,1425,1429,1483,1495],[10,11,5],"h1",{"id":12},"usage",[14,15,16],"p",{},"Here is the simplest way to get started.",[18,19,21],"h2",{"id":20},"minimal-example","Minimal example",[23,24,29],"pre",{"className":25,"code":26,"language":27,"meta":28,"style":28},"language-ts shiki shiki-themes github-light github-dark","import { createLocalGovClient } from \"@b4moss\u002Fjp-local-gov-id\";\nimport dataset from \"@b4moss\u002Fjp-local-gov-id-data\";\n\nconst client = await createLocalGovClient({ data: dataset });\n\nclient.listPrefectures();\nclient.getPrefectureByCode(\"27\"); \u002F\u002F Osaka\nclient.getPrefectureCodeByName(\"大阪府\"); \u002F\u002F \"27\"\nawait client.listMunicipalitiesByPrefecture(\"13\"); \u002F\u002F Tokyo municipalities, etc.\nawait client.listMunicipalitiesByPrefecture(\"01\", { designatedCity: \"city\" }); \u002F\u002F designated-city body only\nawait client.getMunicipalityByCode(\"131016\"); \u002F\u002F Chiyoda\nawait client.getByCode(\"131016\");\nawait client.searchByText(\"中央\", { prefecture: \"01\", target: \"cities\" });\nawait client.searchByText(\"ちよだ\", { prefecture: \"13\", target: \"cities\" }); \u002F\u002F kana \u002F hiragana OK\nawait client.getLocalGovCodeByName(\"千代田区\"); \u002F\u002F \"131016\"\n","ts","",[30,31,32,55,70,77,100,105,117,138,156,178,204,224,241,270,297],"code",{"__ignoreMap":28},[33,34,37,41,45,48,52],"span",{"class":35,"line":36},"line",1,[33,38,40],{"class":39},"szBVR","import",[33,42,44],{"class":43},"sVt8B"," { createLocalGovClient } ",[33,46,47],{"class":39},"from",[33,49,51],{"class":50},"sZZnC"," \"@b4moss\u002Fjp-local-gov-id\"",[33,53,54],{"class":43},";\n",[33,56,58,60,63,65,68],{"class":35,"line":57},2,[33,59,40],{"class":39},[33,61,62],{"class":43}," dataset ",[33,64,47],{"class":39},[33,66,67],{"class":50}," \"@b4moss\u002Fjp-local-gov-id-data\"",[33,69,54],{"class":43},[33,71,73],{"class":35,"line":72},3,[33,74,76],{"emptyLinePlaceholder":75},true,"\n",[33,78,80,83,87,90,93,97],{"class":35,"line":79},4,[33,81,82],{"class":39},"const",[33,84,86],{"class":85},"sj4cs"," client",[33,88,89],{"class":39}," =",[33,91,92],{"class":39}," await",[33,94,96],{"class":95},"sScJk"," createLocalGovClient",[33,98,99],{"class":43},"({ data: dataset });\n",[33,101,103],{"class":35,"line":102},5,[33,104,76],{"emptyLinePlaceholder":75},[33,106,108,111,114],{"class":35,"line":107},6,[33,109,110],{"class":43},"client.",[33,112,113],{"class":95},"listPrefectures",[33,115,116],{"class":43},"();\n",[33,118,120,122,125,128,131,134],{"class":35,"line":119},7,[33,121,110],{"class":43},[33,123,124],{"class":95},"getPrefectureByCode",[33,126,127],{"class":43},"(",[33,129,130],{"class":50},"\"27\"",[33,132,133],{"class":43},"); ",[33,135,137],{"class":136},"sJ8bj","\u002F\u002F Osaka\n",[33,139,141,143,146,148,151,153],{"class":35,"line":140},8,[33,142,110],{"class":43},[33,144,145],{"class":95},"getPrefectureCodeByName",[33,147,127],{"class":43},[33,149,150],{"class":50},"\"大阪府\"",[33,152,133],{"class":43},[33,154,155],{"class":136},"\u002F\u002F \"27\"\n",[33,157,159,162,165,168,170,173,175],{"class":35,"line":158},9,[33,160,161],{"class":39},"await",[33,163,164],{"class":43}," client.",[33,166,167],{"class":95},"listMunicipalitiesByPrefecture",[33,169,127],{"class":43},[33,171,172],{"class":50},"\"13\"",[33,174,133],{"class":43},[33,176,177],{"class":136},"\u002F\u002F Tokyo municipalities, etc.\n",[33,179,181,183,185,187,189,192,195,198,201],{"class":35,"line":180},10,[33,182,161],{"class":39},[33,184,164],{"class":43},[33,186,167],{"class":95},[33,188,127],{"class":43},[33,190,191],{"class":50},"\"01\"",[33,193,194],{"class":43},", { designatedCity: ",[33,196,197],{"class":50},"\"city\"",[33,199,200],{"class":43}," }); ",[33,202,203],{"class":136},"\u002F\u002F designated-city body only\n",[33,205,207,209,211,214,216,219,221],{"class":35,"line":206},11,[33,208,161],{"class":39},[33,210,164],{"class":43},[33,212,213],{"class":95},"getMunicipalityByCode",[33,215,127],{"class":43},[33,217,218],{"class":50},"\"131016\"",[33,220,133],{"class":43},[33,222,223],{"class":136},"\u002F\u002F Chiyoda\n",[33,225,227,229,231,234,236,238],{"class":35,"line":226},12,[33,228,161],{"class":39},[33,230,164],{"class":43},[33,232,233],{"class":95},"getByCode",[33,235,127],{"class":43},[33,237,218],{"class":50},[33,239,240],{"class":43},");\n",[33,242,244,246,248,251,253,256,259,261,264,267],{"class":35,"line":243},13,[33,245,161],{"class":39},[33,247,164],{"class":43},[33,249,250],{"class":95},"searchByText",[33,252,127],{"class":43},[33,254,255],{"class":50},"\"中央\"",[33,257,258],{"class":43},", { prefecture: ",[33,260,191],{"class":50},[33,262,263],{"class":43},", target: ",[33,265,266],{"class":50},"\"cities\"",[33,268,269],{"class":43}," });\n",[33,271,273,275,277,279,281,284,286,288,290,292,294],{"class":35,"line":272},14,[33,274,161],{"class":39},[33,276,164],{"class":43},[33,278,250],{"class":95},[33,280,127],{"class":43},[33,282,283],{"class":50},"\"ちよだ\"",[33,285,258],{"class":43},[33,287,172],{"class":50},[33,289,263],{"class":43},[33,291,266],{"class":50},[33,293,200],{"class":43},[33,295,296],{"class":136},"\u002F\u002F kana \u002F hiragana OK\n",[33,298,300,302,304,307,309,312,314],{"class":35,"line":299},15,[33,301,161],{"class":39},[33,303,164],{"class":43},[33,305,306],{"class":95},"getLocalGovCodeByName",[33,308,127],{"class":43},[33,310,311],{"class":50},"\"千代田区\"",[33,313,133],{"class":43},[33,315,316],{"class":136},"\u002F\u002F \"131016\"\n",[318,319,321],"h3",{"id":320},"designated-city-body-ward-filter","Designated-city body \u002F ward filter",[14,323,324,325,328,329,332],{},"For address forms that need “city only” or “wards only”, use ",[30,326,327],{},"designatedCity"," (default ",[30,330,331],{},"\"both\"",").",[334,335,336,352],"table",{},[337,338,339],"thead",{},[340,341,342,346,349],"tr",{},[343,344,345],"th",{},"Value",[343,347,348],{},"Meaning",[343,350,351],{},"Example (Hokkaido)",[353,354,355,374,388],"tbody",{},[340,356,357,362,365],{},[358,359,360],"td",{},[30,361,331],{},[358,363,364],{},"City body and wards",[358,366,367,370,371],{},[30,368,369],{},"札幌市"," and ",[30,372,373],{},"札幌市中央区",[340,375,376,380,383],{},[358,377,378],{},[30,379,197],{},[358,381,382],{},"City body only",[358,384,385,387],{},[30,386,369],{}," only",[340,389,390,395,398],{},[358,391,392],{},[30,393,394],{},"\"ward\"",[358,396,397],{},"Wards only",[358,399,400,402],{},[30,401,373],{},", etc.",[14,404,405,406,408,409,408,411,413],{},"Applies to: ",[30,407,167],{}," \u002F ",[30,410,250],{},[30,412,306],{},". Tokyo special wards are not affected.",[23,415,417],{"className":25,"code":416,"language":27,"meta":28,"style":28},"\u002F\u002F Address select: city only\nawait client.listMunicipalitiesByPrefecture(\"01\", { designatedCity: \"city\" });\n\n\u002F\u002F Address select: wards only\nawait client.listMunicipalitiesByPrefecture(\"01\", { designatedCity: \"ward\" });\n\n\u002F\u002F Same option works with search\nawait client.searchByText(\"札幌\", {\n  prefecture: \"01\",\n  target: \"cities\",\n  designatedCity: \"ward\",\n});\n",[30,418,419,424,442,446,451,469,473,478,494,504,513,522],{"__ignoreMap":28},[33,420,421],{"class":35,"line":36},[33,422,423],{"class":136},"\u002F\u002F Address select: city only\n",[33,425,426,428,430,432,434,436,438,440],{"class":35,"line":57},[33,427,161],{"class":39},[33,429,164],{"class":43},[33,431,167],{"class":95},[33,433,127],{"class":43},[33,435,191],{"class":50},[33,437,194],{"class":43},[33,439,197],{"class":50},[33,441,269],{"class":43},[33,443,444],{"class":35,"line":72},[33,445,76],{"emptyLinePlaceholder":75},[33,447,448],{"class":35,"line":79},[33,449,450],{"class":136},"\u002F\u002F Address select: wards only\n",[33,452,453,455,457,459,461,463,465,467],{"class":35,"line":102},[33,454,161],{"class":39},[33,456,164],{"class":43},[33,458,167],{"class":95},[33,460,127],{"class":43},[33,462,191],{"class":50},[33,464,194],{"class":43},[33,466,394],{"class":50},[33,468,269],{"class":43},[33,470,471],{"class":35,"line":107},[33,472,76],{"emptyLinePlaceholder":75},[33,474,475],{"class":35,"line":119},[33,476,477],{"class":136},"\u002F\u002F Same option works with search\n",[33,479,480,482,484,486,488,491],{"class":35,"line":140},[33,481,161],{"class":39},[33,483,164],{"class":43},[33,485,250],{"class":95},[33,487,127],{"class":43},[33,489,490],{"class":50},"\"札幌\"",[33,492,493],{"class":43},", {\n",[33,495,496,499,501],{"class":35,"line":158},[33,497,498],{"class":43},"  prefecture: ",[33,500,191],{"class":50},[33,502,503],{"class":43},",\n",[33,505,506,509,511],{"class":35,"line":180},[33,507,508],{"class":43},"  target: ",[33,510,266],{"class":50},[33,512,503],{"class":43},[33,514,515,518,520],{"class":35,"line":206},[33,516,517],{"class":43},"  designatedCity: ",[33,519,394],{"class":50},[33,521,503],{"class":43},[33,523,524],{"class":35,"line":226},[33,525,526],{"class":43},"});\n",[14,528,529],{},"Install the app and data packages from npm, then import and use them as shown above.",[18,531,533],{"id":532},"dealing-with-a-large-dataset","Dealing with a large dataset",[14,535,536,537],{},"You might wonder: ",[538,539,540],"strong",{},"“Isn’t shipping nationwide data via npm huge?”",[14,542,543,546],{},[538,544,545],{},"YES."," The v0.1.0 dataset is over 400KB.",[14,548,549,550,553,554,557,558,561,562,565],{},"We recommend building the app (",[30,551,552],{},"@b4moss\u002Fjp-local-gov-id",") and the dataset (",[30,555,556],{},"@b4moss\u002Fjp-local-gov-id-data",") separately with your package manager \u002F bundler — copy the JSON as static assets and load them via ",[30,559,560],{},"url",", instead of bundling ",[30,563,564],{},"dataset.js"," into your app.",[318,567,569],{"id":568},"with-vite","With Vite",[23,571,575],{"className":572,"code":573,"language":574,"meta":28,"style":28},"language-shell shiki shiki-themes github-light github-dark","npm i -D vite-plugin-static-copy\n","shell",[30,576,577],{"__ignoreMap":28},[33,578,579,582,585,588],{"class":35,"line":36},[33,580,581],{"class":95},"npm",[33,583,584],{"class":50}," i",[33,586,587],{"class":85}," -D",[33,589,590],{"class":50}," vite-plugin-static-copy\n",[23,592,594],{"className":25,"code":593,"language":27,"meta":28,"style":28},"\u002F\u002F vite.config.ts\nimport { defineConfig } from \"vite\";\nimport { viteStaticCopy } from \"vite-plugin-static-copy\";\nexport default defineConfig({\n  plugins: [\n    viteStaticCopy({\n      targets: [\n        {\n          \u002F\u002F Do not copy dataset.js (it would bloat the bundle)\n          src: [\n            \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Findex.json\",\n            \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures.json\",\n            \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures\",\n          ],\n          dest: \"jp-local-gov-id-data\",\n        },\n      ],\n    }),\n  ],\n  \u002F\u002F Exclude from optimizeDeps so accidental imports are easier to notice\n  optimizeDeps: {\n    exclude: [\"@b4moss\u002Fjp-local-gov-id-data\"],\n  },\n});\n",[30,595,596,601,615,629,643,648,655,660,665,670,675,682,689,696,701,711,717,723,729,735,741,747,759,765],{"__ignoreMap":28},[33,597,598],{"class":35,"line":36},[33,599,600],{"class":136},"\u002F\u002F vite.config.ts\n",[33,602,603,605,608,610,613],{"class":35,"line":57},[33,604,40],{"class":39},[33,606,607],{"class":43}," { defineConfig } ",[33,609,47],{"class":39},[33,611,612],{"class":50}," \"vite\"",[33,614,54],{"class":43},[33,616,617,619,622,624,627],{"class":35,"line":72},[33,618,40],{"class":39},[33,620,621],{"class":43}," { viteStaticCopy } ",[33,623,47],{"class":39},[33,625,626],{"class":50}," \"vite-plugin-static-copy\"",[33,628,54],{"class":43},[33,630,631,634,637,640],{"class":35,"line":79},[33,632,633],{"class":39},"export",[33,635,636],{"class":39}," default",[33,638,639],{"class":95}," defineConfig",[33,641,642],{"class":43},"({\n",[33,644,645],{"class":35,"line":102},[33,646,647],{"class":43},"  plugins: [\n",[33,649,650,653],{"class":35,"line":107},[33,651,652],{"class":95},"    viteStaticCopy",[33,654,642],{"class":43},[33,656,657],{"class":35,"line":119},[33,658,659],{"class":43},"      targets: [\n",[33,661,662],{"class":35,"line":140},[33,663,664],{"class":43},"        {\n",[33,666,667],{"class":35,"line":158},[33,668,669],{"class":136},"          \u002F\u002F Do not copy dataset.js (it would bloat the bundle)\n",[33,671,672],{"class":35,"line":180},[33,673,674],{"class":43},"          src: [\n",[33,676,677,680],{"class":35,"line":206},[33,678,679],{"class":50},"            \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Findex.json\"",[33,681,503],{"class":43},[33,683,684,687],{"class":35,"line":226},[33,685,686],{"class":50},"            \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures.json\"",[33,688,503],{"class":43},[33,690,691,694],{"class":35,"line":243},[33,692,693],{"class":50},"            \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures\"",[33,695,503],{"class":43},[33,697,698],{"class":35,"line":272},[33,699,700],{"class":43},"          ],\n",[33,702,703,706,709],{"class":35,"line":299},[33,704,705],{"class":43},"          dest: ",[33,707,708],{"class":50},"\"jp-local-gov-id-data\"",[33,710,503],{"class":43},[33,712,714],{"class":35,"line":713},16,[33,715,716],{"class":43},"        },\n",[33,718,720],{"class":35,"line":719},17,[33,721,722],{"class":43},"      ],\n",[33,724,726],{"class":35,"line":725},18,[33,727,728],{"class":43},"    }),\n",[33,730,732],{"class":35,"line":731},19,[33,733,734],{"class":43},"  ],\n",[33,736,738],{"class":35,"line":737},20,[33,739,740],{"class":136},"  \u002F\u002F Exclude from optimizeDeps so accidental imports are easier to notice\n",[33,742,744],{"class":35,"line":743},21,[33,745,746],{"class":43},"  optimizeDeps: {\n",[33,748,750,753,756],{"class":35,"line":749},22,[33,751,752],{"class":43},"    exclude: [",[33,754,755],{"class":50},"\"@b4moss\u002Fjp-local-gov-id-data\"",[33,757,758],{"class":43},"],\n",[33,760,762],{"class":35,"line":761},23,[33,763,764],{"class":43},"  },\n",[33,766,768],{"class":35,"line":767},24,[33,769,526],{"class":43},[23,771,773],{"className":25,"code":772,"language":27,"meta":28,"style":28},"\u002F\u002F app.ts, etc.\nconst client = await createLocalGovClient({\n  url: \"\u002Fjp-local-gov-id-data\u002Findex.json\",\n});\n",[30,774,775,780,794,804],{"__ignoreMap":28},[33,776,777],{"class":35,"line":36},[33,778,779],{"class":136},"\u002F\u002F app.ts, etc.\n",[33,781,782,784,786,788,790,792],{"class":35,"line":57},[33,783,82],{"class":39},[33,785,86],{"class":85},[33,787,89],{"class":39},[33,789,92],{"class":39},[33,791,96],{"class":95},[33,793,642],{"class":43},[33,795,796,799,802],{"class":35,"line":72},[33,797,798],{"class":43},"  url: ",[33,800,801],{"class":50},"\"\u002Fjp-local-gov-id-data\u002Findex.json\"",[33,803,503],{"class":43},[33,805,806],{"class":35,"line":79},[33,807,526],{"class":43},[318,809,811],{"id":810},"with-webpack","With Webpack",[23,813,815],{"className":572,"code":814,"language":574,"meta":28,"style":28},"npm i -D copy-webpack-plugin\n",[30,816,817],{"__ignoreMap":28},[33,818,819,821,823,825],{"class":35,"line":36},[33,820,581],{"class":95},[33,822,584],{"class":50},[33,824,587],{"class":85},[33,826,827],{"class":50}," copy-webpack-plugin\n",[23,829,833],{"className":830,"code":831,"language":832,"meta":28,"style":28},"language-js shiki shiki-themes github-light github-dark","\u002F\u002F webpack.config.js\nconst path = require(\"path\");\nconst CopyWebpackPlugin = require(\"copy-webpack-plugin\");\n\nmodule.exports = {\n  entry: \".\u002Fsrc\u002Fmain.js\",\n  output: {\n    path: path.resolve(__dirname, \"dist\"),\n    filename: \"app.js\",\n    clean: true,\n  },\n  plugins: [\n    new CopyWebpackPlugin({\n      patterns: [\n        {\n          from: \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Findex.json\",\n          to: \"jp-local-gov-id-data\u002Findex.json\",\n        },\n        {\n          from: \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures.json\",\n          to: \"jp-local-gov-id-data\u002Fprefectures.json\",\n        },\n        {\n          from: \"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures\",\n          to: \"jp-local-gov-id-data\u002Fprefectures\",\n        },\n      ],\n    }),\n  ],\n  \u002F\u002F Avoid bundling the data package\n  externals: {\n    \u002F\u002F Only if needed. Usually just don't import it.\n  },\n};\n","js",[30,834,835,840,859,877,881,897,907,912,929,939,949,953,957,966,971,975,985,995,999,1003,1012,1021,1025,1029,1038,1048,1053,1058,1063,1068,1074,1080,1086,1091],{"__ignoreMap":28},[33,836,837],{"class":35,"line":36},[33,838,839],{"class":136},"\u002F\u002F webpack.config.js\n",[33,841,842,844,847,849,852,854,857],{"class":35,"line":57},[33,843,82],{"class":39},[33,845,846],{"class":85}," path",[33,848,89],{"class":39},[33,850,851],{"class":95}," require",[33,853,127],{"class":43},[33,855,856],{"class":50},"\"path\"",[33,858,240],{"class":43},[33,860,861,863,866,868,870,872,875],{"class":35,"line":72},[33,862,82],{"class":39},[33,864,865],{"class":85}," CopyWebpackPlugin",[33,867,89],{"class":39},[33,869,851],{"class":95},[33,871,127],{"class":43},[33,873,874],{"class":50},"\"copy-webpack-plugin\"",[33,876,240],{"class":43},[33,878,879],{"class":35,"line":79},[33,880,76],{"emptyLinePlaceholder":75},[33,882,883,886,889,892,894],{"class":35,"line":102},[33,884,885],{"class":85},"module",[33,887,888],{"class":43},".",[33,890,891],{"class":85},"exports",[33,893,89],{"class":39},[33,895,896],{"class":43}," {\n",[33,898,899,902,905],{"class":35,"line":107},[33,900,901],{"class":43},"  entry: ",[33,903,904],{"class":50},"\".\u002Fsrc\u002Fmain.js\"",[33,906,503],{"class":43},[33,908,909],{"class":35,"line":119},[33,910,911],{"class":43},"  output: {\n",[33,913,914,917,920,923,926],{"class":35,"line":140},[33,915,916],{"class":43},"    path: path.",[33,918,919],{"class":95},"resolve",[33,921,922],{"class":43},"(__dirname, ",[33,924,925],{"class":50},"\"dist\"",[33,927,928],{"class":43},"),\n",[33,930,931,934,937],{"class":35,"line":158},[33,932,933],{"class":43},"    filename: ",[33,935,936],{"class":50},"\"app.js\"",[33,938,503],{"class":43},[33,940,941,944,947],{"class":35,"line":180},[33,942,943],{"class":43},"    clean: ",[33,945,946],{"class":85},"true",[33,948,503],{"class":43},[33,950,951],{"class":35,"line":206},[33,952,764],{"class":43},[33,954,955],{"class":35,"line":226},[33,956,647],{"class":43},[33,958,959,962,964],{"class":35,"line":243},[33,960,961],{"class":39},"    new",[33,963,865],{"class":95},[33,965,642],{"class":43},[33,967,968],{"class":35,"line":272},[33,969,970],{"class":43},"      patterns: [\n",[33,972,973],{"class":35,"line":299},[33,974,664],{"class":43},[33,976,977,980,983],{"class":35,"line":713},[33,978,979],{"class":43},"          from: ",[33,981,982],{"class":50},"\"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Findex.json\"",[33,984,503],{"class":43},[33,986,987,990,993],{"class":35,"line":719},[33,988,989],{"class":43},"          to: ",[33,991,992],{"class":50},"\"jp-local-gov-id-data\u002Findex.json\"",[33,994,503],{"class":43},[33,996,997],{"class":35,"line":725},[33,998,716],{"class":43},[33,1000,1001],{"class":35,"line":731},[33,1002,664],{"class":43},[33,1004,1005,1007,1010],{"class":35,"line":737},[33,1006,979],{"class":43},[33,1008,1009],{"class":50},"\"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures.json\"",[33,1011,503],{"class":43},[33,1013,1014,1016,1019],{"class":35,"line":743},[33,1015,989],{"class":43},[33,1017,1018],{"class":50},"\"jp-local-gov-id-data\u002Fprefectures.json\"",[33,1020,503],{"class":43},[33,1022,1023],{"class":35,"line":749},[33,1024,716],{"class":43},[33,1026,1027],{"class":35,"line":761},[33,1028,664],{"class":43},[33,1030,1031,1033,1036],{"class":35,"line":767},[33,1032,979],{"class":43},[33,1034,1035],{"class":50},"\"node_modules\u002F@b4moss\u002Fjp-local-gov-id-data\u002Fprefectures\"",[33,1037,503],{"class":43},[33,1039,1041,1043,1046],{"class":35,"line":1040},25,[33,1042,989],{"class":43},[33,1044,1045],{"class":50},"\"jp-local-gov-id-data\u002Fprefectures\"",[33,1047,503],{"class":43},[33,1049,1051],{"class":35,"line":1050},26,[33,1052,716],{"class":43},[33,1054,1056],{"class":35,"line":1055},27,[33,1057,722],{"class":43},[33,1059,1061],{"class":35,"line":1060},28,[33,1062,728],{"class":43},[33,1064,1066],{"class":35,"line":1065},29,[33,1067,734],{"class":43},[33,1069,1071],{"class":35,"line":1070},30,[33,1072,1073],{"class":136},"  \u002F\u002F Avoid bundling the data package\n",[33,1075,1077],{"class":35,"line":1076},31,[33,1078,1079],{"class":43},"  externals: {\n",[33,1081,1083],{"class":35,"line":1082},32,[33,1084,1085],{"class":136},"    \u002F\u002F Only if needed. Usually just don't import it.\n",[33,1087,1089],{"class":35,"line":1088},33,[33,1090,764],{"class":43},[33,1092,1094],{"class":35,"line":1093},34,[33,1095,1096],{"class":43},"};\n",[23,1098,1100],{"className":830,"code":1099,"language":832,"meta":28,"style":28},"\u002F\u002F app.js, etc.\nconst client = await createLocalGovClient({\n  url: \"\u002Fjp-local-gov-id-data\u002Findex.json\",\n});\n",[30,1101,1102,1107,1121,1129],{"__ignoreMap":28},[33,1103,1104],{"class":35,"line":36},[33,1105,1106],{"class":136},"\u002F\u002F app.js, etc.\n",[33,1108,1109,1111,1113,1115,1117,1119],{"class":35,"line":57},[33,1110,82],{"class":39},[33,1112,86],{"class":85},[33,1114,89],{"class":39},[33,1116,92],{"class":39},[33,1118,96],{"class":95},[33,1120,642],{"class":43},[33,1122,1123,1125,1127],{"class":35,"line":72},[33,1124,798],{"class":43},[33,1126,801],{"class":50},[33,1128,503],{"class":43},[33,1130,1131],{"class":35,"line":79},[33,1132,526],{"class":43},[318,1134,1136],{"id":1135},"loading-the-dataset-from-an-external-url","Loading the dataset from an external URL",[14,1138,1139],{},"You may not want to self-host the dataset.",[14,1141,1142],{},"In that case, load it from an external URL.",[14,1144,1145],{},"Install only the app package — do not install the data package.",[23,1147,1149],{"className":572,"code":1148,"language":574,"meta":28,"style":28},"npm install @b4moss\u002Fjp-local-gov-id\n\n# If you already installed the data package, uninstall it\n# npm uninstall @b4moss\u002Fjp-local-gov-id-data\n",[30,1150,1151,1161,1165,1170],{"__ignoreMap":28},[33,1152,1153,1155,1158],{"class":35,"line":36},[33,1154,581],{"class":95},[33,1156,1157],{"class":50}," install",[33,1159,1160],{"class":50}," @b4moss\u002Fjp-local-gov-id\n",[33,1162,1163],{"class":35,"line":57},[33,1164,76],{"emptyLinePlaceholder":75},[33,1166,1167],{"class":35,"line":72},[33,1168,1169],{"class":136},"# If you already installed the data package, uninstall it\n",[33,1171,1172],{"class":35,"line":79},[33,1173,1174],{"class":136},"# npm uninstall @b4moss\u002Fjp-local-gov-id-data\n",[14,1176,1177,1178,1180],{},"Then pass the ",[30,1179,560],{}," option when creating the client.",[23,1182,1184],{"className":25,"code":1183,"language":27,"meta":28,"style":28},"const client = await createLocalGovClient({\n  url: \"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002F@b4moss\u002Fjp-local-gov-id-data@0.1.0\u002Findex.json\",\n});\n",[30,1185,1186,1200,1209],{"__ignoreMap":28},[33,1187,1188,1190,1192,1194,1196,1198],{"class":35,"line":36},[33,1189,82],{"class":39},[33,1191,86],{"class":85},[33,1193,89],{"class":39},[33,1195,92],{"class":39},[33,1197,96],{"class":95},[33,1199,642],{"class":43},[33,1201,1202,1204,1207],{"class":35,"line":57},[33,1203,798],{"class":43},[33,1205,1206],{"class":50},"\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002F@b4moss\u002Fjp-local-gov-id-data@0.1.0\u002Findex.json\"",[33,1208,503],{"class":43},[33,1210,1211],{"class":35,"line":72},[33,1212,526],{"class":43},[14,1214,1215,1216,1218],{},"This example uses a jsDelivr URL, but you can also serve a self-hosted dataset and point ",[30,1217,560],{}," at it.",[14,1220,1221],{},"Prefer a versioned URL. The client caches responses, so if the dataset updates under a non-unique URL, stale cache may be served.",[23,1223,1225],{"className":25,"code":1224,"language":27,"meta":28,"style":28},"\u002F\u002F Disable cache\nconst client = await createLocalGovClient({\n  url: \"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002F@b4moss\u002Fjp-local-gov-id-data@0.1.0\u002Findex.json\",\n  cache: false,\n});\n\n\u002F\u002F TTL = 1 hour\nconst clientShortTtl = await createLocalGovClient({\n  url: \"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002F@b4moss\u002Fjp-local-gov-id-data@0.1.0\u002Findex.json\",\n  cacheTtlSeconds: 3600,\n});\n",[30,1226,1227,1232,1246,1254,1264,1268,1272,1277,1292,1300,1310],{"__ignoreMap":28},[33,1228,1229],{"class":35,"line":36},[33,1230,1231],{"class":136},"\u002F\u002F Disable cache\n",[33,1233,1234,1236,1238,1240,1242,1244],{"class":35,"line":57},[33,1235,82],{"class":39},[33,1237,86],{"class":85},[33,1239,89],{"class":39},[33,1241,92],{"class":39},[33,1243,96],{"class":95},[33,1245,642],{"class":43},[33,1247,1248,1250,1252],{"class":35,"line":72},[33,1249,798],{"class":43},[33,1251,1206],{"class":50},[33,1253,503],{"class":43},[33,1255,1256,1259,1262],{"class":35,"line":79},[33,1257,1258],{"class":43},"  cache: ",[33,1260,1261],{"class":85},"false",[33,1263,503],{"class":43},[33,1265,1266],{"class":35,"line":102},[33,1267,526],{"class":43},[33,1269,1270],{"class":35,"line":107},[33,1271,76],{"emptyLinePlaceholder":75},[33,1273,1274],{"class":35,"line":119},[33,1275,1276],{"class":136},"\u002F\u002F TTL = 1 hour\n",[33,1278,1279,1281,1284,1286,1288,1290],{"class":35,"line":140},[33,1280,82],{"class":39},[33,1282,1283],{"class":85}," clientShortTtl",[33,1285,89],{"class":39},[33,1287,92],{"class":39},[33,1289,96],{"class":95},[33,1291,642],{"class":43},[33,1293,1294,1296,1298],{"class":35,"line":158},[33,1295,798],{"class":43},[33,1297,1206],{"class":50},[33,1299,503],{"class":43},[33,1301,1302,1305,1308],{"class":35,"line":180},[33,1303,1304],{"class":43},"  cacheTtlSeconds: ",[33,1306,1307],{"class":85},"3600",[33,1309,503],{"class":43},[33,1311,1312],{"class":35,"line":206},[33,1313,526],{"class":43},[1315,1316,1317,1324,1339,1346,1349,1358,1365],"ul",{},[1318,1319,1320,1321,1323],"li",{},"With ",[30,1322,560],{},", fetched files are cached in localStorage by default (key = each file URL)",[1318,1325,1326,1327,1330,1331,1334,1335,1338],{},"Disable with ",[30,1328,1329],{},"cache: false","; set TTL via ",[30,1332,1333],{},"cacheTtlSeconds"," (seconds; default 1 year = ",[30,1336,1337],{},"31536000",")",[1318,1340,1341,1342,1345],{},"Exception: municipality JSON loaded by ",[538,1343,1344],{},"nationwide"," string search stays in memory only (to avoid cache bloat)",[1318,1347,1348],{},"Environments without localStorage (e.g. Node) skip caching",[1318,1350,1351,1352,1355,1356,1338],{},"String search normalizes hiragana \u002F fullwidth kana to halfwidth kana (",[30,1353,1354],{},"matchField"," default: ",[30,1357,331],{},[1318,1359,1360,1361,1364],{},"Schema mismatch \u002F invalid JSON → ",[30,1362,1363],{},"LocalGovSchemaError","; network \u002F HTTP failures → normal fetch errors",[1318,1366,1367,1368,408,1371,1374],{},"Missing or ambiguous results → ",[30,1369,1370],{},"null",[30,1372,1373],{},"[]"," (no throw)",[14,1376,1377,1378,888],{},"For loading from plain HTML without a package manager, see ",[1379,1380,1382],"a",{"href":1381},"\u002Fen\u002Finstallation","Installation",[18,1384,1386],{"id":1385},"code-formats","Code formats",[14,1388,1389],{},"Supported code formats:",[1315,1391,1392,1414],{},[1318,1393,1394,1395],{},"Prefecture codes\n",[1315,1396,1397,1400],{},[1318,1398,1399],{},"2-digit half-width digits",[1318,1401,1402,1403],{},"1-digit input is accepted with or without zero-padding\n",[1315,1404,1405],{},[1318,1406,1407,370,1410,1413],{},[30,1408,1409],{},"01",[30,1411,1412],{},"1"," behave the same",[1318,1415,1416,1417],{},"Local government codes\n",[1315,1418,1419,1422],{},[1318,1420,1421],{},"6 digits including the check digit",[1318,1423,1424],{},"Missing check digit is an error",[18,1426,1428],{"id":1427},"dataset-layout","Dataset layout",[334,1430,1431,1441],{},[337,1432,1433],{},[340,1434,1435,1438],{},[343,1436,1437],{},"File",[343,1439,1440],{},"Contents",[353,1442,1443,1460,1470],{},[340,1444,1445,1450],{},[358,1446,1447],{},[30,1448,1449],{},"index.json",[358,1451,1452,1453,1456,1457,402],{},"Index of paths, ",[30,1454,1455],{},"schemaVersion",", ",[30,1458,1459],{},"asOf",[340,1461,1462,1467],{},[358,1463,1464],{},[30,1465,1466],{},"prefectures.json",[358,1468,1469],{},"Prefectures only",[340,1471,1472,1477],{},[358,1473,1474],{},[30,1475,1476],{},"prefectures\u002F{code}.json",[358,1478,1479,1480,1338],{},"Municipalities for that prefecture (e.g. ",[30,1481,1482],{},"13.json",[14,1484,1485,1486,370,1490,1494],{},"See ",[1379,1487,1489],{"href":1488},"\u002Fen\u002Fapi","API",[1379,1491,1493],{"href":1492},"\u002Fen\u002Fplayground","Playground"," for more.",[1496,1497,1498],"style",{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":28,"searchDepth":57,"depth":57,"links":1500},[1501,1504,1509,1510],{"id":20,"depth":57,"text":21,"children":1502},[1503],{"id":320,"depth":72,"text":321},{"id":532,"depth":57,"text":533,"children":1505},[1506,1507,1508],{"id":568,"depth":72,"text":569},{"id":810,"depth":72,"text":811},{"id":1135,"depth":72,"text":1136},{"id":1385,"depth":57,"text":1386},{"id":1427,"depth":57,"text":1428},"Client setup and basic operations","md",{},"\u002Fusage",{"title":5,"description":1511},"bgdO64T8Jd2jTk_ERMMAWmB32P8uFdAegtwLBAFihto",1786532353793]