Download the PHP package farzai/geonames without Composer
On this page you can find all versions of the php package farzai/geonames. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download farzai/geonames
More information about farzai/geonames
Files in farzai/geonames
Package geonames
Short Description A PHP library for downloading and converting Geonames data.
License MIT
Homepage https://github.com/farzai/geonames-php
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package geonames
Geoname data (PHP)
A PHP library for downloading and converting Geonames data. This library provides easy access to both Postal Codes and Gazetteer data from Geonames.
Features
- Download postal codes data for specific countries or all countries
- Download detailed geographical data (Gazetteer) including administrative divisions
- Convert data to JSON format with proper structure
- Import data directly to MongoDB with proper indexing
- Memory-efficient processing for large datasets
- Progress bars for all operations
How It Works
Admin Code Resolution
When downloading gazetteer data, the library automatically downloads admin1CodesASCII.txt and admin2Codes.txt from GeoNames to resolve administrative division names (e.g., converting admin code "40" to "Bangkok").
Memory-Efficient Processing
Data is processed using streaming to handle large datasets without exhausting memory. For MongoDB imports, records are inserted in batches of 1000 for optimal performance.
Automatic Cleanup
Temporary files (downloaded ZIP files, extracted data files, and admin code files) are automatically cleaned up after processing completes.
Installation
Usage
Postal Codes
Download postal codes for a specific country:
Download postal codes for all countries:
Options:
--output (-o): Output directory (default: ./data)--format (-f): Output format (default: json, options: json, mongodb)--mongodb-uri: MongoDB connection URI (default: mongodb://localhost:27017)--mongodb-db: MongoDB database name (default: geonames)--mongodb-collection: MongoDB collection name (default: postal_codes)
The postal codes data includes:
- Country code
- Postal code
- Place name
- Administrative divisions (state/province, county/district, community)
- Latitude and longitude
- Accuracy level
Gazetteer Data
Download geographical data for a specific country:
Download geographical data for all countries:
Options:
--output (-o): Output directory (default: ./data)--format (-f): Output format (default: json, options: json, mongodb)--mongodb-uri: MongoDB connection URI (default: mongodb://localhost:27017)--mongodb-db: MongoDB database name (default: geonames)--mongodb-collection: MongoDB collection name (default: gazetteer)
The Gazetteer data includes:
- Geoname ID
- Name (with ASCII and alternate names)
- Geographical coordinates
- Feature class and code
- Administrative divisions with names
- Population
- Elevation
- Digital elevation model (DEM)
- Timezone
- Modification date
Data Structure
Postal Codes Structure
JSON Format
MongoDB Format
In MongoDB, the postal codes data has the same structure as JSON but includes an additional location field for geospatial queries:
The MongoDB collection is indexed for efficient queries:
- Compound index on
country_codeandpostal_code(unique) - Index on
country_code - Index on
postal_code - Geospatial index on
location
Gazetteer Structure
JSON Format
MongoDB Format
In MongoDB, the gazetteer data uses slightly different field names and includes a location field for geospatial queries:
The MongoDB collection is indexed for efficient queries:
- Geospatial index on
location
MongoDB Usage Examples
Finding locations near a point
Finding postal codes by country
Error Handling
The library throws Farzai\Geonames\Exceptions\GeonamesException for all error conditions:
Common error scenarios:
- File operation failures: Unable to read, write, or open files
- ZIP extraction failures: Corrupted or invalid ZIP archives
- Data not found: Missing expected data files in downloaded archives
- Missing dependencies: MongoDB extension not installed when using MongoDB format
License
This package is open-sourced software licensed under the MIT license.
Credits
- Data provided by GeoNames under a Creative Commons Attribution 4.0 License
- Developed by Parsilver
