Weave Code
Locationiq Provider Laravel Package
geocoder-php/locationiq-provider
LocationIQ provider for the Geocoder PHP library, adding geocoding and reverse geocoding through LocationIQ's API. Drop it into any Geocoder setup to resolve addresses to coordinates and coordinates back to addresses.
LocationIQ provider for Geocoder PHP adds forward and reverse geocoding through the LocationIQ API to the geocoder-php ecosystem. It returns standardized Address objects, letting you switch providers without changing application code.
- Forward geocoding: turn addresses into coordinates
- Reverse geocoding: turn coordinates into addresses
- Configurable: API key, locale, region, and timeout
- Geocoder PHP compatible: implements the common provider interface
- PSR-friendly: works with standard HTTP clients
Frequently asked questions about Locationiq Provider
- How do I install geocoder-php/locationiq-provider in a Laravel app?
- Install it with Composer using composer require geocoder-php/locationiq-provider. For Laravel integration you will usually also install geocoder-php/geocoder so you can register the provider with the Geocoder service. There is no separate Laravel service provider in this package, so you wire it into your app's container or a small service class yourself.
- Does geocoder-php/locationiq-provider work with Laravel 10 and Laravel 11?
- The package is framework-agnostic and targets the Geocoder PHP library, so it can be used in Laravel 10, 11, and other modern Laravel versions as long as your PHP and Composer dependencies are compatible. Laravel integration is handled through geocoder-php/geocoder rather than a Laravel-specific package. Check the package's composer.json for its PHP version constraints before upgrading.
- How do I configure the LocationIQ API key in Laravel?
- Create a LocationIQ account, generate an API key, and store it in your .env file as something like LOCATIONIQ_API_KEY. When registering the provider with Geocoder, pass the key from env('LOCATIONIQ_API_KEY') instead of hardcoding it. Keep the key out of version control and use Laravel's config cache or a secrets manager in production.
- Can I do forward geocoding from an address to coordinates with LocationIQ?
- Yes. The LocationIQ provider supports forward geocoding, so you pass an address string to the Geocoder and receive structured results containing coordinates, formatted address, and bounds where available. In Laravel you can call it from a controller, job, or service class and return the result as JSON for your frontend.
- How do I reverse geocode latitude and longitude with geocoder-php/locationiq-provider?
- Instantiate the LocationIQ provider and call the reverse geocoding method with a latitude and longitude pair, typically via a Coordinate object in Geocoder PHP. The provider returns address details such as formatted address and components. Wrap the call in error handling because network issues or API errors can throw exceptions.
- Is geocoder-php/locationiq-provider PSR-18 compatible?
- Yes. The provider is designed to work with Geocoder PHP and a PSR-18 HTTP client, so you can inject the HTTP client implementation your application already uses. This makes it easier to share Guzzle, Symfony HTTP Client, or another PSR-18 client across your Laravel app. The package itself does not couple you to a specific HTTP client.
- How do I handle LocationIQ rate limits and 429 errors in Laravel?
- LocationIQ's free tier is rate-limited, so cache repeated geocoding results and avoid calling the API for the same address or coordinates repeatedly. Wrap Geocoder calls in try-catch blocks and use Laravel's retry or queue mechanisms for transient failures. Monitor usage and consider a paid plan if your request volume grows.
- Can I use geocoder-php/locationiq-provider outside Laravel?
- Yes. It is a Geocoder PHP provider and does not require Laravel at all. You can use it in any PHP application that installs geocoder-php/geocoder and a compatible PSR-18 HTTP client. Laravel only adds convenience around configuration, dependency injection, and queuing.
- How do I test LocationIQ geocoding in Laravel without hitting the real API?
- Because the provider accepts a PSR-18 HTTP client, inject a mock client that returns canned responses for geocoding and reverse geocoding requests. You can also wrap the provider in your own service and mock that service in Laravel feature tests. This avoids consuming LocationIQ quota and makes assertions deterministic.
- What are alternatives to geocoder-php/locationiq-provider for Laravel geocoding?
- Alternatives include other Geocoder PHP providers such as OpenStreetMap, Google Maps, Bing Maps, and Mapbox, depending on your data and licensing needs. You can also use LocationIQ alongside a fallback provider for redundancy. The right choice depends on coverage, rate limits, pricing, and whether you need forward geocoding, reverse geocoding, or both.
Weaver
How can I help you explore Laravel packages today?