Skip to content
This repository has been archived by the owner on Apr 17, 2018. It is now read-only.

pelias-deprecated/text-analyzer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Pelias Text Analyzer

Greenkeeper badge

Travis CI Status Gitter Chat

Overview

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

Installation

$ npm install pelias-text-analyzer

NPM

NPM Module

The pelias-text-analyzer npm module can be found here:

https://npmjs.org/package/pelias-text-analyzer

About

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.

Supported Parsers

Currently, there are 2 supported parsers:

As libpostal support increases, AddressIt support will be shelved.

Configuration

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.