yurtesen / geonames
Geonames importer and models for Eloquent ORM
Installs: 1 653
Dependents: 0
Suggesters: 0
Security: 0
Stars: 31
Watchers: 5
Forks: 8
Open Issues: 1
Requires
- ext-zip: *
- illuminate/config: ^5.2.0|^6.0|^7.0|^8.0
- illuminate/console: ^5.2.0|^6.0|^7.0|^8.0
- illuminate/database: ^5.2.0|^6.0|^7.0|^8.0
- illuminate/filesystem: ^5.2.0|^6.0|^7.0|^8.0
README
This package provides probably the best Eloquent models, most complete SQL schemas and fastest Artisan commands to import/update a local copy of GeoNames databases.
Installation
Note: If you are using Lumen. You have to first install irazasyed/larasupport !
Please include the following require in your composer.json :
{
"require": {
"yurtesen/geonames": "dev-master"
}
}
or install using command line :
composer require yurtesen/geonames:dev-master
after installation, you will need to add the service provider in your config\app.php to 'providers' array
Yurtesen\Geonames\GeonamesServiceProvider::class,
or for Lumen add service provider in bootstrap\app.php Remember that irazasyed/larasupport must be registered before.
$app->register(Yurtesen\Geonames\GeonamesServiceProvider::class);
Usage and Configuration
Please see the wiki for further information
Provided Eloquent Models
Please see the Wiki pages for implementation details.
Name | Key | Relations | Scopes |
---|---|---|---|
GeonamesGeoname | geoname_id | alternateName, timeZone,country | admin1,city,countryInfo |
GeonamesAlternateName | geoname_id | geoname | |
GeonamesCountryInfo | iso | timezone,continent | |
GeonamesFeatureCode | code | ||
GeonamesLanguageCode | iso_639_3 | ||
GeonamesTimezone | timezone_id | ||
GeonamesHierarchy | parent_id | ||
GeonamesAdmin1Code | geoname_id | geoname,hierarchies | |
GeonamesAdmin2Code | geoname_id | geoname,hierarchies |
Tables
GeoNames file names and corresponding table names created in your database.
Filename | Tablename |
---|---|
timeZones.txt | geonames_timezones |
allCountries.zip | geonames_geonames |
countryInfo.txt | geonames_country_infos |
iso-languagecodes.txt | geonames_language_codes |
alternateNames.zip | geonames_alternate_names |
hierarchy.zip | geonames_hierarchies |
admin1CodesASCII.txt | geonames_admin1_codes |
admin2Codes.txt | geonames_admin2_codes |
featureCodes_en.txt | geonames_feature_codes |
If You Need Help
Please check the wiki for more information about how to utilize the package efficiently and usage examples. If something does not work or if you have a suggestion, please do not hesitate to use the issue tracker.