Download the PHP package kulykovoleksii/laravel-geocoding without Composer
On this page you can find all versions of the php package kulykovoleksii/laravel-geocoding. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kulykovoleksii/laravel-geocoding
More information about kulykovoleksii/laravel-geocoding
Files in kulykovoleksii/laravel-geocoding
Package laravel-geocoding
Short Description Universal geocoding and postal code lookup for PHP with support for multiple countries. Framework-agnostic core with first-class Laravel integration.
License MIT
Informations about the package laravel-geocoding
Laravel Geocoding
Universal geocoding and postal code lookup package for Laravel with support for multiple countries worldwide.
Features
- Multi-country support (UK, USA, Ukraine, Canada, and more)
- Multiple geocoding providers with automatic fallback
- Free UK postcode lookup via Postcodes.io API
- Google Maps Geocoding API integration for worldwide coverage
- Database caching to minimize API calls
- Reverse geocoding from coordinates to addresses
- Hierarchical region management
- Comprehensive test suite
Requirements
- PHP 8.1 or higher
- Laravel 10.0 or 11.0
- MySQL/PostgreSQL database
Installation
Install the package via Composer:
Publish the configuration file:
Publish and run migrations:
Configuration
Add your Google Maps API key to .env (optional but recommended for worldwide coverage):
Get your API key at: https://console.cloud.google.com/google/maps-apis
Pricing: $200/month free credit (approximately 40,000 requests/month free)
Usage
Basic Usage
Lookup Different Countries
Geocode Full Address
Reverse Geocoding
Using Facade
Working with Regions
Supported Postal Code Formats
| Country | Code | Format Example | Provider |
|---|---|---|---|
| United Kingdom | GB | SW1A 1AA, M1 1AA | Postcodes.io |
| United States | US | 90210, 10001-1234 | Google Maps |
| Ukraine | UA | 01001, 79000 | Google Maps |
| Canada | CA | K1A 0B1 | Google Maps |
| Others | * | Various | Google Maps |
Geocoding Providers
Postcodes.io (UK only, free)
Automatically used for UK postcodes. No configuration required.
Google Maps Geocoding API (Universal)
Used for non-UK addresses or when Postcodes.io doesn't have data. Requires API key in configuration.
Caching Strategy
All geocoding results are automatically cached in the database:
- First lookup checks the database cache
- If not found, queries the appropriate geocoding provider
- Results are stored in the
postal_codestable - Subsequent lookups use cached data
- Reverse geocoding uses proximity search for nearby cached coordinates
This minimizes API calls and costs, especially for paid services like Google Maps.
Testing
Run the test suite:
Or using PHPUnit directly:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Security
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-geocoding with dependencies
guzzlehttp/guzzle Version ^7.0
psr/log Version ^1.1|^2.0|^3.0
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/database Version ^10.0|^11.0|^12.0