Skip to Content
teigeodata

Places and IDs

What a place is in teigeodata, its kinds and admin levels, and why its ID never changes.

Everything teigeodata answers is about places. A place has:

FieldWhat it is
idA stable ID, such as tgd:np/1xhb.
nameIts name in the pack's base language, with every other name it has (other scripts, languages, former and alternative names) behind it for search.
kindWhat sort of place it is (below).
levelFor an admin unit, its admin level; 0 for a country and for anything that is not a unit.
lat, lonIts point in WGS84 degrees: the centre of a settlement, a label point for a unit.
elevationMetres above mean sea level (EGM2008), with how it was found: surveyed from a source, model from the terrain.
parentThe ID of the smallest unit that holds it.
tzIts IANA timezone.
isoThe ISO 3166 code of a country (NP) or a subdivision (NP-P4).
populationIts number of people, with where it came from: stated by a source (a census or an estimate), or modelled from a population grid over an admin unit.

Any of these but the ID and point may be null where the data has no value; kind is null only for a kind newer than the reader.

Kinds

KindWhat
countryA country.
adminAn admin unit: a province, a district, a municipality, a ward. Its level says which.
settlementA city, town or village: where people live, whether or not it is a unit.
localityA named part of a settlement: a neighbourhood, a tole, a chowk.
naturalA mountain, lake, river or other natural feature.
postal_areaThe area of a postal code.
timezone_areaAn area with one IANA timezone; its name is the zone.

Admin levels

Countries divide themselves differently, so each country's ladder is data: its profile names each level. Nepal's is country (0), province (1), district (2), local level (3, the municipality) and ward (4). Code never assumes a ladder: ask for a place's level and its ancestors.

IDs that last

An ID is the country that first allocated it and a serial: tgd:np/1xhb is Nepal's serial 1xhb in base32. IDs are allocated once and never reused, so you can store them in your database and look them up after any data update:

  • A place keeps its ID through every rebuild, however its name, point or parent change.
  • When two records turn out to be one place, the survivor keeps its ID and the other is retired: looking up a retired ID answers with the survivor.
  • A place that moves to another country keeps the ID it was born with: the prefix is where the ID was allocated, not where the place is now.

tgd:world/… IDs belong to places in no country: oceans, seas, the world.

Names in every script

A place carries every name the sources give it: its official name, names in other scripts and languages, former names and common alternatives. Search reads all of them through a fold that ignores case, accents and the small spelling differences of each script, and forgives typos, so काठमाडौं, Kathmandu and Kathamandu all find the capital. Each country's spelling rules (such as चोक written Chowk, not Chok) are data in its lexicon, each with its source.

On this page