法人番号APIのレスポンスに含まれる法人名について、全角英数字を半角英数字に正規化できるオプションを追加しました。 法人番号APIは、国税庁法人番号公表サイトで公表されているデータをそのまま出力していました。 例えば株式会社NTTドコモは、企業サイトではNTTドコモと半角英数字で表記していますが、法人番号データ上では全角英数字を使っています。 { ..., "name": "株式会社ＮＴＴドコモ", ..., } 今回のアップデートでは、normalize_name=trueというパラメーターを付与することで、この英数字を半角に変換できるようになりました。 curl -s -G -H "Authorization: Token $PRODUCTION_API_KEY" "https://api.kenall.jp/v1/houjinbangou?limit=1&normalize_name

APIキー管理機能リニューアル APIキーの管理機能をリニューアルしました。 以下の機能が追加されます。 キーごとに名前を追加できます。これにより、「開発用APIキー」「サイトA用APIキー」などの名称をつけてキーを管理できます。 キーごとに有効期限を設定できます。これにより、一定期間のみ有効なキーを作成できます。 キーごとにコメントを追加できます。これにより、名前以外の付加情報を自由記述できます。 2022/9/1(木)リリース予定の新プラン郵便番号プランおよび法人番号プランでは、さらに以下の機能が追加されます。 複数のAPIキーを追加できます。 APIキーの複製ができます。（名前やドメイン等の付加情報のみの複製で、キー本体をコピーするものではありません） 詳細はドキュメントを参照してください。 新プランの詳細については、こちらの記事を参照してください。 ケンオールについて 「かゆいとこ

平素よりケンオールをご利用いただきありがとうございます。 お客様により高品質なサービスを提供するため、プランをリニューアルいたします。 変更概要 (1) 郵便番号APIプランの刷新 お客様からの多様なご要望にお応えするため、郵便番号APIプランをスタンダードプランとしてリニューアルいたします。 スタンダードプランでは、郵便番号APIプラスプランと郵便番号APIプランを一つに統合し、郵便番号逆引きAPI機能をより安価にご利用になれます。 また、複数APIキー管理機能など、管理・運用においても役立つ機能を追加します。 複数APIキー管理機能については、本日リリースした新APIキー管理UIの記事も参照してください。 変更概要 (2) 法人番号APIプランの名称変更 法人番号APIプランは プレミアムプラン として名称変更いたします。 スタンダードプランに追加予定の管理機能はもちろん、法人番号デー

日本郵便様が公開している郵便番号データを利用しやすくするには、複雑な加工処理が必要になります。 ケンオール通信では、過去数回に渡り、郵便番号データの処理方法を解説してきました。 本シリーズの締めくくりとして、今までの解説をまとめて紹介します。 データは、記載がない限り2021-11-30のデータを用いています。 郵便番号データの処理方法まとめ 複数行の結合 括弧つきのレコードの分割 括弧内の処理 丁目 小字 京都の通り名 （その他） かぎ括弧 区切り文字 ビル郵便番号 まとめ ケンオールについて 郵便番号データの処理方法まとめ 郵便番号データ処理で押さえるポイントは4つ 郵便番号データを処理するには、以下の4つのポイントを押さえてください。 複数行に分割されたレコードを1行にまとめる 括弧つきのレコードを括弧の外側と内側で分割する 括弧内の文字列を処理する ビル郵便番号を処理する 複数行の

ケンオール通信第11号：括弧つきの町域(1) 括弧の内側と外側の分割では、括弧を含む町域を持つ郵便番号レコードの処理の前半部分として、主に括弧外の住所処理について紹介しました。 今回は、括弧内の住所処理を紹介します。 データは、記載がない限り2021-11-30のデータを用いています。 前回までと元データのバージョンが違いますのでご注意ください。 処理結果を確認してみたい方はこちらのデモから試してみてください。 括弧内の住所処理の基本方針 丁目の処理 範囲指定 「丁目」と同列の住所単位(1) 「地割」 「丁目」と同列の住所単位(2) 丁 番地や数字情報の処理 番地 区 （北海道の住所単位） 数字が併記されている場合 丁目の併記 番地の併記 「丁」の単位と大阪府堺市 次回予告 ケンオールについて 括弧内の住所処理の基本方針 ケンオールでは原則として「住所補完に役立つ情報を可能な限り保持する」

ケンオール通信第12号：括弧つきの町域(2) 丁目や番地の処理では、括弧内の処理のうち、丁目や番地などの数字情報を処理する方法について紹介しました。 今回は、小字、かぎ括弧、区切り文字の処理を紹介します。 データは、記載がない限り2021-11-30のデータを用いています。 処理結果を確認してみたい方はこちらのデモから試してみてください。 小字の処理 小字と数字の混在 小字 + 丁目 富山県射水市流通センター青井谷について コメント文字列 （丁目） かぎ括弧の処理 区切り文字 大分県大分市牧（白滝Ｂ・Ｃ）について 次回予告 ケンオールについて 小字の処理 数字でない文字列で、一部の例外（後述）を除いた文字列は全て小字として解釈します。 0580343 北海道 幌泉郡えりも町 東洋（油駒、南東洋、１３２～１５６、１５８～３５４、３６６、３６７番地） 展開すると以下のようになります。 番地は前

今回は、郵便番号データ内の括弧と括弧外の分割について紹介します。 データは、記載がない限り2021-05-31のデータを用いています。 ケンオールでどのようにパースされているかは、こちらのデモから試してみてください。 括弧つきの町域のパターン 町名 + 括弧（丁目、小字、番地など） 町名 + ビル名 + 括弧（階層） 町名 + 番地 + 括弧 町名、町名 + 括弧 町名 + 地割 + 括弧 ケンオールについて 括弧つきの町域のパターン 郵便番号データの町域には、括弧つきのものが多数存在します。 0600042: 北海道 札幌市中央区 大通西（１～１９丁目） こうしたレコードは10,592件あります。 この大通西（１～１９丁目）が町域にあたりますが、この構造は以下の5パターンに分かれます。 町名 + 括弧（丁目、小字、番地など） 町名 + ビル名 + 括弧（階層） 町名 + 番地 + 括弧

今回は、郵便番号データ内の町名を空にしなければいけない町域について紹介します。 データは、記載がない限り2021-05-31のデータを用いています。 ケンオールでどのようにパースされているかは、こちらのデモで試せます。 以下に掲載がない場合 ○○一円 ○○の次に番地がくる場合(○○は町名) ○○の次に番地がくる場合の歴史的背景 参考文献 ケンオールについて 更新履歴 町域に文字列が記載されているものの、コメントと同様の文字列のため削除しなければいけないパターンが存在します。 そのパターンは以下の通りです。 以下に掲載がない場合 ○○一円(○○は町名) ○○の次に番地がくる場合(○○は町名) 以下に掲載がない場合 以下に掲載がない場合とは、以降のレコードに掲載されていない住所の場合はこの郵便番号を使うよう指示しているコメント文字列です。 0600000: 北海道 札幌市 中央区 以下に掲載が

ケンオールブログ ケンオールは、オープンデータを活用する際に問題となる様々な課題を解決するソリューションとして、オープンデータの利用者に使いやすい環境を提供するプラットフォーム型サービスです。ケンオールは、株式会社オープンコレクターが開発・運営しています。 https://kenall.jp/

国税庁が公開する法人番号データをAPIで提供するサービス「ケンオール法人番号API」をリリースしました。 法人名を検索できるAPIデモはこちら 法人番号データとは？ 法人番号とは、国税庁によって全ての法人（国内・国外合わせて500万件以上）に付与された13桁*1の固有番号です。個人に付与されるマイナンバーと異なり、法人番号のマスターデータは公開されています。 国税庁は、この法人番号とそれに付随する以下の情報を合わせた基本3情報を、オープンデータとして公開しています。 - 商号または名称 - 本店または主たる事務所の所在地 ケンオール法人番号APIとは？ 法人番号データを使うことで、法人の正式な住所情報を簡単に取得できます。 ケンオール法人番号APIは、この法人番号データをAPIとして提供するサービスです。 ケンオール法人番号APIを使うことにより、例えば以下のようなシステムを簡単に作ること

ケンオールを今年の2月8日にリリースしてから半年が経ちました！ ご利用いただいている皆様、応援してくださっている皆様、本当にありがとうございます。 郵便番号検索APIサービスとして始まったケンオールも、この半年で新しい機能・サービスが少しづつ追加されてきました。 どのような変更があったのかを紹介していきます。 新しいAPI 市区町村API 郵便番号逆引き検索API(ベータ) 自己IPアドレス確認API (NEW!) 郵便番号ダウンロードAPI (NEW!) 法人番号API(ベータ) 新しいサービス エンタープライズプラン 請求書払い対応 今後について ケンオールについて 新しいAPI 市区町村API 4月には、都道府県以下の市区町村を取得する、市区町村APIの提供を開始しました。 都道府県コードを入力すると、その都道府県以下の市区町村の一覧を取得できます。 curl -s -H "Auth

今回は、郵便番号データ内の（その他）を含むレコードの処理について紹介します。 データは、記載がない限り2021-05-31のデータを用いています。 ケンオールでどのようにパースされているかは、こちらのデモから試してみてください。 前回の記事はこちらです。 （その他）の処理 ケンオールについて （その他）の処理 ケンオールでは、括弧書きで小字が含まれている郵便番号レコードについて、原則として小字なしのレコードを出力しています。 例えば、1030028 は、郵便番号データには以下のように記載されています。 1030028: 東京都 中央区 八重洲（１丁目） これは、ケンオールでは以下のように2つのレコードとして出力されます。 1030028: 東京都 中央区 八重洲 1030028: 東京都 中央区 八重洲 １丁目 ケンオールでは、郵便番号データのパースを可能な限り高精度に行っていますが、複雑

ケンオール料金表業務に合わせた様々なAPIを提供しています。 お気軽にお問い合わせください。 価格は全て税込です。 スタンダード郵便番号の検索、住所から郵便番号の逆引き、表記ゆれの訂正、住所の正規化機能、銀行情報APIをご利用いただけます。 ¥5,500 /月 このプランを申し込む

$ curl https://api.kenall.jp/v1/postalcode/?t=東京都千代田区麹町三丁目12-14麹町駅前ヒルトップ8F{ "version": "2022-01-31", "data": [ { "jisx0402": "13101", "old_code": "102", "postal_code": "1020083", "prefecture_kana": "トウキョウト", "city_kana": "チヨダク", "town_kana": "コウジマチ", "town_kana_raw": "コウジマチ", "prefecture": "東京都", "city": "千代田区", "town": "麹町", "koaza": "", "kyoto_street": "", "building": "", "floor": "", "town_part

今回は、郵便番号データ内のビル名の処理について紹介します。 データは、記載がない限り2021-05-31のデータを用いています。 ケンオールでどのように郵便番号を処理しているかは、こちらのデモから確認してみてください。 前回はこちらです。 PyData Osaka Meetupの発表スライドと動画はこちらです。 ビル郵便番号 町名とビル名を分割する 階層と郵便番号 ケンオールについて ビル郵便番号 郵便番号データの大半は、ある郵便区画に対して番号を割り当てたレコードとなっていますが、実は一部の高層ビルには階層ごとに郵便番号が割り振られています。 ここでは、このような郵便番号をビル郵便番号と呼びます。 1066101: 東京都港区六本木六本木ヒルズ森タワー（１階） なお、このビル郵便番号は、個別事業所番号とは別のものであることに注意してください。 このようなビルは、郵便番号データ内には84棟

ケンオールブログ ケンオールは、オープンデータを活用する際に問題となる様々な課題を解決するソリューションとして、オープンデータの利用者に使いやすい環境を提供するプラットフォーム型サービスです。ケンオールは、株式会社オープンコレクターが開発・運営しています。 https://kenall.jp/