要点
- 日本国内向けの住所は、郵便番号と都道府県から建物・部屋へと詳細化します
- ローマ字表記の国際出力は通常、受取人と特定の場所で始まります
- 7 桁の郵便番号は通常 123-4567 として表示されます。
- 翻訳、ローマ字化、検証は別の操作です
執筆とレビュー
編集・レビュー方針- 執筆
- ランダムアドレスジェネレーター編集部
- レビュー
- 国際住所形式検討チーム
- 最終更新
- 日本語とローマ字の逆の住所順序、7 桁の郵便番号、国際ラベル文字の制約を見直しました。
2つの並び順は、単純な反転ではない
日本国内向けの住所は通常、郵便番号、都道府県、市区町村、町名・番地、建物・部屋、受取人の順に、広い地域から詳細な場所へと記載します。ローマ字表記の国際向け住所は、通常、受取人と建物・部屋から始まります。
生の文字列を反転しないでください。意味のある都道府県、市区町村、街区、建物フィールドを解析し、ターゲット言語でレンダリングします。
日本の住所データを国際フォームのフィールドに対応付ける
都道府県を address-level1 に、市区町村を address-level2 に、地区とブロックを 1 行目に、建物と部屋を 2 行目にマッピングします。レビューと将来の解析のために、解析されていないオリジナルを保存します。
| 汎用フィールド | 日本語の意味 | 例 |
|---|---|---|
| postal-code | 7桁の郵便番号 | 100-0005 |
| address-level1 | 都道府県 | Tokyo |
| address-level2 | 市区町村または区 | Chiyoda-ku |
| address-line1 | 地区、丁目、街区 | Marunouchi 2-4-1 |
| address-line2 | 建物と部屋 | Sample Building 501 |
7桁の郵便番号入力と表示
通常の表示は 3 桁、ハイフン、4 桁です。先頭のゼロを保持するには、テキストとして保存します。フォームは郵便マークを受け入れることができますが、郵便番号の値とは別に格納する必要があります。
function normalizeJapanPostcode(value) {
const digits = value.replace(/[^0-9]/g, '');
return digits.length === 7 ? `${digits.slice(0, 3)}-${digits.slice(3)}` : value.trim();
}ローマ字表記は、情報を失わない英訳ではない
日本語のソーステキストとユーザーが確認したローマ字形式を別々に保存します。名前や建物には複数の確立されたスペルが存在する可能性があるため、レンダリングのたびにそれらを再生成することは避けてください。
日本郵便のラベルチャネルには文字制限があります。ラベル印刷の受け入れとは別に、データベースの受け入れをテストします。
日本住所の回帰テスト用フィクスチャ
日本語のソース、ローマ字出力、空の建物行、および長い建物名を含めます。合成データは、特定のブロックの存在ではなく、構造をテストします。
- CSV で郵便番号の先頭のゼロを保持する
- 全角数字入力のポリシーを定義する
- 日本語とローマ字の値を別々に保存する
- 空の 2 行目を許可する
- 部屋番号を黙って切り捨てないでください
1つの住所レコードから2通りの出力順を確認する
同じ構造化フィクスチャから国内日本語版とローマ字国際版の両方をレンダリングします。 2 つのビューが無関係な生の文字列に依存している場合、部屋、建物、ブロックが変換されて残ったことを示す信頼できる方法はありません。代わりに、各セマンティック コンポーネントが 1 回だけ出現することを確認してから、ローカライズされた順序を確認します。
郵便番号をハイフンあり、ハイフンなし、郵便番号付きで入力します。 3 つの入力はすべて、診断用の生の値を保持しながら 1 つの正規表示に収束できます。スプレッドシート フィクスチャと API の間で先頭のゼロが消えることがないように、数字をテキストとして保存します。
最後に、実際の印刷チャネルをテストします。データベースは日本語のソース テキストを保存できますが、特定の国際ラベル サービスではより狭い文字セットが適用されます。送信元アドレスを変更するのではなく、チャネル制限としてそれを報告します。ユーザーが確認したローマ字表記は分離して再利用できるようにする必要があります。通信事業者の統合またはラベル テンプレートのバージョンが変更されるたびに、チェックを繰り返します。
- 1つの構造化レコードから2通りの出力を生成
- セマンティックコンポーネントが失われたり重複したりしていないことをアサートします
- 複数の郵便番号入力フォームを正規化する
- 実際の印刷チャネルでの文字サポートを確認する
よくある質問
英語の住所の順番は日本語と逆なのでしょうか？
大まかに言えばその通りですが、行や文字を反転するのではなく、解析されたコンポーネントをレンダリングします。
郵便番号ハイフンを保存する必要がありますか?
正規の 123-4567 を保存することも、個別のコンパクト値と表示値を保存することもできます。どちらの場合も、先頭のゼロは保持してください。
ローマ字表記を作成した後、日本語の原文を破棄してもよいですか？
いいえ、ローマ字表記は異なる場合があります。ソース テキストを保持しておくと、後で確認することができます。