qfz9527/addressparser

中文收货地址智能识别

dev-master 2023-11-21 06:04 UTC

This package is auto-updated.

Last update: 2024-09-21 07:51:39 UTC


README

Latest Version on Packagist Total Downloads Build Status StyleCI

中文收货地址智能识别

参考链接:

查看contributing.md以查看待办事项列表。

需求

  • PHP >= 7.1.0
  • Mbstring PHP 扩展

安装

通过 Composer

$ composer require zifan/addressparser

用法

$options = ['strict' => true]

$parser = new AddressParser($options);

$parser->handle('浙江省杭州市滨江区西兴街道滨康路228号万福中心A座21楼');

选项

类似数组的$options

[
    'dataProvider' => [
        'driver' => 'file'            // 驱动,默认file,其它方式(如数据模型)可自行扩展
        'path' => null,               // 指定省市区数据文件,默认从插件config文件夹中读取
    ],
    'enable_keywords_split' => false, // 是否启用关键词分割(适用于在淘宝、京东App上复制收货地址时开启,固定格式,拼多多不带关键字只是格式固定)
    'keywords' => [                   // enable_keywords_split 为 true 时才生效
        'person' => ['收货人', '收件人', '姓名'],
        'mobile' => ['手机号码', '手机', '联系方式', '电话号码', '电话'],
    ],
    'extra' => [                      // 额外提取字段
        'sub_district' => false,      // 村乡镇/街道(准确度低)
        'idn' => false,               // 身份证号
        'mobile' => false,            // 联系方式(手机号/座机号)
        'postcode' => false,          // 邮编
        'person' => false,            // 姓名(准确度低)
    ],
    'strict' => false,                // 是否对提取结果进行准确度校验、补齐
]

带关键字固定格式的收货地址示例

京东格式

姓名:张三
地址:浙江省杭州市滨江区 西兴街道 滨康路228号万福中心A座21楼

淘宝格式

收货人: 张三
手机号码: 158********
所在地区: 浙江省杭州市滨江区西兴街道
详细地址: 滨康路228号万福中心A座21楼

变更日志

请参阅changelog以了解最近的变化。

贡献

请参阅contributing.md以获取详细信息及待办事项列表。

安全

如果您发现任何安全问题,请通过电子邮件s443939412@163.com而不是使用问题跟踪器。

鸣谢

许可

MIT。有关更多信息,请参阅许可文件