node-postal

node-postal

这些是node.js绑定到libpostal的软件包，libpostal是一个快速、多语言的自然语言处理库,用于解析/规范化物理地址。libpostal是用C语言编写的,因为几乎所有其他语言都可以绑定到C语言。

使用

var postal = require('node-postal');

// 扩展API
postal.expand.expand_address('V XX Settembre, 20');

// 解析API
postal.parser.parse_address('Barboncino (first unionized pizza place in NYC), 781 Franklin Ave, Crown Heights, Brooklyn, NY 11238');

安装

在使用node绑定之前,您必须安装libpostal C库。请确保您具有以下先决条件:

在Ubuntu/Debian上

sudo apt-get install curl autoconf automake libtool pkg-config

在CentOS/RHEL上

sudo yum install curl autoconf automake libtool pkgconfig

在Mac OSX上

brew install curl autoconf automake libtool pkg-config

安装libpostal

git clone https://github.com/openvenues/libpostal
cd libpostal
./bootstrap.sh
./configure --datadir=[...some dir with a few GB of space...]
make
sudo make install

# 在Linux上, 最好运行
sudo ldconfig

安装node-gyp

然后全局安装node-gyp:

sudo npm install -g node-gyp

在Linux(Ubuntu)上安装node-gyp

首先确保您有:

1. gcc, g++ and make (在Ubuntu上运行 sudo apt-get install build-essential)
2. 带有所有开发头文件的NodeJS(如果使用像apt-get这样的包管理器,请遵循此处的说明: https://nodejs.org/en/download/package-manager/)
3. python 2.7

安装node绑定

npm install node-postal

兼容性

node-postal在大多数主要版本的Node(0.10+)上进行了持续集成测试。C++绑定是使用Nan编写的,它抽象了不同版本V8之间的API变化,因此最新版本的Node很可能会工作。

如果您在编译过程中遇到问题,请在Github上提交一个问题,并附上您的操作系统和Node版本以及npm install / node-gyp rebuild的输出。

测试

运行单元测试:

npm test

故障排除

安装libpostal: node-postal是对libpostal的一个薄层包装,libpostal是用C语言编写的。使用npm安装node-postal不会将libpostal作为依赖项安装。上述安装步骤将在您的操作系统的标准位置安装它,对于OS X和Linux来说是 /usr/local/include 和 /usr/local/lib。node-postal将在这些位置寻找C库。如果您在安装node-postal时遇到问题,请检查最近安装的libpostal库。

下载大文件 make过程下载了约750MB的数据,解压后约2GB(注意:这些是用于训练超过10亿个地址的机器学习模型的高质量模型,这就是需要这么多磁盘/内存的原因)。请确保configure命令中的--datadir参数(需要一个绝对路径)有足够的空间容纳这些模型。如果下载后出现错误,例如:

make[3]: *** [all-local] Error 1
make[2]: *** [all-recursive] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2

后续的安装步骤可能会出现问题。有时下载会中断。一旦下载完成,make脚本将解压缩langauge_classifier.tar.gz.X文件。如果您看到这些文件,说明下载可能已停止。请再次运行make脚本。

特别感谢

Lucas Hrabovsky (https://github.com/imlucas) 提供了关于使用Nan、node-gyp等的信息和示例。