brawcks / geoname-bundle
Symfony GeoNameBundle
Installs: 15
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 15
Type:symfony-bundle
Requires
- php: >=5.5.9
- doctrine/doctrine-bundle: >=1.6
- guzzlehttp/guzzle: ~6.0
- guzzlehttp/promises: >=1.0
- symfony/console: ~2.7|~3.0|~4.0|^5
- symfony/dependency-injection: ~2.7|~3.0|~4.0|^5
- symfony/framework-bundle: ~2.7|~3.0|~4.0|^5
Requires (Dev)
- doctrine/orm: ^2.5
- phpunit/phpunit: *
- satooshi/php-coveralls: ^1.0
- symfony/yaml: ~2.7|~3.0|^4|^5
This package is not auto-updated.
Last update: 2024-04-22 17:58:09 UTC
README
CREDITS [IMPORTANT]
All the work was originaly done by Krzysztof Bednarczyk krzysztof@bednarczyk.me. This package is a fork to get a fast fix on error happening on symfony 5.
Introduction
Provides access to the data exported by GeoNames.org into Symfony 2 and Symfony 3 applications.
What is geonames.org
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
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 data almost all cities, towns and suburbs are covered worldwide.
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
-
Install the bundle using composer:
composer require bordeux/geoname-bundle
-
Add the bundle to your
AppKernel.php
// AppKernel::registerBundles() $bundles = array( // ... new Bordeux\Bundle\GeoNameBundle\BordeuxGeoNameBundle(), // ... );
Install or update database schema
Execute the migrations using the supplied migration configuration
php bin/console doctrine:schema:update --force
Import the data
Note that importing the data from the remote geonames.org repository involves downloading almost 350 MB data from geonames.org.
The following commands can be used in sequence to load all supported data from the geonames.org export (http://download.geonames.org/export/dump)
Import data
Loads a list of all data from geonames.org
php bin/console bordeux:geoname:import --env=prod
Options
Usage:
bordeux:geoname:import [options]
Options:
-a, --archive[=ARCHIVE] Archive to GeoNames [default: "http://download.geonames.org/export/dump/allCount
ries.zip"]
-t, --timezones[=TIMEZONES] Timezones file [default: "http://download.geonames.org/export/dump/timeZones.txt
"]
-o, --download-dir[=DOWNLOAD-DIR] Download dir
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
-e, --env=ENV The environment name [default: "dev"]
--no-debug Switches off debug mode
-a1, --admin1-codes[=ADMIN1-CODES] Admin 1 Codes file [default: "http://download.geonames.org/export/dump/admin1Cod
esASCII.txt"]
-a2, --admin2-codes[=ADMIN2-CODES] Admin 2 Codes file [default: "http://download.geonames.org/export/dump/admin2Cod
es.txt"]
-lc, --languages-codes[=LANGUAGES-CODES] Admin 2 Codes file [default: "http://download.geonames.org/export/dump/iso-langu
agecodes.txt"]
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose outp
ut and 3 for debug
Help:
Import GeoNames