はてなブックマーク

日本の祝日APIを2023年版に更新しました。 内閣府は毎年国民の祝日についてのCSVデータを公開しています。 このデータを使いたい人は年に1回ダウンロードすればいいだけなのですが、今回は少し事情が違います。 ファイル名が違う 昨年までのCSVファイルは以下のURLからダウンロードできました。 https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv 今年は以下のURLからダウンロードできます。 https://www8.cao.go.jp/chosei/shukujitsu/shukujitsu.csv ファイル名の二文字目がyからhに変わっています。 (2023/02/03 追記) 内閣府のページが更新され、元のファイル名syukujitsu.csvが使えるようになりました…が、なんと新しい方のファイルshukujitsu.csvは

指定した日付が休日かどうかをサクッとチェックしたいことはたまにあると思います。 休日をエクセルなどからサクッと簡単に確認にできる「法定休日確認API」を追加しました。 以下のようにパラメーターに日付を渡すだけで、その日が休日かどうかの判定を行うことが可能です。（現在は法定休日のみの判定に対応しています。） https://api.kenall.jp/v1/businessdays/check?date=2022-08-01 kenall.jp また、エクセルやスプレッドシートの関数に組み込むことで、以下のように一瞬で営業日の判定ができます。 上記のアドオンは以下のような関数をエクセルやスプレッドシートなどに組み込むことで実装できます。 /** * 営業日かどうかを判定する * @param {'2022-08-01'} date 判定したい日付 YYYY-MM-DD * @customfu

ECサイトや宅配サービスでよく使われる「※宅配ボックス希望」などの注釈は、システムが住所を解析する際に大きな障害となります。 ケンオールでは、こうした特別な注釈文字列を除去して解析できるように郵便番号逆引き・住所正規化APIをアップデートしました。 ECサイト・宅配サービス特有の住所に対応 ECサイトを使う際、宅配ボックス指定や時間帯指定などの配送方法について注文をしたい場合があります。 通常はECサイトや宅配サービスが提供する方法でそうした条件を指定しますが、住所欄にその旨を記述するという方法がインターネット上では知られています。 例えば、米印（※）で区切って注釈を記述する方法があります。*1 麹町三丁目12-14麹町駅前ヒルトップ8F※不在時宅配ボックス希望 麹町三丁目12-14麹町駅前ヒルトップ8F※16時以降不在時宅配ボックスへ 括弧でくくる場合もあります。 麹町三丁目12-14麹

アップデートのお知らせ(2022/03/15) 2022/03/15(火)にケンオールをアップデートしました。 アップデート内容は以下のとおりです。 新API: 日本の祝日API 郵便番号逆引き検索API: 品質の改善 祝日や休日のAPIについて、機能要望アンケートを募集中です！ 新API: 日本の祝日API 日本における祝日は、内閣府が毎年CSVデータを公開しています。 しかし、システムで祝日データを利用するとき、CSVをダウンロードし、それをシステムにロードするというのは意外と手間がかかります。 手動で更新する場合、手順自体を検証した上で運用ドキュメントを執筆する必要があります。 さらに、手動運用によるオペレーションミスのリスクも毎年つきまとうことになります。 自動化する場合、特別に祝日が移動するケースなどに対応できるようにしなければいけません。結局のところ手動でも更新できるようにして

まとめ 住所フォームの作り方 住所フォームを作るときには以下の4つを押さえましょう。 オートコンプリート機能に最適化する 郵便番号フィールドは1フィールドにしてハイフン有無どちらも対応する モバイルUX優先なら郵便番号が入力されたら即座に補完。精度優先なら郵便番号補完ボタンを設置 住所フィールドは「都道府県」「市区町村」「町名以下」の3フィールドが基本。「建物」フィールドはオプション 本文 地域SNSのユーザー登録、ECサイトの配送先入力、資料請求、自治体サイトでの電子申請など、ウェブサービスを活用する上で住所入力は欠かすことができません。 住所入力をシンプルかつ正確に行えるような入力インタフェース（住所フォーム）は、離脱率を減らし、コンバージョン率を向上させる上で重要です。 郵便番号を入力すると対応する住所を自動入力する機能（郵便番号による住所補完）は、住所フォームの改善方法として最も効

ケンオールは2022年2月8日でリリースから一周年になりました。 いつもご利用いただいているユーザーの皆様、本当にありがとうございます。 この一周年という節目に、ケンオールは大きな機能追加を実施いたします。 変更予定日は2/21（月）となります。 重要 ケンオールユーザーはシステム側の対応が必要となりますので本記事をご一読ください。同様の案内をメールでも送付させていただいております。 郵便番号逆引きAPI（正式版） フリーテキスト検索 住所正規化 法人番号API: 法人住所の住所要素分割フィールドを追加 郵便番号API: 個別事業所番号の住所要素分割フィールドを追加 リリースのスケジュールとシステム対応のお願い APIに対して直接リクエストしている場合、あるいは内製クライアントライブラリを開発している場合 公式JavaScript SDK kenall-js をご利用されている場合 ケンオ

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

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

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

自分のPCやサーバーに設定されたIPアドレスを確認するためのAPI、「自己IPアドレス確認API」の提供を開始いたしました。 ケンオールのアカウントがあればどなたでも無償でご利用いただけます。 使用方法は、/whoami エンドポイントにリクエストを送信するだけです。 curl -s -H "Authorization: Token $YOUR_API_KEY" \ https://api.kenall.jp/v1/whoami 以下のようなレスポンスが返ってきます。 { "remote_addr": { "type": "v4", "address": "<IPアドレス>" } } 現在はIPv4のみに対応しておりますが、IPv6にも将来対応予定です。 なぜこのAPIを提供したのか 自分のPCやサーバーに設定されたIPアドレスを確認するための無償サービスは数多く存在します。なので、今さら

ケンオール通信第4号では、郵便番号データの処理方法の最初の一歩として、複数行の結合について紹介しました。データ処理の続きを説明する前に、まず日本の住所とはどういう構造になっているかを紹介します。 日本の住所の構造 郵便番号データの住所構造 京都の通り名 地割 特定の番地に割り当てられた郵便番号 ビルに割り当てられた郵便番号 PyData.Osaka に登壇します ケンオールについて 編集履歴 日本の住所の構造 日本の住所は、領域の大きい地域名から小さい地域に向かって書いていくという構造です。この大から小という構造は、日本の他に中国や韓国、台湾などが用いており、東アジア諸国では一般的な記法ですが、世界的には小さい領域から大きい領域に向かって書いていくという記法が一般的です。 余談ですが、東アジア以外の全ての国が小から大という表記ではなく、ハンガリーなど一部の国で大から小という表記形式を採用し

2022/02/21 郵便番号逆引き検索APIを正式リリースいたしました！ ケンオールに、住所から郵便番号を検索できる、郵便番号逆引き検索機能が追加されました。 (このデモはこちらでお試しいただけます。) 例えば、京都市上長者町通堀川東入一町目という住所を検索してみます。この住所クエリは、上京区という文字が抜けている、不完全な住所になっています。 http://api-beta.kenall.jp/v1/postalcode/?q=city:京都市+AND+kyoto_street:上長者町通堀川東入+AND+town:一町目 上記のような部分検索であっても正しい郵便番号を検索できます。 { ... "postal_code": "6028064", ... "prefecture": "京都府", "city": "京都市上京区", "town": "一町目", "koaza": "",

2025-07-22 郵便番号検索APIの「大口事業所個別郵便番号データ」に関するお知らせ 平素よりケンオールをご利用いただきまして誠にありがとうございます。 このたび、ケンオールが取り扱う日本郵便提供のデータのうち、大口事業所個別郵便番号データを利用したAPIレスポンスにおいて、「郡」の情報が含まれていない不具合があることが判明し… 2025-03-03 学校コードAPIをリリースしました 学校に関する情報をより簡単に入手できるように、学校コードAPIをリリースしました。 プレミアムプランで利用可能なため、すでに法人情報API等をご利用のお客様は追加料金なしでご利用いただけます。 学校コードAPIは、お客様からご要望を頂戴し、ケンオール… 2025-03-03 ケンオールAPIバージョンの更新とご対応のお願い ケンオールAPIでは、APIリクエスト/レスポンス定義のAPIバージョンの違い