Pelias
| Pelias | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Author: | Geocode Earth and pelias/pelias/graphs/contributors GitHub | |||||||||||||||||||
| License: | MIT License (free of charge) | |||||||||||||||||||
| Platform: | Cross-platform | |||||||||||||||||||
| Status: | Active | |||||||||||||||||||
| Language: | multiple languages
| |||||||||||||||||||
| Website: | pelias.io | |||||||||||||||||||
| Source code: | pelias/pelias GitHub | |||||||||||||||||||
| Programming language: | JavaScript | |||||||||||||||||||
|
Modular open source geocoder built on Elasticsearch | ||||||||||||||||||||
| ||||||||||||||||||||
Pelias is an open source geocoder for forward geocoding, reverse geocoding and autocomplete. It is built from open data, including OpenStreetMap, and runs on Elasticsearch. The project began at Mapzen in 2013 and is maintained by the same core team, now at Geocode Earth, with community contributors.
Architecture
Pelias is split into separate services and libraries, most written for Node.js:
- Importers load datasets into Elasticsearch. Official importers exist for OpenStreetMap (nodes, ways and relations), OpenAddresses, Who's On First (administrative areas and venues), GeoNames, road geometries in Google polyline format (mainly OSM roads), and CSV for custom or private data.
- Database: Elasticsearch 7 or 8, with indices set up by pelias/schema.
- Services:
- API – the public HTTP interface
- Placeholder – relationships between administrative areas
- PIP – point-in-polygon lookups for reverse geocoding
- libpostal service – address parsing with libpostal
- Interpolation – estimated house number positions along streets
Pelias also has its own rule-based query parser, pelias/parser.
Running Pelias
The pelias/docker repository provides Docker Compose projects for setting up a city, region or planet build. Documentation is in the pelias/documentation repository.
Hosted Pelias APIs are offered commercially by Geocode Earth and others; see Geocoding#Commercial.
OSM data in Pelias
The OpenStreetMap importer indexes addresses (addr:* tags) and named venues. Pelias splits name values on semicolons when indexing.[1] When OSM data is shown in results, the usual attribution applies.