ランダム住所生成
中国本土の省、都市、番地、郵便番号を含むランダムな住所をバッチで生成します。都道府県や都市によるフィルタリングがサポートされています。一度に最大 100 個のアドレスを生成できるため、テスト データの入力に適しています。
導入ドキュメント
インターフェース機能
このインターフェイスは、ランダムな中国本土の住所情報をバッチで生成するために使用されます。生成された住所データ構造は、州、市、地区、郡、番地、郵便番号、結合された完全な住所文字列を含む完全なものです。開発者は、国、県、市のパラメータを渡すことで、生成された住所に対して地域フィルタリングを実行して、特定の地域のランダムな住所データを取得できます。
リクエストと返却
リクエストパラメータには、生成数量 (「カウント」、一度に最大 100 アイテム)、国コード (「CN」などの「国」)、省 (「省」)、および都市 (「都市」) が含まれます。 インターフェースが正常に応答すると、「data」フィールドは JSON オブジェクトの配列を返します。各オブジェクトには、province (州)、city (都市)、district (地区)、street (番地)、zipCode (郵便番号)、および full (完全な住所) などのフィールドが含まれており、開発者が解析して直接使用するのに便利です。
使用シナリオ
- ソフトウェアのテストとデモンストレーション: 電子商取引、物流、テイクアウト、その他のシステムの開発とテスト段階では、機能検証とインターフェイスのデモンストレーションのために現実的な配送先住所データがバッチで生成されます。
- データベース充填: パフォーマンス テストやデータの感度解除のために、開発環境のデータベース用に大量のシミュレートされたユーザー アドレス情報を生成します。
- フォーム自動テスト: 自動テスト スクリプトで、ランダムで完全に構造化された住所入力ソースを提供します。
指示と制限事項
・ 1回のリクエストで生成されるアドレスの最大数は100です。
- インターフェイスによって生成される住所情報 (特に番地と番地) は、アルゴリズムのランダムな組み合わせによって生成され、実際の物理的な住所ではありません。これはテストとシミュレーションのみを目的としています。実際の物流流通や本人確認には使用しないでください。
- フィルタリング パラメータには正しい都道府県名と都市名を入力する必要があります。正しく入力しないと、生成が失敗するか、デフォルトのランダムなアドレスが返される可能性があります。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"count": 5,
"country": "CN",
"province": "广东",
"city": "深圳"
}レスポンス例
{
"code": "SUCCESS",
"message": "success",
"data": [
{
"province": "广东省",
"city": "深圳市",
"district": "南山区",
"street": "科技路88号",
"zipCode": "518000",
"full": "广东省深圳市南山区科技路88号",
"country": "CN"
}
]
}リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| count | number | 5 |
| country | string | CN |
| province | string | 广东 |
| city | string | 深圳 |
レスポンス項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | array | {"province":"广东省","city":"深圳市","district":"南山区","street":"科技路88号","zipCode":"518000","full":"广东省深圳市南山区科技路88号","country":"CN"} |
| data[] | object | {...} |
| data[].province | string | 广东省 |
| data[].city | string | 深圳市 |
| data[].district | string | 南山区 |