åå¯ããšã¯å ã å人ãè€æ°æã€éè¡å£åº§ãäžå 管çããããã®æŠå¿µã§ãããããŒã¿ãæ±ã人ã ã®äžã§ã¯ãæºãããªãèå¥ã§ããäžæã®IDãç¡ãããã©ããã®ããæååã«ããåç§°ãªã©ã§èå¥ãããããªãããŒã¿ã«ãããŠãåéããšã«åºãšãªããã¹ã¿ãŒããŒã¿ãããããåç §ããªããã察象ãäžæã«èå¥ããããšããé¢åãªäœæ¥ããšãã£ãæå³ã§äœ¿ãããŠããŸããïŒãã¶ãwïŒå¹²ãèã®äžããéãæ¢ããããªäœæ¥ãæ©æ¢°ã®åãåããŠç¡çãããã£ãŠããæããããŸãã
OpenRefineã«ã¯ç
§åïŒReconciliationïŒãšããæ©èœããããåºãæå³ã§ã®åå¯ããšäŒŒãŠããŸãããåçŽãªãã¹ã¿ãŒç
§åã ãã§ãªããäžèŽæ¡ä»¶ã®ãã¥ãŒãã³ã°ãåè£ã®ã¹ã³ã¢ãªã³ã°ããã¹ã¿ãŒãæã€åå以å€ã®å±æ§æ
å ±ã®ååŸãšã«ã©ã åºåãšãã£ãããšãå¯èœã§ããªãŒãã³ãªæ§é åããŒã¿ããŒã¹ã§ããWikidataãšã¯ãšãããç·å¯ã«é£æºã§ããããã«ãªã£ãŠããŸãã
飿ºã®ããã®API仿§ã¯W3CèŠæ Œã«ããªã£ãŠãããããã«æºæ ããç
§åãµãŒãã¹ãšããŠVIAF(ããŒãã£ã«åœéå
žæ ãã¡ã€ã«)ãäžçäžã®äŒæ¥æ
å ±(by opencorporates)ãªã©ãäžè¬å
¬éãããŠããŸãã
ååPDFããæãåºããããŒã¿ã«å¯ŸããŠãä»åã¯äž»ã«ããããåå¯ããç §åãè¡ã£ãŠã¿ãŸããå€å°ãšãç¡çãããªäœæ¥ã®æå©ãã«ãªãã°å¹žãã§ãã
1 åžçºæå
1.1 äžèŠã«ã©ã ãé衚瀺ã«
䜿ããªãã«ã©ã ãé衚瀺ã«ããŠèŠãããããŸãã
察象ã«ã©ã ã®âŒãã ãã¥ãŒïŒå³åŽããã¹ãŠããã

ïŒãããã ã«ã©ã ã¯èŠåºãæ¬ãã¯ãªãã¯ãããšå衚瀺ã§ããŸããïŒ
1.2 Wikidataç §å
åžçºæåã¯èŠããšããæ£ãããã§ãããè€æ°åã§å
¥åããŠãããšããããã¬ããã¶ããã±ããªã©ã®è¡šèšæºãã¯ããããã®ã§Wikidataãšç
§åããŠã¿ãŸãã
ãåžçºæåãã«ã©ã ã§ ç
§åïŒåå¯ãïŒïŒç
§å(reconcile)ãéå§ ãšéžã³ãŸãã

ããã©ã«ãã§ã¯è±èªã®ãšã³ããã€ã³ãããç»é²ãããŠããªãã®ã§æ¥æ¬èªçšã®ãšã³ããã€ã³ãã远å ããŸãã
ããµãŒãã¹ã远å ããã¯ãªãã¯

äžèšãèšå®ããŠå床ããµãŒãã¹ã远å ããã¯ãªãã¯
https://tools.wmflabs.org/openrefine-wikidata/ja/api
https://wdreconcile.toolforge.org/ja/api(2020/7/11倿Ž)

ãã°ãããåŠçäžãã®è¡šç€ºãåºãŠäžèšã«å€ãããŸãã

ãWikidata(ja)ããéžã³ãŸãã

ããã§Wikidataãç
§åããããã®ãã©ã¡ãŒã¿ã調æŽããŸãã
OpenRefineãææ¡ããåæå€ãšããŠãâ¯æ¥æ¬ã®åžãã«ãã§ãã¯ãä»ãã以äžãã®ä»ã®åè£ãåæãããŠããŸãããäžèЧã«ã¯çºãæãå«ãŸããã®ã§ãã®ãŸãŸã ãšåžã ããããããããŸããã
Wikidataã®ãªããžã§ã¯ãïŒé
ç®ãšåŒã³ãŸãïŒã¯äžäœã¯ã©ã¹ïŒã¯ã©ã¹ïŒã€ã³ã¹ã¿ã³ã¹ ãšãã£ãéå±€æ§é ãæã£ãŠãããäŸãã°æ¥æ¬ã®è¡æ¿åºç»ãã°ã©ã衚瀺ãããšä»¥äžã®ãããªæãã§ãã

å
·äœçã«ã¯ãã®äžãããåžåºçºæããšããã¯ã©ã¹ïŒOpenRefineã§ã¯åãšè¡šçŸïŒãæå®ãããšãä»åã®äžèЧã«ããåžçºæåã¯å
šãŠç¶²çŸ
ãããåžåºçºæãšç¡é¢ä¿ãªãªããžã§ã¯ãã¯ååãäžèŽããŠãåè£ã®å¯Ÿè±¡å€ãšãªãã¯ãã§ãã
ãã®ããããçè§£ããŠé©åãªãã¥ãŒãã³ã°ãè¡ãã«ã¯Wikidataã®ããŒã¿æ§é ãããçšåºŠææ¡ããå¿
èŠãããã®ã§èå³ãããã°@yayamamoããã«ãããã¡ãã®èšäºãªã©ãåèã«ããŠãã ããã
ããã§ã¯åã®æå®ã¯ããã«åçŽã«ååã ãã§äžèŽãããã®ãæ¢ãããšã«ããŸãã
ãâ¯åãåããã«ç
§åãããããã§ãã¯ããŠãç
§ååè£ã®æå€§æ°ãã3ããšããŠãç
§åãéå§ã

ç»é¢äžéšã«é»è²å°ã®é²æç¶æ³ã衚瀺ããã100%ã«ãªã£ããç
§åå®äºã§ãã

å®äºããåžçºæåãéåïŒç
§åæžã瀺ããŸãïŒã«ãªããå·Šãµã€ãã«ç
§åå€å®ãã¡ã»ããã衚瀺ãããŸããããnoneãã¯ååšããªããã䌌ããã®ãè€æ°ãã£ãŠäžèŽãèªåå€å®ã§ããªãã£ããã®ã瀺ããŸããå€ãã§ããã詊ãã«éžãã§ã¿ãŸãããã

äžèŽã¹ã³ã¢é ã«åè£ã3ã€äžŠãã§ããŸããæ£è§£ä»¥å€ã«ããåç§°ã«ãè¹æ©åžããå«ãŸãããã®ãåè£ãšããŠäžŠãã§ããŸãã

ãè¹æ©åžãã¯å
šãŠå
é ã®100%äžèŽãåã£ãŠããã®ã§ãã§ãã¯ã2ã€ä»ããâ¡ïŒãã®é
ç®ããã®ã»ã«ãšåãå
šã»ã«ã«ãããïŒãéžã³ãåæ§ã®äžèŽã«å
šãŠé©çšãããŸãã

äžæ°ã«æ°ãæžããããš3ã€ã®èªæ²»äœã ãã«ãªããŸããããç¥åŽçºãã¯100%äžèŽã2ä»¶ããã®ã§1ä»¶ç®ã«ããŠã¹ã«ãŒãœã«ãåœãŠããšWikidataã®è©²åœããŒãžããã¬ãã¥ãŒãããæŠèŠèª¬æã§ãããæ£ããçºåã§ããããšãåãããŸãã®ã§ãããããã§ãã¯ããŸãã

以äžããé·çæããçœåçºããåæ§ã«åŠçããŸãã
ãnoneãã0ä»¶ãšãªããã€ãŸãå
šãŠäžèŽããŸããã

ããã§å°ãªããšãWikidataã®æã€åžçºæåãšã¯å
šãŠçŽä»ãããããã€äžèŽããŠãããšããæ€èšŒãã§ããŸããã
ç §åæžã¿ã®ã»ã«ã¯ãŠã£ãããŒã¿ã®ãªããžã§ã¯ãïŒé ç®ïŒãšãªã³ã¯ããããã«å éšã«ã¯ãã®ãªããžã§ã¯ããäžæã«èå¥ãããŠã£ãããŒã¿ã®IDã§ããQçªå·ïŒåèåžãªããQ170616ãïŒãä¿æããŠãããQçªå·ãããã°ãã€ã¬ã¯ãã«ãŠã£ãããŒã¿äžã®ãªããžã§ã¯ããèå¥å¯èœã«ãªããŸãã詳现ã¯å¥ã®æ©äŒã«ã
åžçºæåå€å®ãã¡ã»ãããXã§æ¶ããŠè¡šç€ºãæ»ããŸãã
åžçºæå衚èšã«èª€ããç¡ãããšãæ€èšŒã§ããŸããããåæã«WikidataãšçŽä»ããããã®ã§Wikidataãæã€å±æ§æ
å ±ïŒããããã£ãšå€ã®çµã¿åãããããªããæãïŒãåç
§ã§ããããã«ãªããŸããã
ãâŒåžçºæåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒç
§åå€ããã«ã©ã ãäœã ãšéžã³ãŸãã

ããã§Wikidataã®ããããã£ãæå®ããŠããã®å€ãæ°ããªã«ã©ã ãšããŠåºåããããšãã§ããŸãã

ã©ã®ãããªããããã£ãããã®ããWikidataã®å³äžã®æ€çŽ¢çªã§åžçºæã®äŸãšããŠãåèåžããæ€çŽ¢ããŠã¿ãŸãã
ãåèåžããšããé
ç®ã®ããŒãžãéããšãããããã£ãšå€ã®çµã¿åãããããªããæãã倿°ç»é²ãããŠããŸããããã§ã¯äžã®æ¹ã«ãããå
šåœå°æ¹å
Œ
±å£äœã³ãŒãããšããããããã£ã®å€ïŒåèåžãªãã121002ãïŒãååŸããŸãã

OpenRefineã®ç»é¢ã«æ»ã£ãŠãAdd Propertyãæ¬ã«ãå
šåœå°æ¹å
Œ
±å£äœã³ãŒãããšå
¥åããŸãã

ãã®çŽäžã«Wikidataãæã€é¡äŒŒåã®ããããã£ã®åè£ã衚瀺ãããã®ã§ãããéžæããŸãã
ãã°ããåŸ
ã€ãšå³åŽã«ååŸããå€ããã¬ãã¥ãŒè¡šç€ºãããã®ã§ãOKãã

ç
§åãšåãããã«Wikidataãåç
§ããŠãããã«ãå
šåœå°æ¹å
Œ
±å£äœã³ãŒããã«ã©ã ãäœæããå€ãèšå®ãããŸãããåèåžã ãã§ãªããäžèЧã«ããçºæåå
šãŠã«å¯Ÿå¿ãããã®ãååŸã»èšå®ãããŸãã

ãã®ããã«OpenRefineã䜿ããšããŒã¿ã®ã¯ã¬ã³ãžã³ã°ã ãã§ãªããå€éšããååŸããããŒã¿ã§å
å®ïŒãšã³ãªããïŒãããããšãå¯èœã§ãã
ããã§ååŸãããå
šåœå°æ¹å
Œ
±å£äœã³ãŒããã¯åŸã§ç
é¢ã®æ³äººåãåå¯ãããéã®è£å©æ
å ±ãšããŠäœ¿çšããŸãã
2 æœèšåïŒç é¢åïŒ
2.1 æ¹éæ€èš
ãããŸã§ç
é¢åãæ³šæããŠèŠãããšã¯ãªãã£ãã®ã§ãããäžèЧãçºãã€ã€å°ã調ã¹ãŠã¿ããš

1)æ³äººæ Œã®çš®é¡ïŒäŸïŒå»ïŒïŒ
2)æ³äººåïŒäŸïŒæ¡äŒžäŒïŒ
3)ç
é¢åïŒäŸïŒè€äºã¯ãªããã¯ïŒ
ãšãã3ã€ã®å
å®¹ãæžŸç¶äžäœãšãªã£ãŠããªãããªãŒãã ãªè¡šèšãçã¿åºããŠããæš¡æ§ã§ãã
ããããã®åŸåãšããŠã¯å€§ããã®ãç
é¢ãã§ã¯äžèš3ç¹ã衚èšããããã以å€ã®ã蚺çæãã§ã¯ç
é¢åã ãã衚èšãããŠããããã«èŠããã®ã§ãæ³äººåããããã®ã¯ããããç¡ããã®ã¯ç
é¢åã§åå¯ãããŠã¿ãããšã«ããŸãã
ãã®éãæ³äººæ Œã®çš®é¡ãæ©æ¢°çã«æŽåããã®ã¯è³é£ã«æãããããéã«æ³äººæ Œã®çš®é¡ãåã£ãŠåå¯ãããæ¹éãšããŸããã
2.2 æœèšåãã³ããŒããŠæ³äººæ Œã®çš®é¡ãé€å»
ãâŒæœèšåãã®âŒãã¯ãªãã¯ã㊠ããã¹ããã£ã«ã¿ãŒ ãéžã³ãå·Šãµã€ãã®æœèšåãã£ã«ã¿ãŒã§ãâ¡æ£èŠè¡šçŸãããã§ãã¯ããŠè©²åœããããªæåãåæããŠã¿ããš

[瀟å£|財å£|æ³|ïŒ]
ã§ããããæ³äººã®çš®é¡ã衚èšãããè¡ãæœåºã§ããŸããã
2.3 æ³äººåãšç é¢åãåå²
æ£ç¢ºã§ã¯ãããŸããããæ³äººåãšç é¢åã䜵èšãããŠããå Žåã«ã¯ã ãããåè§ã¹ããŒã¹ã§åºåãããŠããã®ã§ããããå ã«æ³äººåãšç é¢åã®ã«ã©ã ã远å ããŸãã
2.3.1 ãã£ã«ã¿ãŒãå€ã
æœèšåãã£ã«ã¿ãŒãXã§ãã£ããéããŠ
ãâŒæœèšåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒè€æ°ã®ã«ã©ã ã«åå² ãšéžã³
åºåãæåã«ã ãïŒåè§ã¹ããŒã¹ïŒãèšå®ãããâ¡ãã®ã«ã©ã ãåãé€ããã®ãã§ãã¯ãå€ããŠãOKãã

ãæœèšå6ããŸã§ã§ãã¡ãããŸããw

åè§ã¹ããŒã¹ãå€çšããŠãããã®ããã£ããããªã®ã§ãå€ãéçŽããŸãã
ãŸãã«ã©ã åããã«ã©ã ç·šéïŒã«ã©ã åã倿Žãããã§äžèšã®ããã«å€æŽããŠåãããããããŸãã
æœèšå1 -> æ³äººå
æœèšå2 -> ç
é¢å
2.3.2 æäœæ¥ã§å€ãç§»å
次ã«ãåŸãã®ã«ã©ã ããé ã«æŽåœ¢ããŠãå€ãéçŽããŸãã
ãâŒæœèšå6ãã§âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãŸãã
æå¹ãªå€ã2ä»¶ãããŸãããæœèšå6ãã¡ã»ããã§ãŸã1ä»¶ç®ãéžã³ãŸãã

ãæœèšå6ãã®å€ããç
é¢åãã«ã©ã ãžæåã§ç§»ããŸãã
2ä»¶ç®ã¯ãæœèšå6ãã®å€ããç
é¢åãã«ã©ã ãžããã以å€ããæ³äººåãã«ã©ã ãžç§»ããŸãã

ãæœèš6ãã®å€ã¯å
šãŠãã©ã³ã¯ã«ãªã£ãã®ã§ãã«ã©ã ç·šéïŒãã®ã«ã©ã ãåãé€ããã§åé€ããŸãã

以äžåæ§ã«ååããæ³äººåãããç
é¢åããžå¯ããŠãæœèš3ããŸã§åãé€ããŸãã

2.3.3 æ³äººåã®æŽåœ¢
次ã«ãæ³äººåãã«ã©ã ããéå€ãªè¡šèšã®æ³äººçš®å¥ãåãé€ããŠæ³äººåã ãã«æŽåœ¢ããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ããã¹ããã£ã«ã¿ãŒ ãéžã³ãå·Šãµã€ãã®æ³äººåãã£ã«ã¿ãŒã§ãâ¡æ£èŠè¡šçŸãããã§ãã¯ããŸãã
[瀟å£|財å£|æ³|ïŒ]

ãããããæ³äººçš®å¥ã«çžåœããæååãåºçŸãããã¿ãŒã³ããšã«ç©º("")ã«çœ®ãæããŠãããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒå€æ ãéžã³ãäžèšã®åŒãé ã«å
¥åããŠãã¬ãã¥ãŒã§ç¢ºèªããªããç¹°ãè¿ãå®è¡ããŸãã

replace(value,"å»ïŒ","")
replace(value,"å»çæ³äººç€Ÿå£","")
replace(value,"å»çæ³äºº","")
replace(value,"å
¬çè²¡å£æ³äºº","")
replace(value,"ç¬ç«è¡æ¿æ³äºº","")
replace(value,"äžè¬ç€Ÿå£æ³äºº","")
replace(value,"å»çç€Ÿå£æ³äºº","")
replace(value,"財å£","")
replace(value,"瀟å£","")
replace(value,"ïŒå»ç€ŸïŒ","")
replace(value,"åœç«ç ç©¶éçºæ³äºº","")
replace(value,"瀟äŒçŠç¥æ³äºº","")
replace(value,"瀟äŒ","")
replace(value,"åŠæ ¡æ³äºº","")
replace(value,"åœç«å€§åŠæ³äºº","")
replace(value,"å»ç€ŸïŒ","")
replace(value,"äžè¬æ³äºº","")
å°ãæ®ããŸãããæ³äººçš®å¥ã¯ç¡ããããªã®ã§ãããŸã§ã«ããŸãã

ãã¡ã»ãããå
šãŠè§£é€ããŠ
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãéžã³ãããã«å·Šãµã€ãã®æ³äººåãã¡ã»ããã§ãtrueãïŒæ³äººåã空çœïŒãéžã³ãŸãã

5ä»¶ã»ã©æ³äººåããããã®ãä»ããŠãããã®ãããã®ã§åãåã£ãŠæ³äººåã«ã©ã ã«ç§»ããŸãã
æ³äººåãšç
é¢åãåºåããŠããªããã®ãçµæ§ãããããªã®ã§æ¹ããŠãæ³äººåãã確èªããŸãã
æååæ«å°ŸããäŒãã§ç¡ããã®ãæ¢ãããšã«ããŸãã
ãã¡ã»ãããè§£é€ããŠ
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãéžã³ãäžèšã®ããã«ãå
¥åããŠãOKãã
ã«ã©ã åïŒæ«å°Ÿ
åŒïŒsubstring(value,(length(value)-1))

ãâŒæ«å°Ÿãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãéžã³ãå·Šãµã€ãã®ãã¡ã»ããã§ãäŒããéžãã§ãããã«ãå転ããããŸãã

æ³äººåæ«å°ŸããäŒã以å€ã®ãã®ã衚瀺ãããŸãããããããããã«æ³äººåã«ãäŒããå«ããã®ãæ¢ããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ããã¹ããã£ã«ã¿ãŒãéžã³ãå·Šãµã€ãã®ãã£ã«ã¿ãŒã§ãäŒããå
¥åããŸãã

139ä»¶ãšçµæ§ããã®ã§äžæ¬ããŠåå²ããäžã§ãæ³äººåãç
é¢åããããã®ã«ã©ã ã«ç§»ããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒè€æ°ã®ã«ã©ã ã«åå² ãéžã³ãŸãã

åºåãæåã«ãäŒããèšå®ãããâ¡ãã®ã«ã©ã ãåãé€ããã®ãã§ãã¯ãå€ããŠãOKãã
ãæ³äººå2ãã§ ãã¡ã»ããïŒããã¹ããã¡ã»ãã ããå€ã確èªãããš

åè§ã¹ããŒã¹5ä»¶ãããã®ã§ããã空çœã«ããŸãã
ãç
é¢åãã«ã©ã ã§ããã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãéžã³ãå·Šãµã€ãã§ãtrueããæå®ããŸãã

ãæ³äººå2ãããç
é¢åãã«ç§»ããŸãã
ãâŒç
é¢åãã®âŒãã¯ãªãã¯ã㊠ã»ã«ç·šéïŒå€æ ãšéžãã§ãåŒã«äžèšãæå®ããŠãOKãã
cells["æ³äººå 2"].value

å·Šãµã€ãã§ç
é¢åã®ç©ºçœãã¡ã»ãããè§£é€ããŸãã

ãæ³äººå2ãããç
é¢åãã«ã³ããŒãããŸããã
ãæ³äººå2ãã ã«ã©ã ç·šéïŒã«ã©ã ãåãé€ã ã§åé€ããŸãã
ãæ³äººå1ãã«ãäŒããé€ããæ³äººåãå
¥ã£ãŠããã®ã§ãæ¹ããŠãäŒãã远å ããŸãã
ãâŒæ³äººå1ãã®âŒãã¯ãªãã¯ã㊠ã»ã«ç·šéïŒå€æããšéžãã§ãåŒã«äžèšãæå®ããŠãOKãã
value+"äŒ"

ãã®å€ããæ³äººåãã«ã©ã ã«äžæžãããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã»ã«ç·šéïŒå€æ ãšéžãã§ãåŒã«äžèšãæå®ããŠãOKãã
cells["æ³äººå 1"].value

ç§»ãçµãã£ãã®ã§ãæ³äºº1ããåé€ããŸãã
ãâŒæ³äººå1ãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ãåãé€ã ãšéžãã§ãOKãã

ãã£ãšãæ³äººå3ããæ®ã£ãŠããã®ã«æ°ã¥ããŸããã
ãâŒæ³äººå3ãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžãã§å·Šãµã€ãã®æ³äººå3ãã¡ã»ããã§1ä»¶ç®ãéžã³ãŸãã

ãå»çæ³äººç€Ÿå£ç§åäŒç§åäŒã¯ãªããã¯ããšãªã£ãŠããŸããç
é¢åããã¯ãªããã¯ãã ãã ãšæ Œå¥œãä»ããªãã®ã§æ³äººåã2åç¹°ãè¿ãããããšã«ãªã£ããã§ãããããåã«ã©ã ãæŽåœ¢ãçŽããŸãã

2ä»¶ç®ãéžã³ãŸãã

ãããåãçç±ã®ããã§ãããåæ§ã«æŽåœ¢ããŸãã
0ä»¶ã«ãªã£ãã®ã§ãæ³äººå3ãã«ã©ã ãã«ã©ã ç·šéããåé€ããŸãã
ãæ«å°Ÿãã«ã©ã ããã䜿çšããªãã®ã§åé€ããŸãã
å·Šãµã€ãã®ãã¡ã»ãã/ãã£ã«ã¿ãŒãå
šãŠè§£é€ããŸãã

ããã§ãæ³äººåããšãç
é¢åãã®åå²ã¯ããããã§ããŸãããã埮調æŽãæ®ã£ãŠããã®ã§æ¹ããŠå€ã確èªããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãŸãã

äžãã2ä»¶ã«ãŽããæ®ã£ãŠããã®ã§å·Šãµã€ãã®ãã¡ã»ããäžã§æŽåœ¢ããŸãã
ããããã¡ã»ããå
1ä»¶ç®ã®ä»¶æ°ã2ä»¶ãšãªã£ãŠããŸãããããªäºæãããŸãããæ³äººå:ç
é¢åããã1:nãã®ã±ãŒã¹ã§ãããããèŠãªãã£ãããšã«ããŠå
ã«é²ã¿ãŸãw
ãâŒç
é¢åãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãŸãã

å·Šãµã€ãã®ãã¡ã»ããããã©ãŠãºãããšãåèããšããç
é¢åããããŸããã
éžãã§ã¿ããšæœèšåããè³ç¥çµå
ç§ åèããšãªã£ãŠããŸããããã¯åå²ããªãæ¹ãè¯ãããã§ãããæ³äººåã®æ¹ã«å¯ããŠãããŸãã
ããã«èŠãŠãããšãç
é¢ããšãåé¢ããšããã®ããããŸãããããã¯ãã¡ã§ãããéžãã§ã¿ããš

ã©ããŸã§ãæ³äººåã§ç
é¢åãªã®ããäžç¥ããŠã¯åãããŸããããããããŠã§ããµã€ãã§ç¢ºèªãããš
ãå»çæ³äººæ²çžåŸ³æŽ²äŒåè埳掲äŒç
é¢ã
ãå»çæ³äººç€Ÿå£èä»äŒçœäºèä»äŒç
é¢ã
ãããã®ã§ãããããæŽåœ¢ããŸãã
ãåé¢ããéžã¶ãšæœèšåããå·äžèšºçæ åé¢ããšãªã£ãŠãããããã¯åå²ã§ããªããšã¿ãã¹ãã§ããããã

æ³äººåã®æ¹ã«å¯ããŠæŽåœ¢ããŸãã
æ¹ããŠãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžãã§å·Šãµã€ãã®ãã§ã»ããã§å€ã確èªããŠã¿ãŸãã

空çœã7ä»¶ããããããããç
é¢åãã«å¯ããããŠããŸãã
ãã®ãŸãŸã§ãééãã§ã¯ãããŸããããäžæ¬åŠçã®ããã«ã¯ã«ã©ã ãå¯ããããŠããã»ããåŠçããããã®ã§ãã«ã©ã ç·šéã§äžèšåŒã䜿ã£ãŠå€ããæ³äººåãã«ã©ã ã«ã³ããŒãããããšã®å€ã空çœã«ããŸãã
cells["ç
é¢å"].value
æ¹è¡ã³ãŒãã®æ··åšããã§ãã¯ããŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ããã¹ããã£ã«ã¿ãŒ ãšéžãã§å·Šãµã€ãã®ãã§ã»ããã§ã\nããšå
¥åããâ¡æ£èŠè¡šçŸãããã§ãã¯ããŸãã

2ä»¶ãããŸãããä»¶æ°ãå°ãªãã®ã§æåã§æŽåœ¢ããŸãã
ããã§ãæ³äººåããšãç
é¢åãã®åå²çµæã«ã€ããŠãäžéããã§ãã¯å®äºã§ãã
å·Šãµã€ãã®ãã¡ã»ãã/ãã£ã«ã¿ãŒãè§£é€ããŸãã

ãæœèšåãã«ã©ã ãå
ã
ãã£ãååã§ããæ³äººåãã«ã©ã ãæ³äººæ Œã®çš®é¡ãåãé€ãããã®ã§ãã
3 åœçšåºã®æ³äººçªå·APIã§åå¯ã
ãããŸã§æ³äººåã®æŽåœ¢ãé 匵ã£ãŠããã®ã¯ãåœçšåºã®æ³äººçªå·ã·ã¹ãã Web-APIãå©çšããŠåå¯ããããããã§ãããã®ãµãŒãã¹ã¯APIããŒã®ç³èŸŒã¿ãå¿
èŠã§ãããç³èŸŒæžãæžããŠéãã°ãå人ã§ããæ³äººã§ãããç¹ã«åé¡ãªããã°2é±éãããã§APIããŒãéµéãããŠããŸãã
倧éã¢ã¯ã»ã¹ã¯é¿ããããã«ãšã¯æžããŠãããŸãããç¹ã«æç¢ºãªæ°å€ã¯å®ããããŠããŸããããšã¯ããç¯åºŠããã£ãŠå©çšããã¹ãã§ãããããŸããã®APIãå©çšããŠãµãŒãã¹ãæ§ç¯ããå Žåãªã©ã¯ã¯ã¬ãžãã衚èšãæ±ããããŠããŸãã
3.1 API仿§
ãã¡ãã®
24ããŒãžãããã«æ³äººåã§æ
å ±ãååŸããããæ¹ãèšèŒãããŠããŸãã

ãã©ã¡ãŒã¿ã¯æŠç¥ä»¥äžã®éãã§ãã
id:APIããŒ(å®éã«è©Šãå Žåã¯èªåã§ååŸããŠãã ãã)
name:æ³äººå
mode:æ€çŽ¢ã¢ãŒã(1:åæ¹äžèŽæ€çŽ¢/2:éšåäžèŽæ€çŽ¢)
address:(çã³ãŒããŸãã¯åžåºçºæã³ãŒã)-> æ³äººåã ãã ãšååã®æ³äººãè€æ°è¿ãããå ŽåããããŸãã
type:å¿ç圢åŒ(01:CSV-ã·ããJIS,02:CSV-Unicode,12:XML-Unicode)
3.2 APIã®åäœç¢ºèª
以äžã®ãããªURLãã©ã¡ãŒã¿ã§è©ŠããŠã¿ãŸãã
3.2.1 æªçºèŠå¿ç
https://api.houjin-bangou.nta.go.jp/4/name?id=****&name=%E3%81%A1%E3%81%B0%E7%9C%8C%E6%B0%91%E4%BF%9D%E5%81%A5%E4%BA%88%E9%98%B2%E8%B2%A1%E5%9B%A3&mode=2&address=12&type=12
id:APIããŒ(äŒãããã®ãªã®ã§ãã®ãŸãŸå®è¡ããªãã§ãã ãã)
name:åèçåºå»å宀
mode:2(éšåäžèŽæ€çŽ¢)
address:12(åèç)
type:12(XML)
å¿çïŒ
<corporations> <lastUpdateDate>2020-06-05</lastUpdateDate> <count>0</count> <divideNumber>1</divideNumber> <divideSize>1</divideSize> </corporations>
ïŒcountïŒïŒ0ä»¶ãããã¯æ³äººåã§ã¯ãªãããã§ãã
ïŒcountïŒãããŒã¹ããã°è©²åœä»¶æ°ãæŸãããã§ãã
3.2.2 çºèŠå¿ç
https://api.houjin-bangou.nta.go.jp/4/name?id=****&name=%E6%A1%90%E4%BC%B8%E4%BC%9A&mode=2&address=12&type=12
id:APIããŒ(äŒãããã®ãªã®ã§ãã®ãŸãŸå®è¡ããªãã§ãã ãã)
name:æ¡äŒžäŒ
mode:2(éšåäžèŽæ€çŽ¢)
address:12(åèç)
type:12(XML)
å¿çïŒ
<corporations> <lastUpdateDate>2020-06-05</lastUpdateDate> <count>1</count> <divideNumber>1</divideNumber> <divideSize>1</divideSize> <corporation> <sequenceNumber>1</sequenceNumber> <corporateNumber>8040005014892</corporateNumber> <process>01</process> <correct>1</correct> <updateDate>2018-09-05</updateDate> <changeDate>2015-10-05</changeDate> <name>å»çæ³äººç€Ÿå£æ¡äŒžäŒ</name> <nameImageId/> <kind>399</kind> <prefectureName>åèç</prefectureName> <cityName>åèåžè¥èåº</cityName> <streetNumber>é«åçºïŒïŒïŒïŒçªå°</streetNumber> <addressImageId/> <prefectureCode>12</prefectureCode> <cityCode>104</cityCode> <postCode>2640024</postCode> <addressOutside/> <addressOutsideImageId/> <closeDate/> <closeCause/> <successorCorporateNumber/> <changeCause/> <assignmentDate>2015-10-05</assignmentDate> <latest>1</latest> <enName/> <enPrefectureName/> <enCityName/> <enAddressOutside/> <furigana>ããŠã·ã³ã«ã€</furigana> <hihyoji>0</hihyoji> </corporation> </corporations>
ïŒcountïŒïŒ1ä»¶è¿ãããŸãããæ£ãããã§ãã
ïŒcorporateNumberïŒïŒæ³äººçªå·ãæŸãããã§ãã
ïŒnameïŒïŒæ³äººçš®å¥ã®ä»ããæ³äººç»èšåç§°ãæŸãããã§ãã
ïŒprefectureNameïŒ:çåãæŸãããã§ãã
ïŒcityNameïŒïŒäœæååãæŸãããã§ãã
ïŒstreetNumberïŒïŒäœæåŸåãæŸãããã§ããäœæãå
šãŠçµåãããšãæ¢ã«ããäœæãšã®ãã§ãã¯ã«äœ¿ãããã§ãã建ç©åãéæ°ãéšå±çªå·ãªã©ã¯ãããŸããã
ïŒpostCodeïŒïŒéµäŸ¿çªå·ãæŸãããã§ãããã§ã«ããéµäŸ¿çªå·ãšã®ãã§ãã¯ã«äœ¿ãããã§ãã
3.3 APIåŒã³åºã
3.3.1 åæºå
3.3.1.1 åžåºçºæã³ãŒã
ååæ³äººã®ååŸãé¿ããããã«ãåžåºçºæã³ãŒãããã©ã¡ãŒã¿ã«è¿œå ãããšè¯ããããªã®ã§ãããåäœç¢ºèªãããšããæ¿ä»€åžã®åèåžã ãã¯åžã®ã³ãŒã100ã§ã¯ãªãããã®äžäœã¬ãã«ã®åºã³ãŒãïŒè¥èåºãªã102ïŒãå¿ èŠãªããã§ããåŸã£ãŠãåèåžã ãã¯çã³ãŒã(12:åèç)ã ãã§å®æœãããã以å€ã¯ããããã®åžåºçºæã³ãŒãã§å®æœããããšã«ããŸãã
3.3.1.2 æ³äººåç§°
æ³äººåç§°ã¯URLãšã³ã³ãŒãããŠããæž¡ã仿§ãªã®ã§ãããOpenRefineåŽã§ã®URLãšã³ã³ãŒããã©ãã«ãããŸãåããªãããå€éšãµãŒãã¹ãåããŠURLãšã³ã³ãŒãããçµæããURLãšã³ã³ãŒããã«ã©ã ã«å ¥ããŸãããæ®å¿µãã
2020/7/11è¿œèš äžèšã§URLãšã³ã³ãŒãã§ããããã§ãã
escape(value,'url')
ãŸããè±èšå·ã®ç€Ÿåãå«ããå
šãŠå
šè§ã«æããŠããå¿
èŠããããŸãã
ãã®æé ã¯ãããŸãã«ä»¥äžã®éãã§ãã
1)å³äžã®ãåºåããã¿ã³ãããã¿ãåºåãïŒTSVïŒã§åºåããéžãã§çŸåšã®ãããžã§ã¯ããTSVã«åºå
2)TSVããšãã£ã¿ã§éããŠgoogle spread sheetã«è²Œãä»ãããURLãšã³ã³ãŒããã«ã©ã ã远å
3)æ³äººåã«ã©ã ã®å€ãå
ã«å€éšãµãŒãã¹ã§URLãšã³ã³ãŒã
4)ãURLãšã³ã³ãŒããã«çµæã貌ãä»ã
5)google spread sheetå
šäœãã³ããŒããŠOpenRefineã«ã¯ãªããããŒããã貌ãä»ããŠæ°èŠãããžã§ã¯ããäœæ

以äžã¯æ°ããªãããžã§ã¯ãã§ã®æäœã§ãã
3.3.2 åèåž
ãâŒåžçºæåãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ãã¡ã»ãã ãšéžã³ãå·Šãµã€ãã®ãã¡ã»ãããŠã£ã³ããŠã§ãåèåžããéžã¶ã

åèåžåã®ã¿99件衚瀺ãããŸããã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒURLã§ã«ã©ã ã远å ãšéžã³ã以äžãèšå®ããŠãOKãã
æ°ããã«ã©ã åïŒåèåžå¿ç
ãã§ããééã®é
å»¶ïŒ1000
ãšã©ãŒïŒãâ¯ãšã©ãŒãä¿åãããã§ãã¯
åŒïŒ
"https://api.houjin-bangou.nta.go.jp/4/name?id=****&mode=2&type=12&address="+substring(cells["å
šåœå°æ¹å
Œ
±å£äœã³ãŒã"].value,0,2)+"&name="+value

ç»é¢äžéšã«é»è²å°ã®é²æçã衚瀺ãããŸãã100%ã«ãªã£ããå®äºã§ãã

3.3.3 åèåžä»¥å€
3.3.3.1 APIåŒã³åºã
äžèšåèåžãšåæ§ã®æäœã§åºåã«ã©ã åãšGRELåŒã ã倿ŽããŸããïŒå
šåœå°æ¹å
Œ
±å£äœã³ãŒãã®å
é 5æ¡ãåžåºçºæã³ãŒããšããŠã»ããããŸãïŒ
å·Šãµã€ãã®ãã¡ã»ãããŠã£ã³ããŠã§ãåèåžããéžã°ããç¶æ
ãããå転ãã§ãã以å€ãéžã³ãŸãã

åèåžä»¥å€ã615件衚瀺ãããŸããã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒURLã§ã«ã©ã ã远å ãšéžã³ã以äžãèšå®ããŠãOKãã
æ°ããã«ã©ã åïŒãã®ä»å¿ç
ãã§ããééã®é
å»¶ïŒ1000
ãšã©ãŒïŒãâ¯ãšã©ãŒãä¿åãããã§ãã¯
åŒïŒ
"https://api.houjin-bangou.nta.go.jp/4/name?id=****&mode=2&type=12&address="+substring(cells["å
šåœå°æ¹å
Œ
±å£äœã³ãŒã"].value,0,5)+"&name="+value

3.3.3.2 æ»ãå€ã®ç¢ºèª
空çœã®æ»ãå€ããªãã確èªããŸãã
ãâŒãã®ä»å¿çãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãšéžã³ãå·Šãµã€ãã®ãã®ä»å¿çãã¡ã»ããã§ãtrueããéžã³ãŸãã

6ä»¶ãããŸããããã®ä»å¿çãã«ã©ã ã«ãšã©ãŒå
容ãè¿ããŠãããŠããŸããããããã®ã¯ãããããã§ããã
ã»1ä»¶ç®ãš3ä»¶ç®ã¯ãããããé«ãããããããã¯ããã ããã«ãªã£ãŠããåé¡ã ãšæãããŸãããé«ãã«æžãæããŸãã
ã»2ä»¶ç®ã¯ç©ºçœãæ®ã£ãŠããŸãããæ³äººåã転èšããŸãã
ã»4ä»¶ç®ä»¥äžã¯åè§ã«ããããã®ã§å
šè§ã«æžãæããŸãã
ïŒæé ã¯çç¥ããŸããããšã©ãŒåã ãããçŽããŠçµæãããŒãžããŸãïŒ
å·Šãµã€ãã«ãã®ä»å¿çãã¡ã»ãããXã§éããŠãåèåžä»¥å€ãéžæãããç¶æ
ã«æ»ããŸãã
3.3.4 å¿çã®ããŒãž
ããã®ä»å¿çãã«ã©ã ã®å€ããåèåžå¿çãã«ã©ã ã«ã³ããŒããŸãã
ãâŒåèåžå¿çãã®âŒãã¯ãªãã¯ã㊠ã»ã«ç·šéïŒå€æ ãšéžã³ã以äžãèšè¿°ããŠãOKãã
åŒïŒ
cells["ãã®ä»å¿ç"].value

ãâŒãã®ä»å¿çãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ãåãé€ã ãšéžã³ã以äžãèšè¿°ããŠãOKãã
ãâŒåèåžå¿çãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒã«ã©ã åãå€æŽ ãšéžã³ãã«ã©ã åããå¿çãã«å€æŽã
ããã§åèåžãšãã以å€ã§ãã©ã¡ãŒã¿ãäžéšå€ããŠåŒã³åºããçµæãå
šãŠãå¿çãã«ã©ã ã«éçŽã§ããŸããã
å·Šãµã€ãã®ãã¡ã»ãã/ãã£ã«ã¿ãŒãå
šãŠéããŠå
šä»¶è¡šç€ºããŸãã
3.3.5 ä»¶æ°æœåº

å¿çã®äžããïŒcountïŒïŒãããããä»¶æ°ïŒã®å€ãæœåºããŸãã
ãâŒå¿çãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãšéžã³ã以äžãèšå®ããŠãOKãã
æ°ããã«ã©ã åïŒä»¶æ°
åŒïŒ
value.parseXml().select("count")[0].xmlText()

ãâŒä»¶æ°ãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãŸãã

3.3.6 å¿çã®åæ
ä»¶æ°ããšã«äžèº«ãèŠãŠå¯Ÿå¿æ¹éãèããŸãã
1件以äžãæ³äººç»èšäžã®åç§°ãšäžèŽããïŒåå¯ãã§ããïŒãã®ãšããããšã«ãªããŸãã
253/714ã§çŽ35%ãäžèŽãé 匵ã£ãå²ã«ã¯äžèŽçãçµæ§äœãã§ããæ®å¿µã
3.3.6.1 å¿ç0ä»¶
å·Šãµã€ãã®ä»¶æ°ãã¡ã»ããã§ã0ããéžã³ãŸãã
ãâŒæ³äººåãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãŸãã

å·Šãµã€ãã®ãã¡ã»ãããŠã£ã³ããŠã§å€0ãéžãã§æ³äººåããã©ãŠãºããŠã¿ããšãã»ãšãã©ããâ¯â¯äŒãã®ãããªæ³äººåããããã®ã§ã¯ãªããç
é¢åããããã®ã§ããå°èŠæš¡ã®å人çµå¶ãªã©ã®ç
é¢ã¯æ³äººç»èšäžã®ååã¯ç
é¢åãšã¯å¥ã«æã£ãŠããŠããã€ããŸã衚ã«ã¯åºããŠããªãããšãå€ããšããããšãªãã§ããããããããã¯åäººäºæ¥äž»ãªã®ã§ããããããããã«ããŠããã以äžã®è¿œè·¡ã¯ãšã³ãã¬ã¹ãªäœæ¥ã«ãªããããªã®ã§ãããŠãããŸãã
3.3.6.2 å¿ç1ä»¶
ä»¶æ°ã1ããéžã³ãŸãã
ç
é¢åãããå€ããããŸãããå€ãã¯â¯â¯äŒã§ãããã¡ãã«ã€ããŠã¯å¿çå
ã®æ³äººåãäœæã§ãå
ã«ã¯ã¬ã³ãžã³ã°ããããæ³äººçªå·ãšããäžæã®èå¥åãåŸããããããšãã§ããŸãã
ãURLãšã³ã³ãŒããã«ã©ã ã¯ãã䜿ããªãã®ã§ ã«ã©ã ç·šéïŒãã®ã«ã©ã ãåãé€ã ãšéžãã§åé€ããŸãã

詳现ã«ã€ããŠã¯åŸã§ãã§ãã¯ããŸãã
3.3.6.3 å¿ç2ä»¶
ä»¶æ°ã2ããéžã³ãŸãã

ãå¿çãã«ã©ã ã®å€ããã£ãšèŠãŠãããšããæ³äººåïŒç
é¢åãããïŒïŒïœãã®å Žåãã»ãšãã©ã§ãããæ³äººçš®å¥ã¯ç°ãªããæ³äººåãåäžãšãã奿³äººãäžèŽããŠããã±ãŒã¹ããããŸããããã¯å
ããŒã¿ã®äœæãªã©ãæãããã«ãåŸã§ã²ãšã€ãã€èŠãŠãããããããŸããã
3.3.6.4 å¿ç3ä»¶
ä»¶æ°ã3ããéžã³ãŸãã

該åœè¡ã¯1ä»¶ã ãã§ãããå¿çãã«ã©ã ã®å€ãèŠããš3ã€ããäœæãããããå
ããŒã¿ãšéã£ãŠãããäžèŽããŸããã
以äžã®ç·šéæ¹éãšããŠã¯ããä»¶æ°ãã«ã©ã ã0ã1ã§åœçšåºAPIã§åå¯ãã§ãããã©ããã®å€æãã©ã°ã®æå³ä»ããšããäžèŽã確èªããªãã0ãŸãã¯1ã«æžãæããŠããããšã«ããŸãã
å¿ç3ä»¶ã®ãã®ã¯ããããäžèŽããŠããªãã®ã§ãä»¶æ°ãã«ã©ã ã0ã«ããŸãã
3.4 å¿çããã®å€åãåºã
ãå¿çãã«ã©ã ããå€ãåãåºããŠãåŠçããããããŸãã
3.4.1 æäœå¯Ÿè±¡ãäžèŠ§è¡šç€º
å·Šãµã€ãã§æ³äººåãã¡ã»ãããXã§éããŠãä»¶æ°ãã¡ã»ããã§ã0ããéžã³ãããã«ãå転ãããŠ0件以å€ã®ãã®ãäžèŠ§è¡šç€ºããŸãã

3.4.2 å¿çããå€ãããŒã¹
ãâŒå¿çãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãšéžã³ãŸãã
以äžã®ããã«èšè¿°ããŠãOKãã§ã1ä»¶ç®ã®æ³äººæ
å ±ãæœåºããŠå¥ã«ã©ã ã«åºåããŸãã
æ°ããã«ã©ã åïŒå¿çæ³äºº1
åŒïŒ
value.parseXml().select("corporateNumber")[0].xmlText()+":"+ value.parseXml().select("name")[0].xmlText()+":"+ value.parseXml().select("prefectureName")[0].xmlText()+ value.parseXml().select("cityName")[0].xmlText()+ value.parseXml().select("streetNumber")[0].xmlText()+":"+ value.parseXml().select("prefectureCode")[0].xmlText()+ value.parseXml().select("cityCode")[0].xmlText()+":"+ value.parseXml().select("postCode")[0].xmlText()+":"+ value.parseXml().select("furigana")[0].xmlText()

3.4.3 1ä»¶ç®ã®æ³äººæ å ±å€ãã«ã©ã åå²
ãå¿çãã«ã©ã ã¯ãã°ãã䜿ããªãã®ã§ ãã¥ãŒïŒã«ã©ã ãããã ã§é衚瀺ã«ããŠèŠãããããŸãã
ãâŒå¿çæ³äºº1ãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒè€æ°ã®ã«ã©ã ã«åå² ãšéžã³ãåºåãæåã«ã:ããæå®ããŠãâ¡ã»ã«ã¿ã€ããæšæž¬ãã®ãã§ãã¯ãå€ããŠãOKãã


ãå¿çæ³äººçªå·11ã-ãå¿çæ³äººçªå·16ãã®åã«ã©ã åãé©åãªååã«å€ããŠåãããããããŸãã
ããã«æ°ããéµäŸ¿çªå·ã«ã©ã ã§ ã»ã«ç·šéïŒå€æ ããäžèšãåŒã«èšå®ããŠãOKããšããŠã3æ¡ç®ã®åŸã«"-"ãå
¥ããŠå
ããŒã¿ãšåœ¢åŒãåãããŸãã
substring(value,0,3)+"-"+substring(value,3,7)

3.5 å ããŒã¿ãšååŸæ å ±ãšã®å·®åååŸ
3.5.1 ã«ã©ã ã®äžŠã³æ¿ã

èŠãããããããåã«ã©ã ãã ã«ã©ã ã®ç·šéïŒã«ã©ã ãå·Šã«ç§»å ãªã©ã§ã«æ¯èŒå¯Ÿè±¡ã©ãããé£ã«äžŠã¹ãŸãã

3.5.2 éµäŸ¿çªå·
å·®åãåã£ãŠæ¯èŒããŸãã
ãâŒç»èšéµäŸ¿çªå·ãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãšéžãã§ãå·Šãµã€ãã«çŸããç»èšéµäŸ¿çªå·ãã¡ã»ããã§ãfalseããéžã³ãŸãã

ãâŒç»èšéµäŸ¿çªå·ãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãšéžãã§ãäžèšãå
¥åããŠãOKãã
ã«ã©ã åïŒéµäŸ¿çªå·diff
åŒïŒ
diff(cells["éµäŸ¿çªå·"].value,value)

ãâŒéµäŸ¿çªå·diffãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãšéžãã§ãå·Šãµã€ãã«çŸããéµäŸ¿çªå·diffãã¡ã»ããã§ãfalseããéžã³ãŸãã

äžäžèŽã34ä»¶ãããã¯æ³äººãäžèŽããŠããªãããéµäŸ¿çªå·ãééã£ãŠãããïŒããããå
ããŒã¿åŽïŒã®ããããã§ãã
3.5.3 æ³äººå
å·Šãµã€ãã®ãã¡ã»ãã/ãã£ã«ã¿ãŒãå
šãŠXã§è§£é€ããŸãã
ãâŒç»èšæ³äººåãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãšéžãã§ãå·Šãµã€ãã«çŸããç»èšæ³äººåãã¡ã»ããã§ãfalseããéžã³ãŸãã

ãâŒç»èšæ³äººåãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãšéžãã§ãäžèšãå
¥åããŠãOKãã
ã«ã©ã åïŒæ³äººådiff
åŒïŒ
contains(value,cells["æ³äººå"].value)

ãç»èšæ³äººåãããæ³äººåããå«ãå Žåã¯ãtrueããåºåãããŸãã
3.5.4 åžåºçºæã³ãŒã
å·Šãµã€ãã®ãã¡ã»ãã/ãã£ã«ã¿ãŒãå
šãŠXã§è§£é€ããŸãã
ãâŒç»èšåžåºçºæã³ãŒããã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãšéžãã§ãå·Šãµã€ãã«çŸããåžåºçºæã³ãŒããã¡ã»ããã§ãfalseããéžã³ãŸãã

ãâŒç»èšåžåºçºæã³ãŒããã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãšéžãã§ãäžèšãå
¥åããŠãOKãã
ã«ã©ã åïŒåžåºçºædiff
åŒïŒ
diff(substring(cells["å
šåœå°æ¹å
Œ
±å£äœã³ãŒã"].value,0,5),value)

ãâŒåžåºçºædiffãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒã«ã¹ã¿ã ãã¡ã»ããïŒç©ºçœãã¡ã»ãã(null/空çœ) ãšéžãã§ãå·Šãµã€ãã«çŸããåžåºçºædiffãã¡ã»ããã§ãfalseããéžã³ãŸãã

äžäžèŽã34ä»¶ããããããã¯å
šãŠåèåžã§ããAPIããã¯åèåžã®ã³ãŒãã®äžäœã«ãããåºã®ã³ãŒããè¿ã£ãŠããŠããããã«äžäžèŽãšãªã£ãŠãããåã
ã«èŠãŠãããªããšå®éã«äžäžèŽãã©ããã¯åãããŸããã
3.6 å ããŒã¿ãšååŸæ å ±ãšã®äžèŽç¢ºèª
æ³äººã1ä»¶è¿ã£ãŠãããã®ã¯äžèŽããŠããå¯èœæ§ãé«ããšæãããŸãããå·®åæ å ±ãèŠæ¯ã¹ãªãããäžäžèŽã®ãã®ãæ¢ããŠãããŸãã
3.6.1 1ä»¶ã ãè¿ã£ãŠãããã®ã衚瀺
ãâŒä»¶æ°ãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžãã§ãå·Šãµã€ãã«çŸããä»¶æ°ãã¡ã»ããã§ã1ããéžã³ãŸãã

3.6.2 æ³äººåã®ç¢ºèª
äžã§ç»èšæ³äººåã«å
ã®æ³äººåãå«ãŸãããã®ã«ãtrueããç«ãŠãã®ã§ãããéžãã§ã¿ãŸãã
ãâŒæ³äººådiffãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãŸãã

å
šãŠãtrueãã§å«ãŸããŠããŸããèããŠã¿ãããã®æ³äººåãå
ã«APIãåŒã³åºããã®ã§åœç¶ã§ããã
å·Šãµã€ãã®æ³äººådiffãã¡ã»ãããXã§éããŸãã
3.6.3 åžåºçºæã³ãŒãã®ç¢ºèª
ãâŒåžåºçºædiffãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãå·Šãµã€ãã®åžåºçºædiffãã¡ã»ããã§ã(blank)ããéžãã§ãå転ããã空çœä»¥å€ãéžã³ãŸãã

åèåžãšåºã®ã³ãŒãã®éããªã®ããäœæãéã£ãŠããã®ãåãããŸããããäœæéãã§ããã°éµäŸ¿çªå·ãéãã¯ããªã®ã§ãã¡ãã®diffãæ¡ä»¶è¿œå ããŠã¿ãŸãã
ãâŒéµäŸ¿çªå·diffãã®âŒãã¯ãªãã¯ã㊠ãã¡ã»ããïŒããã¹ããã¡ã»ãã ãšéžã³ãå·Šãµã€ãã®éµäŸ¿çªå·iffãã¡ã»ããã§(blank)ãéžãã§ãå転ããã空çœä»¥å€ãéžã³ãŸãã

3ä»¶ç®ä»¥å€ã¯äœæãç°ãªãã®ã§éãæ³äººãšå€æã§ããŸããããã5ä»¶ã«ã€ããŠã¯ãä»¶æ°ãã«ã©ã ãã0ãã«ããŠäžäžèŽã«åé¡ããŸãã
3ä»¶ç®ã¯äœæã¯åãã§ãããéµäŸ¿çªå·ãç°ãªããŸããå
ããŒã¿ã®éµäŸ¿çªå·ã¯ãŠã§ããµã€ããšåãã§ãããéµäŸ¿çªå·æ€çŽ¢ããŠã¿ããšç»èšãšåã£ãŠããŸããããã¯åŸè
ãæ£ãããšã¿ãã¹ãã§ããããçµè«ãšããŠã3ä»¶ç®ã¯éµäŸ¿çªå·ãä¿®æ£ããŸãããäžèŽããïŒåå¯ãã§ããïŒãšããæ±ãã«ããŸããä»¶æ°ã¯ã1ãã®ãŸãŸãšããŸãã
å·Šãµã€ãã®éµäŸ¿çªå·diffãã¡ã»ããã§ãå転ããã¯ãªãã¯ããŠå
ã«æ»ãã空çœãéžã³ãŸãã

äœæäžäžèŽãèŠã€ãããŸãããæ³äººåã¯åã£ãŠããããã§ãããäœæãå°ãã ãéããŸããæ³äººã®ãªãã£ã¹ãšç
é¢ãå¥ãªãã§ããããä»¶æ°ãã0ãã«ããŠäžäžèŽã«åé¡ããŸãã
ãã以å€ã¯äžèŽããŠããŸããã
å·Šãµã€ãã®åžåºçºædiffãã¡ã»ãããXã§éããŸãã
éµäŸ¿çªå·diffãã¡ã»ããã§æ¹ããŠ(blank)ãéžãã§ãå転ãããŸãã
ãã®211ä»¶ã¯éµäŸ¿çªå·ãéã£ãŠããããŸã äžèŽã«åé¡ãããŠããŸããäœæã¯è¡šèšã®æºãã倧ããæ©æ¢°çãªæ¯èŒã¯ããïŒæ²Œãšãèšãããã§ãwïŒã®é åãªã®ã§ãããã§ã¯äººåã§ã²ãšã€ãã€ç¢ºèªããäœæãç°ãªããã®ã¯ä»¶æ°ãã0ãã«ããŠè¡ããŸãã
倧åãçºåãç°ãªããã®ã¯éããã®ãšå€æã§ããŸãããæ°åãå°ãã ãéããã®ã¯0ãš9ãªã©æ°åã®æã¡ééããããã®ã§ãŠã§ããµã€ãã§ç¢ºèªããŸããäœæãåããã®ã¯éµäŸ¿çªå·ã®ééãã§ããç»èšæ
å ±ãæ£ãšèããŠãåŸã§äžæ¬ããŠçœ®ãæããŸãã
ïŒäžç¥ïŒ
æä¿®æ£ãçµãããŸããã

9ä»¶ãæ³äººåãäœæã¯äžèŽããŠããããéµäŸ¿çªå·ã¯äžäžèŽãšããŠæ®ããŸãããäžæ¬ããŠç»èšéµäŸ¿çªå·ãäžæžãããŸãã
ãâŒéµäŸ¿çªå·ãã®âŒãã¯ãªãã¯ã㊠ã»ã«ç·šéïŒå€æ ãšéžã³ãäžèšã®åŒãå
¥åããŠãOKãã
cells["ç»èšéµäŸ¿çªå·"].value

ããã«éµäŸ¿çªå·diffã空ã«ããŸãã
ãâŒéµäŸ¿çªå·diffãã®âŒãã¯ãªãã¯ã㊠ã»ã«ç·šéïŒãã䜿ã倿ïŒã»ã«ã空çœã« ãšéžãã§ãOKãã

éµäŸ¿çªå·diffãã¡ã»ãããXã§éããŸãã
3.6.4 2ä»¶è¿ã£ãŠãããã®ã衚瀺
ä»¶æ°ãã¡ã»ããã§ã2ããéžã³ãŸãã

察象ã11ä»¶ãšå°ãªãã®ã§ããŸãç®ã§ç¢ºèªããŸãã
æ³äººåã¯æ¢ã«äžèŽããŠããã®ã§ãäœæãåã£ãŠããã°äžèŽãšå€æããä»¶æ°ãã1ãã«æžãæããŠãããŸãã
衚瀺ããªãã¬ãã·ã¥ãããšæ®ã4ä»¶ã«ãªããŸããã

3.6.5 2ä»¶ç®ãå ã«ç»èšæ å ±ãæŽæ°
å¿çã®ãã¡ããŸã æ³äºº1ä»¶ç®ããããŒã¹ããŠããªãã£ãã®ã§ã2ä»¶ç®ãããŒã¹ããŸãã
èŠåºããèŠããªããªã£ãŠãããå¿çãã«ã©ã ã®èŠåºãã ããã¯ãªãã¯ããŠåºããŸãã

ãâŒå¿çãã®âŒãã¯ãªãã¯ã㊠ã«ã©ã ç·šéïŒãã®ã«ã©ã ã«åºã¥ããŠã«ã©ã ã远å ãšéžã³ãŸãã
以äžã®ããã«èšè¿°ããŠãOKãã§ã1ä»¶ç®ã®æ³äººæ
å ±ãæœåºããŠå¥ã«ã©ã ã«åºåããŸãã
æ°ããã«ã©ã åïŒå¿çæ³äºº2
åŒïŒ
value.parseXml().select("corporateNumber")[1].xmlText()+":"+ value.parseXml().select("name")[1].xmlText()+":"+ value.parseXml().select("prefectureName")[1].xmlText()+ value.parseXml().select("cityName")[1].xmlText()+ value.parseXml().select("streetNumber")[1].xmlText()+":"+ value.parseXml().select("prefectureCode")[1].xmlText()+ value.parseXml().select("cityCode")[1].xmlText()+":"+ value.parseXml().select("postCode")[1].xmlText()+":"+ value.parseXml().select("furigana")[1].xmlText()

å床ãå¿çãã«ã©ã ã ãã¥ãŒïŒã«ã©ã ãããã ã§é衚瀺ã«ããŠäœæãèŠæ¯ã¹ãŸãã

äžèŽããªããã®ã¯ãä»¶æ°ãã«ã©ã ãã0ãã«ããŸãã
äžèŽãããã®ã¯ãä»¶æ°ãã«ã©ã ãã1ãã«ããåç»èšæ
å ±ã«ã©ã ã®å€ãäžæžãããŸãã

ããã§229/714ãåœçšåºã®APIã§åå¯ãã§ããŸãããçŽ1/3ãšããŸã ãŸã ã§ããç é¢åãç¹å¥ãªã®ãã©ããã¯ç¥ããŸããããæ³äººåã«ã沌ãããããšãããåãããŸãããæ¬åœã«ããããšãããããŸããw
ãŸãéåé·ããªã£ãŠããŸã£ãã®ã§åºåããŸããèªã¿ã¥ããã®ã§ããšã§çããããããããŸããã
ä»åæžããããªãã£ãäœæãšãžãªã³ãŒãã£ã³ã°ã®è©±ã¯æ¬¡åã«ã沌ã«ã¯èžã¿èŸŒã¿ãŸããã
