This repository is part of the Pelias project. Pelias is an open-source, open-data geocoder originally built by Mapzen. Our official user documentation is here.
Module that performs analysis of a single line of input describing a location, breaking into its constituent parts (street, city, state, country, etc).
Note: this module has been merged back into pelias/api and is now deprecated
$ npm install pelias-text-analyzer
The pelias-text-analyzer npm module can be found here:
https://npmjs.org/package/pelias-text-analyzer
This package is responsible for textually analyzing a single line input into it's constituent parts. That is, the input 30 West 26th Street, New York, NY 10010 is parsed into:
{
number: '30',
street: 'west 26th street',
city: 'new york',
state: 'ny',
postalcode: '10010',
country: 'usa'
}
The parsed form is used by the API for more accurate searching and geocoding.
The point of this module isn't to hardwire Pelias to a certain text analyzer but to provide an interface for future work.
Currently, there are 2 supported parsers:
As libpostal support increases, AddressIt support will be shelved.
Selection of AddressIt or libpostal is made using the Pelias configuration value found in api.textAnalyzer, defaulting to addressit if not found. For example, this will use libpostal for text analysis in the text-analyzer project:
{
"api": {
"textAnalyzer": "libpostal"
}
}
To use the libpostal address parser, libpostal must be installed locally.
Even though this package supports libpostal, the Pelias API does not yet support everything that libpostal returns. We expect to fully support libpostal in the API by late August 2016.