GeoNames download and formats: global place names, gazetteer files, and GIS workflows
GeoNames is a global geographical database and gazetteer containing place names, coordinates, feature classifications, administrative relationships, population and elevation attributes, alternate names, postal-code data, and related reference tables. The project provides a daily worldwide extract, country-specific files, specialized subsets, separate postal-code downloads, and XML and JSON web services. GeoNames data is available under a Creative Commons Attribution license, with commercial use permitted according to the project’s published terms. Its main value in GIS is as a searchable geographic-name and feature-reference layer; it should not be treated as a complete street network, cadastral database, authoritative address register, or universal polygon boundary dataset.
GeoNames is one of the most useful open gazetteer resources in the GIS, mapping, and location-data ecosystem. It provides machine-readable records for named places and geographic features across the world, connecting names to coordinates, feature classes, feature codes, country and administrative codes, population, elevation, and alternate names. The project also publishes supporting tables and services for administrative divisions, postal codes, time zones, country information, and nearby-place or name-search queries. (geonames.org) For GIS users, the important distinction is that GeoNames is primarily a geographic-name and point-feature resource. It can help answer questions such as “What places are near this coordinate?”, “Which names refer to this feature?”, “What is the country or administrative hierarchy here?”, or “How can a multilingual place-name index be joined to a map?” It is less suitable as a standalone source for road routing, building footprints, parcel boundaries, address validation, or detailed feature geometry.
How EDK fits
For: GIS analysts, geocoding and search developers, cartographers, researchers, data engineers, and teams building geographic-name indexes or location-aware applications.
GeoNames relates directly to the problem of finding and understanding the physical world through names, coordinates, classifications, and geographic relationships. A world model needs a way to connect the many names people use for places—local names, language variants, historical names, abbreviations, postal references, and machine identifiers—to physical locations. GeoNames supplies an important external gazetteer layer for that purpose. The connection is complementary rather than interchangeable. GeoNames generally represents geographic features as records with coordinates and attributes, while a broader world model may need to combine those records with roads, buildings, infrastructure, imagery, environmental features, public datasets, and richer geometries. In a combined workflow, GeoNames can help normalize names, locate candidate features, build multilingual search, classify places, and attach geographic context before computing distances, proximity, regional membership, or comparisons across the physical world. GeoNames itself should not be described as providing those broader capabilities or as replacing a complete spatial database.
- •Use GeoNames alternate names, language codes, feature classes, and stable geoname IDs to improve multilingual place search and connect user-entered names to candidate physical locations in a larger geographic world model.
- •Use GeoNames coordinates, country codes, administrative codes, population attributes, and feature classifications as reference data for proximity calculations, regional grouping, place ranking, and joins with roads, buildings, public assets, environmental layers, or other location datasets.
- •Use the daily bulk extract for reproducible geographic-name indexing, then combine it with richer geometry and authoritative local datasets when an application needs routing, parcel analysis, building-level search, or detailed feature boundaries.
Dataset profile
Formats
ZIP-compressed tab-separated text files
Worldwide allCountries extract
Country-specific ZIP extracts
alternateNamesV2.zip and related alternate-name tables
City subsets including cities500, cities1000, cities5000, and cities15000
Administrative-code, country-information, feature-code, language-code, and timezone text files
Postal-code files
XML and JSON web-service responses
Access methods
Download the worldwide or country-specific bulk extracts from the official GeoNames download server.
Download alternate names, administrative reference files, city subsets, feature-code tables, country information, and timezone data as needed.
Use the documented XML and JSON REST web services for interactive search, nearby-place lookup, reverse geographic lookup, country codes, administrative relationships, postal codes, and related queries.
Load the files into a spatial database, GIS desktop application, data lake, search index, or custom processing pipeline.
Use local bulk data and caching for repeat or high-volume analysis rather than relying on the public web service for unlimited requests.
Quality and limits
GeoNames states that its data is provided as-is without warranty of accuracy, timeliness, or completeness.
The database aggregates many sources and also accepts community edits, so provenance and quality can vary by feature and attribute.
Many records are points even when the real-world feature has an area or complex geometry.
Names can be duplicated, multilingual, historic, colloquial, abbreviated, disputed, or subject to administrative change.
Population, elevation, postal, administrative, and language attributes may have different source dates and meanings.
Postal-code coverage is separate and country-dependent; some countries have partial codes, restricted details, or inferred coordinates.
The public web services have published daily and hourly usage limits.
The dataset should not be used alone for authoritative legal boundaries, parcel decisions, current address validation, detailed routing, or building-level geometry.
Analysis workflows
Build a reproducible gazetteer import by storing the source file date, download date, geoname ID, original attributes, and transformation history.
Create WGS84 point geometry from the latitude and longitude fields, then transform to an appropriate projected CRS for distance or area calculations.
Join alternateNamesV2 to the main records for multilingual search, historical-name lookup, transliteration, and place-name disambiguation.
Use feature class, feature code, country code, and administrative codes to filter and group geographic features consistently.
Join GeoNames points to authoritative administrative polygons, roads, buildings, transit data, environmental layers, or public assets for richer spatial analysis.
Calculate nearest-feature distances, regional counts, place rankings, proximity relationships, and candidate matches while preserving uncertainty and missing values.
Validate production results against local authoritative sources when precision, currency, legal status, or complete geometry is important.
Use the dataset as a geographic reference layer inside broader physical-world analysis: names and identifiers from GeoNames can help locate and organize other layers before measuring, comparing, filtering, or aggregating them.
Value inside EDK
What GeoNames contains
GeoNames is a global geographical database built from more than one hundred data sources and community contributions. Its records are organized into nine broad feature classes and hundreds of feature codes. Examples include populated places, administrative areas, natural features, mountains, water bodies, facilities, transportation features, and other named geographic entities. Each main gazetteer record can include a geoname ID, primary name, ASCII name, alternate names, latitude and longitude, feature class, feature code, country code, administrative codes, population, elevation, digital elevation model value, timezone, modification date, and related identifiers. (geonames.org)
The alternate-name system is a particularly important part of the dataset. Alternate names can represent language variants, country-specific variants, historical names, colloquial names, abbreviations, postal references, airport codes, links, and other name forms. The alternateNamesV2 download adds language and temporal fields that help distinguish names by language, preferred status, historical use, and period of validity. (download.geonames.org)
- •Global named-feature records with coordinates and classifications.
- •Alternate names and language-coded variants linked by geoname ID.
- •Country, administrative-division, feature-code, and timezone reference tables.
- •Population and elevation-related attributes where available.
- •Separate postal-code files and web services for geographic lookup.
Geography, coordinate system, and update cadence
GeoNames is designed for worldwide coverage rather than a single national or regional study area. The official project describes the database as covering all countries. The main records use latitude and longitude in WGS84, which makes them straightforward to load into most GIS software and spatial databases. (geonames.org)
The official download documentation describes a daily worldwide database extract. Country-specific files are provided for convenience, along with reduced city extracts such as cities500, cities1000, cities5000, and cities15000. The download server also exposes modification dates for files and tables, which can be used to record the vintage of a local import. Because the content is continuously maintained and modified, analysts should store the download date and avoid mixing files from different vintages without documenting the decision. (geonames.org)
- •Geography: worldwide, with country-specific and global downloads.
- •Coordinate reference: WGS84 latitude and longitude for the main geographic records.
- •Cadence: the official project documents a daily main extract; individual source attributes may have different update histories.
- •Versioning practice: record the file date, download date, and source files used in every production import.
Download options, formats, and access methods
The principal bulk download is allCountries.zip, a compressed worldwide text extract. Country-specific ZIP files are available when a smaller geographic scope is sufficient. The official dump documentation describes the core data as tab-separated flat files, with field definitions supplied in the readme and related reference tables. This format is easy to stream, stage in object storage, import into PostgreSQL or another database, and process with command-line tools or data-engineering pipelines. (geonames.org)
Important supporting downloads include alternateNamesV2.zip, countryInfo.txt, admin1CodesASCII.txt, admin2Codes.txt, featureCodes files, iso-languagecodes.txt, timeZones.txt, and population-oriented city subsets. The project identifies alternateNames.zip as obsolete in favor of alternateNamesV2.zip. Postal-code data is distributed separately, including a global allCountries.zip for supported postal-code coverage and country-specific files. (download.geonames.org)
- •Bulk worldwide extract: allCountries.zip.
- •Country-level extracts for smaller or regional imports.
- •Tab-separated text files inside ZIP archives.
- •Supporting files for alternate names, administrative codes, feature codes, languages, time zones, and city subsets.
- •XML and JSON REST services for interactive lookup and application integration.
- •Separate postal-code downloads with country-specific coverage conditions.
Suitable GIS and spatial-analysis workflows
A practical GIS workflow begins by importing the main gazetteer into a table with a stable integer geoname ID, preserving the original text fields and recording the source vintage. Load latitude and longitude as WGS84 points, then transform to a local projected coordinate system only when measuring distances or areas. Keep feature class and feature code as structured fields rather than flattening them into display labels; those codes provide a reproducible way to filter populated places, administrative features, natural features, and other categories.
For multilingual search, load alternateNamesV2 separately and index it by geoname ID, language code, preferred-name flag, historical flag, and validity dates where present. A search workflow can first retrieve candidate names, then use country, administrative code, feature class, population, or distance to rank results. This is useful for map labels, gazetteer search, geocoding assistance, place-name disambiguation, and matching external records to a canonical geographic identifier.
- •Import the main and supporting files into a spatial database with geoname ID as the stable join key.
- •Create WGS84 point geometry from latitude and longitude, then project for distance or area calculations.
- •Index alternate names by language, preferred status, historical status, and geoname ID.
- •Join points to authoritative boundaries or richer physical-world layers for regional analysis.
- •Use feature codes and country or administrative codes for reproducible filtering.
- •Validate results against local authoritative data when precision, currency, or legal status matters.
License, strengths, and tradeoffs
GeoNames states that its data is available under a Creative Commons Attribution license and that commercial usage is allowed under its published terms. Attribution is required, and the project recommends crediting GeoNames with a link or another reference. The project also states that its data is provided as-is without warranty or representation of accuracy, timeliness, or completeness. Some component datasets, particularly postal-code material or contributed source data, can carry additional conditions that must be reviewed before redistribution. (geonames.org)
- •Strength: worldwide scope with a common schema for names, coordinates, feature classes, and identifiers.
- •Strength: strong support for alternate names and multilingual geographic search.
- •Strength: practical bulk downloads, country subsets, specialized reference tables, and XML or JSON services.
- •Tradeoff: the dataset is primarily a gazetteer of records and points, not a complete geometry database for roads, buildings, parcels, or boundaries.
- •Tradeoff: accuracy, completeness, and freshness vary by feature and source; the project provides no blanket warranty.
- •Tradeoff: public web services impose usage limits, while postal and some source-derived data may have additional restrictions.
- •Tradeoff: place names and administrative concepts can be ambiguous, duplicated, historic, disputed, or changed over time.
Questions teams ask
Is GeoNames a geocoding or address dataset?
GeoNames can support place-name search, nearby-place lookup, country and administrative identification, and some postal-code workflows, but it should not automatically be treated as a complete address-validation or rooftop-geocoding database. Its principal content is a global gazetteer of named geographic features, generally represented by records and coordinates. Applications that require current street addresses, building-level precision, or authoritative postal validation should use an appropriate address or postal source in addition to GeoNames.
What is the best GeoNames file for a global GIS import?
For a broad global import, the main allCountries.zip extract is the usual starting point. Add alternateNamesV2.zip when multilingual search or name matching matters, and load the administrative, feature-code, country, language, and timezone reference files when those attributes are needed. If the project only needs larger cities, one of the cities500, cities1000, cities5000, or cities15000 subsets may reduce processing and storage requirements. Record the download date and file vintage for reproducibility. (download.geonames.org)
Can GeoNames data be used commercially?
GeoNames’ published export information says commercial usage is allowed under its Creative Commons Attribution terms, with attribution required. The project also states that the data is provided as-is. Users should review the terms for the specific files they redistribute, especially postal-code material and source-derived content that may include additional rights or restrictions. (geonames.org)
How often is GeoNames updated?
GeoNames describes its main worldwide database extract as a daily extract. That does not mean every record or every attribute changes daily, and source datasets can have different update histories. For analytical or production use, retain the file date, download date, and any local transformation history so results can be reproduced and compared across vintages. (geonames.org)
Keep exploring
geonames analysis workflow
A companion workflow page focused on importing, cleaning, joining, indexing, and analyzing GeoNames records in GIS and spatial databases.
gadm download and formats
A complementary global administrative-boundary dataset for joining GeoNames points to country and regional polygons.
gtfs download and formats
A complementary location-data format guide for combining named places with transit stops, routes, schedules, and service geography.
Sources
GeoNames official home page
Authoritative overview of global coverage, free downloads, attribution, and the project’s geographic-name database.
Open sourceGeoNames official download and web service page
Documents the daily worldwide extract, country downloads, web services, licensing terms, and service limits.
Open sourceGeoNames official database dump directory and readme
Defines the main files, supporting tables, alternate-name fields, city subsets, modification dates, and tabular formats.
Open sourceGeoNames official about page
Describes feature counts, feature classes and codes, WGS84 coordinates, data sources, and the database’s structure.
Open sourceGeoNames official web services documentation
Documents search, nearby-feature, reverse lookup, postal-code, administrative, country, and timezone services.
Open source