PHPackages                             weasty/jjs-geonames-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. weasty/jjs-geonames-bundle

ActiveLibrary[Database & ORM](/categories/database)

weasty/jjs-geonames-bundle
==========================

GeoNames.org geographical data and associated functionality

v1.0.1(9y ago)033MITPHP

Since Feb 15Pushed 9y ago1 watchersCompare

[ Source](https://github.com/ja1cap/JJsGeonamesBundle)[ Packagist](https://packagist.org/packages/weasty/jjs-geonames-bundle)[ RSS](/packages/weasty-jjs-geonames-bundle/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (7)Versions (3)Used By (0)

Geonames Bundle
===============

[](#geonames-bundle)

Introduction
============

[](#introduction)

Provides access to the data exported by [geonames.org](http://geonames.org) into \[symfony 2\]\[sf2\] applications.

What is [geonames.org](http://geonames.org)
-------------------------------------------

[](#what-is-geonamesorg)

From the geonames.org website:

> The GeoNames geographical database covers all countries and contains over eight million placenames that are available for download free of charge.

When to use this bundle
-----------------------

[](#when-to-use-this-bundle)

Most useful application for this bundle is to normalize the geograhical information stored in your database such as Countries, States and Cities. Thanks to the extensive [geonames.org](http://geonames.org) data almost all cities, towns and suburbs are covered worldwide.

Features
--------

[](#features)

- Imports the following geonames.org data:

    - Countries
    - Timezones
    - States & Provences
    - Cities, Towns, Suburbs, Villages etc.
- Provides the following data store implementations:

    - Doctrine ORM

Installation
============

[](#installation)

1. Install the bundle using composer:

    ```
    composer require jjs/geonames-bundle:*
    ```

    Or add it to your `composer.json` file directly

    ```
    {
        require: {
            "jjs/geonames-bundle": "*"
        }
    }
    ```
2. Add the bundle to your `AppKernel.php`

    ```
    // AppKernel::registerBundles()
    $bundles = array(
        // ...
        new JJs\Bundle\GeonamesBundle\JJsGeonamesBundle(),
        // ...
    );
    ```

Install or update database schema
---------------------------------

[](#install-or-update-database-schema)

The database schema for he bundle is defined using [doctrine migrations](http://symfony.com). Migration versioning is designed so they can be merged into your application migrations or migrate the schema manually.

### Independant versioning

[](#independant-versioning)

Execute the migrations using the supplied migration configuration

```
# Run in your project root directory
app/console doctrine:migrations:migrate --configuration=vendor/jjs/geonames-bundle/JJs/GeonamesBundle/migrations.xml
```

### Application versioning

[](#application-versioning)

This schema management stragegy involves more configuration and management, but comes with the benefit of greater control. It is possible due to mapping between incremental database version and semantic bundle version. It involves 'folding' the geonames schema versioning into your own migrations and managing the migration of your database as a whole.

As yet this versioning strategy is undocumented, please contact me if you're interested in using it and I will write the documentation.

Import the data
---------------

[](#import-the-data)

**Note** that importing the data from the remote geonames.org repository involves downloading almost 250 MB data from [geonames.org](http://geonames.org).

The following commands can be used in sequence to load all supported data from the [geonames.org](http://geonames.org) export ()

### Import countries

[](#import-countries)

Loads a list of all countries which are refenced by the other imported data such as timezones and localities.

```
app/console geonames:load:countries
```

### Import timezones

[](#import-timezones)

Loads a list of timezones mapped to countries

```
app/console geonames:load:timezones
```

### Import localities

[](#import-localities)

There are two options for importing the localities - either the whole world at once or batched by countries. Internally the same import mechanism is used and the import process will download a data file for each country and then process the country files individually.

**Note** the full load process may take several hours to complete and requires a large amount of memory.

```
# All countries
app/console geonames:load:localities

# Subset of countries (list the desired contries as arguments)
app/console geonames:load:localities US CA

```

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 83.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~382 days

Total

2

Last Release

3406d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/10d2d7bf48145a1e79649f2e05a42b2596c0ecadf86e28596a1076745fa80445?d=identicon)[ja1cap](/maintainers/ja1cap)

---

Top Contributors

[![Josiah](https://avatars.githubusercontent.com/u/77621?v=4)](https://github.com/Josiah "Josiah (5 commits)")[![ja1cap](https://avatars.githubusercontent.com/u/2099802?v=4)](https://github.com/ja1cap "ja1cap (1 commits)")

---

Tags

databasecountriesgeographicalGeoNames.org

### Embed Badge

![Health badge](/badges/weasty-jjs-geonames-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/weasty-jjs-geonames-bundle/health.svg)](https://phpackages.com/packages/weasty-jjs-geonames-bundle)
```

###  Alternatives

[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1175.2k](/packages/rcsofttech-audit-trail-bundle)[symfony-cmf/routing-bundle

Symfony RoutingBundle

16314.0M108](/packages/symfony-cmf-routing-bundle)[doctrine/phpcr-bundle

Symfony DoctrinePHPCRBundle

1582.6M42](/packages/doctrine-phpcr-bundle)[aternus/geonames-client

GeoNames API Client

36222.8k2](/packages/aternus-geonames-client)[ahmed-bhs/doctrine-doctor

Runtime analysis tool for Doctrine ORM integrated into Symfony Web Profiler. Unlike static linters, it analyzes actual query execution at runtime to detect performance bottlenecks, security vulnerabilities, and best practice violations during development with real execution context and data.

939.0k](/packages/ahmed-bhs-doctrine-doctor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)