本文へ移動

address-plusアドレスプラス

住所を端末の中で解析・確認・整形・比較し、国のモジュールや任意のフォームの入力欄を使えます。

address-plusは、parse-addressの使い方を広げ、型付きの結果、確認、書式、国のモジュールを加えます。 名前について(英語)

目次

やり方

郵便番号の地域を調べる

形式、収録データ、地域との対応を区別します。

収録された地域を読む

import { getStateFromZip,getProvinceFromPostalCode } from "@johnmorrisdotca/address-plus";
import { getPrefectureFromJapanesePostalCode } from "@johnmorrisdotca/address-plus/jp";
import { getStatesForAustralianPostcode } from "@johnmorrisdotca/address-plus/au";
console.log(getStateFromZip("98101"),getProvinceFromPostalCode("M5H 2N2"),getPrefectureFromJapanesePostalCode("530-0001"));
console.log(getStatesForAustralianPostcode("2618"));
WA ON 27
[ 'ACT', 'NSW' ]

番号には、形式が有効、表に収録済み、複数の地域に対応、表では不明という違いがあります。境界を越える配達のデータには、複数の地域を返す検索を使います。曖昧な結果や値がない結果を、推測した地域で置き換えません。先頭の番号の表は検索の助けで、すべての配達先の一覧ではありません。

国の郵便番号を調べる

import { parseUKPostcode } from "@johnmorrisdotca/address-plus/gb";
import { parseGermanPostcode } from "@johnmorrisdotca/address-plus/de";
import { parseFrenchPostcode } from "@johnmorrisdotca/address-plus/fr";
console.log(parseUKPostcode("ec1a1bb"),parseGermanPostcode("10115"),parseFrenchPostcode("75002"));
{
  postcode: 'EC1A 1BB',
  outward: 'EC1A',
  inward: '1BB',
  area: 'EC',
  district: 'EC1A',
  sector: 'EC1A 1',
  country: 'GB',
  nation: 'ENG'
} { postcode: '10115', state: 'BE', known: true } {
  postcode: '75002',
  place: '75',
  country: 'FR',
  known: true,
  department: '75'
}

正規化と収録データの確認は国ごとです。先頭の0を文字列として保ち、郵便番号を数値にしません。元の郵便の説明には形式、確認の項目、地域の検索があります。個別のAPIのページで、nullとundefinedの正確な意味を読めます。

ソースを見るGitHub で編集@johnmorrisdotca/address-plus 1.7.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。