This repository is part of the Pelias project. Pelias is an open-source, open-data geocoder built by Mapzen that also powers Mapzen Search. Our official user documentation is here.

When collecting data for use in a geocoder, it's obviously important to know which city, country, etc each record belongs to. Collectively we call these fields the admin heirarchy.

Not every data source contains this information, and even those that do don't always have it consistently. So, for Pelias we actually ignore all admin heirarchy information from individual records, and generate it ourselves from the polygon data in Who's on First. This process is called admin lookup.

Admin lookup is essentially reverse geocoding: given the latitude and longitude of a point, populate the admin heiarchy by finding all the polygons for countries, cities, neighborhoods, and other admin fields that contain the point.

There are two: admin lookup slows down the process of loading data into Pelias, and it takes quite a bit of memory. Based on the current amount of data in Who's on First, count on using at least 4 or 5 GB of memory just for admin lookup while importing.

For these reasons, each of our importers has a configuration option to enable or disable admin lookup.