v360tech / geonames
A Laravel (php) package that interfaces with the geolocation services on geonames.org.
Requires
- php: ^7.0 || ^8.0 || ^8.1 || ^8.2 || ^8.3
- ext-curl: *
- ext-intl: *
- ext-pdo: *
- curl/curl: ^2.2
- laravel/framework: ^11.0
- michaeldrennen/local-file: ^2.0
- michaeldrennen/remote-file: ^2.0.3
- nesbot/carbon: ^2.28 || ^3.0
- symfony/browser-kit: ^7.1
- symfony/http-client: ^7.1
Requires (Dev)
- php-coveralls/php-coveralls: ^2.2
- phpunit/phpunit: ^9.2
This package is auto-updated.
Last update: 2025-04-04 06:44:13 UTC
README
A Laravel (php) package to interface with the geo-location services at geonames.org.
Installation
composer require v360tech/geonames
And then add geonames provider to providers array in app.php config file:
V360Tech\Geonames\GeonamesServiceProvider::class,
After that, Run migrate command:
php artisan migrate
Want to install all of the geonames records for the US, Canada, and Mexico as well as pull in the feature codes definitions file in English?
php artisan geonames:install --country=US --country=CA --country=MX --language=en
Want to just install everything in the geonames database?
php artisan geonames:install
Maintenance
Now that you have the geonames database up and running on your system, you need to keep it up-to-date.
I have an update script that you need to schedule in Laravel to run every day.
Assuming your servers are running on GMT, your update command would look like:
$schedule->command('geonames:update')->dailyAt('3:00');
The update artisan command will handle the updates and deletes to the geonames table.
By default, GeonamesServiceProvider will run it for you daily at config('geonames.update_daily_at').