PHPackages vkr/geolocation-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. vkr/geolocation-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) vkr/geolocation-bundle ====================== A bundle for Symfony2/3 that offers fast way to get nearest points from geolocation data 1.1.1(9y ago)3154[2 issues](https://github.com/wladislavk/GeolocationBundle/issues)MITPHPPHP >=5.6 Since Jul 17Pushed 9y ago1 watchersCompare [ Source](https://github.com/wladislavk/GeolocationBundle)[ Packagist](https://packagist.org/packages/vkr/geolocation-bundle)[ Docs](https://github.com/wladislavk/GeolocationBundle)[ RSS](/packages/vkr-geolocation-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (4)Versions (5)Used By (0) About ===== [](#about) This bundle was created to sort out a rather nasty problem I've encountered - searching for a point in a large chunk of data that is the nearest one to some point N. There is a rather complicated formula that helps us do it precisely, however, it's a really bad idea to use it in your DB query - you will kill your database. This bundle provides a solution for this problem by creating a two-step algorithm that first executes a simple DB query that looks for any point that has a remote chance to be the nearest one and then using the script to apply the formula and choose a 'winner' among these points. The bundle consists of three services that you can use separately - first for step #1, second for step #2, third for talking to Doctrine. The bundle depends on Symfony and Doctrine, however, you do not need to actually use Doctrine if you prefer not to activate the third service. Installation ============ [](#installation) Nothing to install here, except for activating the bundle in `AppKernel.php`. Usage ===== [](#usage) Retrieving a bounding box ------------------------- [](#retrieving-a-bounding-box) First of all, we will need to create a bounding box which is a square chunk of land, and then find all points that lie inside that box. I assume that all your geospatial data uses degrees of latitude and longitude. To create a bounding box, we need to know the side of the square. As all our data is in degrees, we will use degrees for that measure as well. However, a degree of longitude corresponds to different distances, depending on the latitude. Therefore, we will measure the box in degrees of latitude, that are immutable. One degree of latitude equals 111.375 km. Here is how the box is created around the point with given latitude and longitude. ``` $boundingBoxFinder = $this->get('vkr_geolocation.bounding_box_finder'); $lat = 40; $lng = -100; $allowance = 0.5; $boundingBox = $this->boundingBoxFinder->setBoundingBox($lat, $lng, $allowance); ``` Here we have a square with a side of roughly 55 km (half a degree of latitude) with a point (40, -100) at the center. The desired allowance depends on how densely the points are distributed in your data source. For example, if you are searching for zip codes in a metropolitan zone, you wouldn't want to use anything more than 0.1 for allowance. If your coordinates are located near the international date line (longitude of +180/-180), the service will take that into account and will still give you a perfectly square box. If you prefer not to use the `BoundingBoxFinder` service, you can create the `BoundingBox` object yourself, according to the following rules: - `lat` property consists of an array with `min` and `max` values; - `lng` property consists of an array with one or more arrays of `min`and `max` values. Example: ``` $latPair = [ 'min' => 30, 'max' => 35, ]; $lngPairs = [ [ 'min' => '-100', 'max' => '-95', ], ]; $boundingBox = new VKR\GeolocationBundle\Entity\Perishable\BoundingBox($latPair, $lngPairs); ``` Querying the DB --------------- [](#querying-the-db) With the bounding box ready, we need to parse its contents into a DQL query. That is what the `doctrine_querier` service is for. However, you need to define a data source entity to use it. The entity must conform to `VKR\GeolocationBundle\Interfaces\GeolocatableEntityInterface`that defines `getLat()` and `getLng()` methods. The service will collect all points that lie inside your bounding box. ``` $doctrineQuerier = $this->get('vkr_geolocation.doctrine_querier'); $result = $doctrineQuerier->getRecords($boundingBox, YourEntity::class); ``` The contents of `$result` are nothing more than what you usually get from `getResult()` in Doctrine. Sometimes you might want to get a list of all values of a non-unique field that are encountered in a bounding box. For example, you have a DB with zip codes but you are only interested in cities. If this is the case, you can utilize `getDistinctRecords()`: ``` $result = $doctrineQuerier->getDistinctRecords($boundingBox, YourEntity::class, 'city'); ``` You will get a zero-indexed array of city names. Calculating the nearest point ----------------------------- [](#calculating-the-nearest-point) Finally, we can test which point inside your query result is the nearest one. ``` $calculator = $this->get('vkr_geolocation.nearest_point_calculator'); $index = $calculator->findNearestPoint($lat, $lng, $result); $nearestPointCoords = [ 'lat' => $result[$index]->getLat(), 'lng' => $result[$index]->getLng(), ]; ``` That's about it. Optional: defining the entity manager ------------------------------------- [](#optional-defining-the-entity-manager) If you are using a setup with multiple entity managers, you can define an optional parameter in `config.yml`. Suppose that your manager is called "my", then add this to `config.yml`: ``` vkr_geolocation: entity_manager_service: "doctrine.orm.my_entity_manager" ``` This way, the `doctrine_querier` service will query the DB using the specified entity manager. API === [](#api) *VKR\\GeolocationBundle\\Entity\\Perishable\\BoundingBox BoundingBoxFinder::setBoundingBox(float $lat, float $lng, float $allowanceLat)* *void DoctrineQuerier::\_\_construct(Doctrine\\ORM\\EntityManager $em)* *array|null DoctrineQuerier::getRecords(VKR\\GeolocationBundle\\Entity\\Perishable\\BoundingBox $boundingBox, string $entityClassName)* *array DoctrineQuerier::getDistinctRecords(VKR\\GeolocationBundle\\Entity\\Perishable\\BoundingBox $boundingBox, string $entityClassName, string $fieldName)* *int NearestPointCalculator::findNearestPoint(float $lat, float $lng, array $valueList)* The third argument must be a zero-indexed array of `VKR\GeolocationBundle\Interfaces\GeolocatableEntityInterface`objects. ### Health Score 25 — LowBetter than 37% of packages Maintenance7 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community7 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~88 days Total 4 Last Release 3319d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/79f5fa971e7fda7a6180c1bdfca4f819a43b7681ec4e04c66b184a082fb5a20f?d=identicon)[wladislavk](/maintainers/wladislavk) --- Top Contributors [![wladislavk](https://avatars.githubusercontent.com/u/11371476?v=4)](https://github.com/wladislavk "wladislavk (5 commits)") --- Tags geolocationSymfony2latitudelongitudesymfony3 ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/vkr-geolocation-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/vkr-geolocation-bundle/health.svg)](https://phpackages.com/packages/vkr-geolocation-bundle) ``` ### Alternatives [aws/aws-sdk-php-symfony A Symfony bundle for v3 of the AWS SDK for PHP 36517.7M22](/packages/aws-aws-sdk-php-symfony)[anthonymartin/geo-location Powerful GeoCoding library: Retrieve bounding box coordinates, distances between geopoints, point in polygon, get longitude and latitude from addresses and more with GeoLocation for PHP 196949.5k5](/packages/anthonymartin-geo-location)[php-coord/php-coord PHPCoord is a PHP library to aid in handling coordinates. It can convert coordinates for a point from one system to another and also calculate distance between points. 110914.5k12](/packages/php-coord-php-coord)[data-values/geo Geographical value objects, parsers and formatters 20631.0k18](/packages/data-values-geo)[laravie/geotools Geo-related tools PHP 7+ library 19105.4k1](/packages/laravie-geotools) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)