- How do I install silentgecko/store-locator in Laravel?
- Install the package with Composer using composer require silentgecko/store-locator. Then publish and run the package migrations so store addresses and coordinates have a database table. Check the package README for any service provider or configuration publishing steps required by your Laravel version.
- Which Laravel versions does silentgecko/store-locator support?
- The package is built for Laravel applications, but the exact supported Laravel and PHP versions should be confirmed in its composer.json and README before installing. Check those constraints against your application to avoid dependency conflicts.
- How do I query stores by distance or radius?
- Once store addresses and coordinates are stored, use the package's distance or radius query methods to retrieve stores within a given area. This powers find a store near me search by returning nearby locations based on coordinates. Review the README for the exact query API and distance units.
- Do I need to geocode store addresses myself?
- The package includes configurable geocoding, so you can configure how store addresses are resolved to coordinates. You should still verify provider credentials, rate limits, and API configuration in the package config. Existing stores need coordinates stored for distance and radius queries to work.
- What models and migrations does the package provide?
- It provides models and migrations for managing store addresses with coordinates. After installing, publish and run the migrations, then use the provided model to create and manage store records. Check the README for the exact model class and table names.
- How do I find the nearest store to a user?
- Store the user's latitude and longitude, then use the package's distance or radius search to return nearby stores. You can filter or order results based on the distance from the user's coordinates to power a find a store near me feature. The exact method names and distance units are documented in the package.
- Can I test the store locator queries in Laravel?
- Yes, you can test distance and radius queries in your Laravel test suite by creating store records with known coordinates and asserting the returned results. Use the package migrations in your test database setup and avoid depending on live geocoding calls where possible. Mock or configure the geocoding service for deterministic tests.
- What should I consider before using it in production?
- For production, make sure coordinates are populated for every store and that geocoding provider limits, credentials, and error handling are configured. Database indexing on latitude and longitude or spatial columns can help distance queries as your store count grows. Test radius queries with real coordinate data before launch.
- Are there alternatives to silentgecko/store-locator?
- Alternatives include building custom distance queries with spatial database functions or using other Laravel geolocation and store locator packages. Compare features such as geocoding configuration, radius search API, and migration support. The best choice depends on your Laravel version and whether you need a ready-made model and migration setup.
- How is silentgecko/store-locator maintained?
- Maintenance details depend on the package's repository activity, release history, and compatibility with current Laravel versions. Check the Composer package page and README for the latest release, issue tracker, and supported framework constraints. Pin a version in Composer and review upgrades before deploying.