Download the PHP package aternus/geonames-client without Composer
On this page you can find all versions of the php package aternus/geonames-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aternus/geonames-client
More information about aternus/geonames-client
Files in aternus/geonames-client
Package geonames-client
Short Description GeoNames API Client
License MIT
Homepage https://github.com/Aternus/geonames-client
Informations about the package geonames-client
GeoNames Client
A GeoNames API Client for PHP.
Install with confidence 🛡️
- Supported OS: Linux, macOS and Windows.
-
Supported PHP versions: 7.2 and up.
- Quick Start
- Why?
- Installation
- Other Useful Libraries
- License
- Credits
Quick Start
An overview of available API parameters for each endpoint is available here.
Client Options
Supported client options:
username
: GeoNames username.token
?: GeoNames token (i.e. premium user key).api_url
?: URL of the GeoNames web service.connect_timeout
?: HTTP Client connection timeout. The number of seconds to wait while trying to connect to a server (default0
, wait indefinitely).fallback_api_url
: COMING SOON.fallback_api_url_trigger_count
: COMING SOON.
Example: Providing options during instantiation
Example: Changing options during runtime
Why?
This library will allow you to get better insights into the world.
As a developer and a multilingual speaker I've always felt that localization was put on last priority since it was so time-consuming and error-prone.
Getting statistics for each country is a painful process that requires understanding the different ISO standards, and even then you're still left to piece the puzzle together yourself.
Luckily, GeoNames have been collecting statistical data about the world for the past few decades and offers that data via their API.
The aim of this library is to provide a single source of truth for country (ISO-3166), language (ISO-639-1), and other locale related statistical data, so that other developers can write better software which is up-to-date with the latest changes in the world.
Installation
If you're using Composer to manage dependencies:
Then, after running composer update
, you can load the class using Composer's
autoloading:
Otherwise, you can simply require the file directly:
And in either case, I'd suggest using an alias.
Other Useful Libraries
Please make sure to implement some kind of cache mechanism in order to save yourself time, bandwidth and be respectful to GeoNames for providing all that data for free.
If you're making heavy use of the statistical data, you can subscribe to their Premium Data plan.
License
Released under the MIT License - see LICENSE.md
for details.
Credits
David Jean Louis for the PEAR package which inspired this GeoNames API Client.
All versions of geonames-client with dependencies
ext-curl Version *
ext-json Version *
ext-xml Version *
guzzlehttp/guzzle Version 7.*