PHPackages                             madeitbelgium/geocode-by-address - 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. madeitbelgium/geocode-by-address

ActiveLibrary[Utility & Helpers](/categories/utility)

madeitbelgium/geocode-by-address
================================

Laravel Geocode by address library

1.3.0(3y ago)0452LGPL-3.0-or-laterPHPPHP >=5.6CI failing

Since Nov 30Pushed 3y ago1 watchersCompare

[ Source](https://github.com/madeITBelgium/Geocode-By-Address)[ Packagist](https://packagist.org/packages/madeitbelgium/geocode-by-address)[ Docs](https://www.madeit.be)[ GitHub Sponsors](https://github.com/madeitbelgium)[ RSS](/packages/madeitbelgium-geocode-by-address/feed)WikiDiscussions master Synced yesterday

READMEChangelog (4)Dependencies (6)Versions (5)Used By (0)

PHP (Laravel) Geocode by address library
========================================

[](#php-laravel-geocode-by-address-library)

[![Build Status](https://camo.githubusercontent.com/4fb9c5f330a8c0630b456656836c620197da63f5c77a6ace6a0fa03d973d3d86/68747470733a2f2f7472617669732d63692e6f72672f6d616465495442656c6769756d2f67656f636f64652d62792d616464726573732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/madeITBelgium/geocode-by-address)[![Coverage Status](https://camo.githubusercontent.com/80901d4d6ad94178d0f8df5e73c2a2dbfbb37f4accc627fd44a3d3a6243e60b2/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6d616465495442656c6769756d2f67656f636f64652d62792d616464726573732f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/madeITBelgium/geocode-by-address?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/3ba467d78e4287c59964e5b7782d58b4eca92fdef43845211645fd6885cb1fc4/68747470733a2f2f706f7365722e707567782e6f72672f6d616465495442656c6769756d2f67656f636f64652d62792d616464726573732f762f737461626c652e737667)](https://packagist.org/packages/madeITBelgium/geocode-by-address)[![Latest Unstable Version](https://camo.githubusercontent.com/7f5ac00da759a2fc2319829f60e685353e27528dca081cda33c6661fcbe9c2d0/68747470733a2f2f706f7365722e707567782e6f72672f6d616465495442656c6769756d2f67656f636f64652d62792d616464726573732f762f756e737461626c652e737667)](https://packagist.org/packages/madeITBelgium/geocode-by-address)[![Total Downloads](https://camo.githubusercontent.com/67870e8b1e936ceb1f6c958726a8032cceae35eeca1c97f6f320da253e5fc6d0/68747470733a2f2f706f7365722e707567782e6f72672f6d616465495442656c6769756d2f67656f636f64652d62792d616464726573732f642f746f74616c2e737667)](https://packagist.org/packages/madeITBelgium/geocode-by-address)[![License](https://camo.githubusercontent.com/286de417367de358a793b62d0afabcb58a17006ebb692aa46b9ca48b2413a3e1/68747470733a2f2f706f7365722e707567782e6f72672f6d616465495442656c6769756d2f67656f636f64652d62792d616464726573732f6c6963656e73652e737667)](https://packagist.org/packages/madeITBelgium/geocode-by-address)

With this PHP (Laravel) package you can lookup GEO data by a given address.

Installation
============

[](#installation)

Require this package in your `composer.json` and update composer.

```
composer require madeitbelgium/geocode-by-address
```

```
"madeitbelgium/geocode-by-address": "^1.0"
```

After updating composer, add the ServiceProvider to the providers array in `config/app.php`

```
MadeITBelgium\Geocode\ServiceProvider\Geocode::class,
```

You can use the facade for shorter code. Add this to your aliases:

```
'Geocode' => MadeITBelgium\Geocode\Facade\Geocode::class,
```

Publish the configuration

```
php artisan vendor:publish --provider="MadeITBelgium\Geocode\ServiceProvider\Geocode"
```

Documentation
=============

[](#documentation)

Usage
-----

[](#usage)

```
use MadeITBelgium\Geocode\Geocode;

$geocode = new Geocode($type = 'geocode.xyz', $apikey = null, $client = null);
$geodata = $geocode->lookup('Nieuwstraat, Brussel, Belgium');
if($geodata !== false) {
    $latitude = $geodata[0];
    $longitude = $geodata[1];
}
```

In laravel you can use the Facade

```
use MadeITBelgium\Geocode\Facade\Geocode;
$geodata = Geocode::lookup('Nieuwstraat, Brussel, Belgium');
if($geodata !== false) {
    $latitude = $geodata[0];
    $longitude = $geodata[1];
}
```

Or you can use structured data structuredLookup($streetName, $streetNumber, $municipality, $postalCode, $country)

```
use MadeITBelgium\Geocode\Facade\Geocode;
$geodata = Geocode::structuredLookup('Nieuwstraat', '1', 'Brussel', '1000', 'Belgium');
if($geodata !== false) {
    $latitude = $geodata[0];
    $longitude = $geodata[1];
}
```

Supported types
---------------

[](#supported-types)

Currently supported GEO data providers: Google: 'google' Geocode.xyz: 'geocode.xyz' TomTom: 'tomtom' Atention! when using structuredLookup you need to provide 2 or 3 letter country code!

The complete documentation can be found at:

Support
=======

[](#support)

Support github or mail:

Contributing
============

[](#contributing)

Please try to follow the psr-2 coding style guide.

License
=======

[](#license)

This package is licensed under LGPL. You are free to use it in personal and commercial projects. The code can be forked and modified, but the original copyright author should always be included!

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 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 ~429 days

Total

4

Last Release

1433d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e3d01bc996f789c6362a12e51af7b19ad39ca580f77dc6ef4ff1754888391508?d=identicon)[MadeITBelgium](/maintainers/MadeITBelgium)

---

Top Contributors

[![madeITBelgium](https://avatars.githubusercontent.com/u/20304892?v=4)](https://github.com/madeITBelgium "madeITBelgium (26 commits)")

---

Tags

laraveladdressgeolatitudelongitudegeocodeOpenStreetMapgeodata

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/madeitbelgium-geocode-by-address/health.svg)

```
[![Health](https://phpackages.com/badges/madeitbelgium-geocode-by-address/health.svg)](https://phpackages.com/packages/madeitbelgium-geocode-by-address)
```

###  Alternatives

[stevebauman/location

Retrieve a user's location by their IP Address

1.3k7.6M65](/packages/stevebauman-location)[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)[jcf/geocode

Google Geocoding API for Laravel

48160.5k](/packages/jcf-geocode)[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[data-values/geo

Geographical value objects, parsers and formatters

20631.0k18](/packages/data-values-geo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)