はてなブックマーク

指定した日付が休日かどうかをサクッとチェックしたいことはたまにあると思います。 休日をエクセルなどからサクッと簡単に確認にできる「法定休日確認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サイトの配送先入力、資料請求、自治体サイトでの電子申請など、ウェブサービスを活用する上で住所入力は欠かすことができません。 住所入力をシンプルかつ正確に行えるような入力インタフェース（住所フォーム）は、離脱率を減らし、コンバージョン率を向上させる上で重要です。 郵便番号を入力すると対応する住所を自動入力する機能（郵便番号による住所補完）は、住所フォームの改善方法として最も効

今回は、郵便番号データ内の町名を空にしなければいけない町域について紹介します。 データは、記載がない限り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アドレスを確認するための無償サービスは数多く存在します。なので、今さら

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": "",

2023-02-01 日本の祝日データの更新とファイル名の話 日本の祝日APIを2023年版に更新しました。 内閣府は毎年国民の祝日についてのCSVデータを公開しています。 このデータを使いたい人は年に1回ダウンロードすればいいだけなのですが、今回は少し事情が違います。 ファイル名が違う 昨年までのCSVファイルは以… 2022-11-01 2022年11月のリリース ケンオールユーザーの皆様、お待たせいたしました。本日、多数のアップデートを携えてのリリースを行います。 郵便番号データのローマ字出力に対応しました 住居表示地域かどうかを示すフラグを郵便番号APIに追加しました APIバージョニングを導入しました … 2022-11-01 住居表示地域かどうかを示すフラグを郵便番号APIに追加しました 郵便番号検索 この記事は2022年11月リリースでリリースされた機能の1つ、住居表示地域フ