daimon3332/address

これは何？

主な機能

• 01各国の行政区分に沿ったフィルターで、27の国・地域をカバー。
• 02各住所にデータの出典、マッチング精度、座標を含む。
• 03複数の中国語、日本語、韓国語、ヨーロッパ言語を含む10種類の表示言語に対応。
• 04リトライ回数の上限設定とデータソースの枯渇検出に対応した、差分バックグラウンド同期。
• 05単件・一括生成、場所検索、翻訳に対応したBearer認証付きAPI。
• 06初回起動時にシークレットを自動生成する、単一のDocker Composeによるデプロイ。

ユースケース

• チェックアウトや登録フォームのテストデータを入力する。
• 複数の国にまたがる住所形式を検証する。
• 物流や地図のデモに使う、実在感のある住所を作成する。
• テストパイプライン向けに、API経由で住所を一括生成する。

クイックスタート

1. 1

   Docker Composeファイルをダウンロード

   curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml
2. 2

   すべてのサービスを起動

   docker compose up -d
3. 3

   準備状況を確認

   curl -fsS http://127.0.0.1:8787/api/v1/ready

使う前に知っておきたいこと

• !Docker Engine 24以降とCompose v2を備えたLinux（AMD64またはARM64）が必要です。
• !最低4 GBのRAMが必要です。大規模な国のデータを初回インポートする場合は、8 GB以上を推奨します。
• !上流データセットには、それぞれ独自のライセンスと帰属表示要件が適用されます。

収録されている特集

トピック

よくある質問

address とは？

27の国・地域の公的住所台帳やオープンな地図データから実在する住所を取得する、セルフホスト型の住所生成ツール。 Addressは、ランダムに組み立てた文字列ではなく、実在する場所に対応した住所をテストやデモ用に生成します。各レコードは公的な住所台帳、オープンな地図データ、または検証済みのジオコーディング結果から取得され、データの出典、精度、座標を含みます。データがないフィールドは、値を補わず空のままにします。

address は無料で使えますか？ライセンスは？

address は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

address は今もメンテナンスされていますか？

活発にメンテナンス中。address の最終コミットは 2026年11月4日 です。

address は何に使えますか？

チェックアウトや登録フォームのテストデータを入力する。 複数の国にまたがる住所形式を検証する。 物流や地図のデモに使う、実在感のある住所を作成する。 テストパイプライン向けに、API経由で住所を一括生成する。

address のインストール方法は？

Docker Composeファイルをダウンロード: curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/daimon3332/address/main/docker-compose.yml すべてのサービスを起動: docker compose up -d 準備状況を確認: curl -fsS http://127.0.0.1:8787/api/v1/ready

address はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/daimon3332/address