PHPackages                             alchemy/geonames-api-consumer - 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. [HTTP & Networking](/categories/http)
4. /
5. alchemy/geonames-api-consumer

ActiveLibrary[HTTP & Networking](/categories/http)

alchemy/geonames-api-consumer
=============================

A connector to a geonames server

4.1.0(8y ago)7118.8k↑33.3%5[2 issues](https://github.com/alchemy-fr/GeonamesServer-PHP-Plugin/issues)1MITPHPPHP ~7.0

Since Jul 2Pushed 3y ago11 watchersCompare

[ Source](https://github.com/alchemy-fr/GeonamesServer-PHP-Plugin)[ Packagist](https://packagist.org/packages/alchemy/geonames-api-consumer)[ RSS](/packages/alchemy-geonames-api-consumer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (8)Used By (1)

Geonames API Connector
======================

[](#geonames-api-connector)

[![Build Status](https://camo.githubusercontent.com/9b852bae67a11efcadb65d4b7dba3a93e39f01ca8808c96007d69ff444064c37/68747470733a2f2f7472617669732d63692e6f72672f616c6368656d792d66722f47656f6e616d65735365727665722d5048502d506c7567696e2e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/alchemy-fr/GeonamesServer-PHP-Plugin)

This is a consumer for the [GeonamesServer](https://github.com/alchemy-fr/GeonamesServer).

Usage
-----

[](#usage)

- Connector creation :

```
$connector = ALchemy\Geonames\Connector::create($serverUrl);
```

- Query cities :

```
// returns an array of Alchemy\Geonames\Geoname objects
$geonames = $connector->search('Paris');
```

Query options :

```
// limit to 50 results
// use '89.73.4.152' as IP address for closeness sort
$connector->search('Paris', 50, '89.73.4.152');
```

- Find by IP :

```
// returns a Alchemy\Geonames\Geoname object
$geoname = $connector->ip('89.73.4.152');
```

- Find a GeonameId :

```
// returns a Alchemy\Geonames\Geoname object
$geoname = $connector->geoname(2988507);
```

Silex Service Provider
----------------------

[](#silex-service-provider)

```
$app = new Silex\Application();
$app->register(new Alchemy\Geonames\GeonamesServiceProvider(), array(
    'geonames.server-uri' => 'http://geonames.domain.tld',  // mandatory parameter
));
```

License
-------

[](#license)

This project is released under the MIT License.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance14

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 78.9% 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 ~854 days

Total

5

Last Release

1287d ago

Major Versions

0.1.2 → 4.1.02018-04-12

PHP version history (2 changes)0.1.0PHP >=5.3.3

4.1.0PHP ~7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/3c264f69af4c60cb9cc98a522b4663f4b6a2708629cabc14409478ab6fc35348?d=identicon)[romain](/maintainers/romain)

![](https://avatars.githubusercontent.com/u/2437286?v=4)[Benoît Burnichon](/maintainers/bburnichon)[@bburnichon](https://github.com/bburnichon)

![](https://www.gravatar.com/avatar/58d21270e5d40f7ee05bb875b2442496ffd38cec041f7fdcc507b8b040f7e7f8?d=identicon)[thibaud-evaneos](/maintainers/thibaud-evaneos)

![](https://www.gravatar.com/avatar/ee4bb6d5bcc2f9456b41090151c1c8fb288e8949994d965b03b7e25648d663f4?d=identicon)[nmaillat](/maintainers/nmaillat)

---

Top Contributors

[![romainneutron](https://avatars.githubusercontent.com/u/137574?v=4)](https://github.com/romainneutron "romainneutron (15 commits)")[![aynsix](https://avatars.githubusercontent.com/u/35221835?v=4)](https://github.com/aynsix "aynsix (1 commits)")[![aztech-dev](https://avatars.githubusercontent.com/u/93562568?v=4)](https://github.com/aztech-dev "aztech-dev (1 commits)")[![nmaillat](https://avatars.githubusercontent.com/u/1225962?v=4)](https://github.com/nmaillat "nmaillat (1 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (1 commits)")

---

Tags

geonames

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/alchemy-geonames-api-consumer/health.svg)

```
[![Health](https://phpackages.com/badges/alchemy-geonames-api-consumer/health.svg)](https://phpackages.com/packages/alchemy-geonames-api-consumer)
```

###  Alternatives

[jdesrosiers/silex-cors-provider

A silex service provider that adds CORS services to silex

83892.3k10](/packages/jdesrosiers-silex-cors-provider)[hgg/pardot

Pardot API library for building custom CRM connectors

2399.6k](/packages/hgg-pardot)[bradfeehan/desk-php

PHP client for Desk.com v2 API based on Guzzle

2181.4k](/packages/bradfeehan-desk-php)

PHPackages © 2026

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