POSTshipping-address-parse
配送先住所解析
乱雑なテキストから中国の配送先情報(氏名、携帯電話番号、身分証明書番号、郵便番号、省/市/区、詳細住所)をスマートに識別・抽出します。単一および一括処理(1回最大200件)に対応し、一括処理時は携帯電話番号や氏名による重複排除が可能です。
導入ドキュメント
インターフェースの紹介
このインターフェイスは自然言語処理技術に基づいており、非構造化混合テキストから中国速達に関する重要な情報を正確に抽出できます。中核となる機能には、名前、携帯電話番号、ID 番号 (利用可能な場合)、郵便番号、および標準的な地方/市/地区/番地詳細の自動識別と分離が含まれます。
該当するシナリオ
- 電子商取引注文のクリーニング: ユーザーが手動で入力したあいまいな住所を自動的に標準化し、配送エラー率を削減します。
- CRM データ ガバナンス: 過去の顧客データをバッチで整理し、不足している管理部門フィールドを補完します。
- 物流システム統合: 注文プロセス中にリアルタイムで住所データを検証および構造化し、注文効率を向上させます。
リクエストと返品の手順
- リクエスト方法: POST
/v1/shipping-address-parse - 重要なポイントを入力:
addresses: 文字列配列。最大 200 個のアドレス テキストの 1 回の送信をサポートします。dedup: オプションの重複排除戦略。phone(携帯電話番号) またはname(名前) による重複のフィルター処理をサポートします。- 結果を返す:
- 解析された
name、mobile、province、city、region、streetおよびその他のフィールドを含む、標準化された JSON 構造を返します。 count(有効な数量)、originalCount(元の数量)、およびremoved(重複排除によって削除された数量) の統計情報を提供します。
提案へのアクセス
- バッチ処理: ネットワークのオーバーヘッドを削減し、スループットを向上させるために、処理するデータを集約し、バッチ (≤200 アイテム/回) で呼び出すことをお勧めします。
- 重複排除戦略: ビジネス シナリオが一意の連絡先に敏感な場合は、「dedup」パラメータを有効にして、同じユーザーの複数のアドレス レコードによって引き起こされるデータの冗長性を回避してください。
- 例外処理: 返される
codeステータス コードを確認してください。解析に失敗したフィールド (認識できない郵便番号など) の場合、システムは「null」を返すため、フロントエンドは null 値と互換性がある必要があります。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"addresses": [
"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000",
"李四 13900139000 北京市朝阳区建国路 88 号"
],
"dedup": "phone"
}レスポンス例
{
"code": "SUCCESS",
"message": "success",
"data": {
"count": 2,
"originalCount": 2,
"removed": 0,
"items": [
{
"name": "张三",
"mobile": "13800138000",
"idn": null,
"postcode": "518000",
"province": "广东省",
"city": "深圳市",
"region": "南山区",
"street": "科技园路1号",
"original": "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000"
},
{
"name": "李四",
"mobile": "13900139000",
"idn": null,
"postcode": null,
"province": "北京市",
"city": "北京市",
"region": "朝阳区",
"street": "建国路88号",
"original": "李四 13900139000 北京市朝阳区建国路 88 号"
}
]
}
}リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| addresses | array | "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000" |
| addresses[] | string | 张三 13800138000 广东省深圳市南山区科技园路 1 号 518000 |
| dedup | string | phone |
レスポンス項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.count | number | 2 |
| data.originalCount | number | 2 |
| data.removed | number | 0 |
| data.items | array | {"name":"张三","mobile":"13800138000","idn":null,"postcode":"518000","province":"广东省","city":"深圳市","region":"南山区","street":"科技园路1号","original":"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000"} |