Home » Web Services » Services_GeoNames

A PHP5 interface to the GeoNames public API

This package is unmaintained.

Download latest release 1.0.1 (there might be newer Composer installable version)

License: MIT

Description

Services_GeoNames is a PHP5 interface to the various webservices offered by
the GeoNames project.

The GeoNames database contains over 8,000,000 geographical names corresponding
to over 6,500,000 unique features. All features are categorized into one out
of nine feature classes and further subcategorized into one out of 645 feature
codes. Beyond names of places in various languages, data stored include
latitude, longitude, elevation, population, administrative subdivision and
postal codes. All coordinates use the WGS84 system (World Geodetic System 1984).

Those data are accessible free of charge through a number of Web services and
a daily database export. The Web services include direct and reverse geocoding,
finding places through postal codes, finding places next to a given place, and
finding Wikipedia articles about neighbouring places.

For more information please visit:
* http://www.geonames.org
* http://www.geonames.org/export/ws-overview.html
* http://en.wikipedia.org/wiki/GeoNames

Documentation

Manual

Maintainers

• David Jean Louis (izi) — lead, active

Dependencies

Required

• PHP (>= 5.2.0)
• PEAR Installer (>= 1.4.0b1)
• HTTP_Request2 (>= 0.1.0)

Releases

• 1.0.1 (stable, 2010-10-01)
  Release notes

  License: MIT

  * Check if input is already utf8 encoded before encoding it (fixes bug #17876),
  * Corrected packaging issue (fixes bug #17914).

• 1.0.0 (stable, 2010-04-10)
  Release notes

  License: MIT

  * fixed bug #17101: Unit tests fail (64 bit systems),
  * fixed package.xml to allow installation via pyrus.

• 0.2.3 (beta, 2009-01-23)
  Release notes

  License: MIT

  * clone the HTTP_Request2 instance instead of the reusing the same instance,
  * ability to set an array of failover servers,
  * better doc strings and various cosmetic changes.

  Important note
  ==============
  From http://www.geonames.org/export/ :
  "We have temporarily removed the domain ws.geonames.org from the dns setting to
  protect the server from exessive use by an iphone application. You can access
  the server with the domain ws5.geonames.org"

  So until ws.geonames.org is not restored, you'll have to do either:
  <?php
  require_once 'Services/GeoNames.php';

  $geo = new Services_GeoNames();
  $geo->url = 'http://ws5.geonames.org';
  ?>

  or:

  <?php
  require_once 'Services/GeoNames.php';

  $geo = new Services_GeoNames();
  $geo->failoverServers[] = 'http://ws5.geonames.org';
  ?>

• 0.2.2 (beta, 2008-12-19)
  Release notes

  License: MIT

  * added getter/setter for request (now protected),
  * better exceptions management,
  * better tests layout/coverage.

Bugs