PHPackages                             carlosmaiello/geocoder - 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. carlosmaiello/geocoder

ActiveLibrary

carlosmaiello/geocoder
======================

Common files for PHP Geocoder

4.2.2(6y ago)011MITPHPPHP ^7.0

Since Jan 2Pushed 5y agoCompare

[ Source](https://github.com/carlosmaiello/php-common)[ Packagist](https://packagist.org/packages/carlosmaiello/geocoder)[ Docs](http://geocoder-php.org)[ RSS](/packages/carlosmaiello-geocoder/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (3)Versions (69)Used By (0)

Common classes for the Geocoder
===============================

[](#common-classes-for-the-geocoder)

[![Build Status](https://camo.githubusercontent.com/ae439016be1b00fe0b8513387d3db4d9619e8e6e62693e10c2f2ca61ca4e6029/68747470733a2f2f7472617669732d63692e6f72672f67656f636f6465722d7068702f7068702d636f6d6d6f6e2e7376673f6272616e63683d6d6173746572)](http://travis-ci.org/geocoder-php/php-common)[![Latest Stable Version](https://camo.githubusercontent.com/d1bc9bd4ec125171ed134ec5e531f51bb2644eb796b19d201fc29698eda8683a/68747470733a2f2f706f7365722e707567782e6f72672f77696c6c647572616e642f67656f636f6465722f762f737461626c65)](https://packagist.org/packages/willdurand/geocoder)[![Total Downloads](https://camo.githubusercontent.com/0aab8817821aa71de6f80d77b31312e01b186e4eb12f503978e6852b303ccaec/68747470733a2f2f706f7365722e707567782e6f72672f77696c6c647572616e642f67656f636f6465722f646f776e6c6f616473)](https://packagist.org/packages/willdurand/geocoder)[![Monthly Downloads](https://camo.githubusercontent.com/3ac9557d19ffe997bfa60da5e998f41ba1acccaa99bdd218c3a88ea61e2748a5/68747470733a2f2f706f7365722e707567782e6f72672f77696c6c647572616e642f67656f636f6465722f642f6d6f6e74686c792e706e67)](https://packagist.org/packages/willdurand/geocoder)[![Code Coverage](https://camo.githubusercontent.com/ec5317337535ffdc3c96a9bb998b7a2d89e3d3eeab6a7ea596596126550dcf09/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f67656f636f6465722d7068702f7068702d636f6d6d6f6e2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/php-common)[![Quality Score](https://camo.githubusercontent.com/d45839aa2717cf99738bcd114e7f23a19a687376cec0f482f747909461b83a80/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f67656f636f6465722d7068702f7068702d636f6d6d6f6e2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/php-common)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

### Note

[](#note)

- This repository is **READ ONLY**
- Post issues and PRs at the main repository:

### History

[](#history)

Just some months before the release of 4.0 of `willdurand/geocoder` we changed the repository to from . The new repository will only contain classes and interfaces shared between multiple providers. The original repository is still used for issues and pull requests.

The new repository architecture allows us to use a [git subtree split](https://www.subtreesplit.com) from geocoder-php/Geocoder to geocoder-php/php-common and to each provider.

Versions before 4.0 `willdurand/geocoder` will still work as usual, but with the new repository.

### Install

[](#install)

In 99% of the cases you do **not** want to install this package directly. You are more likely to install one provider. Have a look at [the documentation](https://github.com/geocoder-php/Geocoder) to see the different providers.

```
composer require willdurand/geocoder
```

### Contribute

[](#contribute)

Contributions are very welcome! Send a pull request to the [main repository](https://github.com/geocoder-php/Geocoder) or report any issues you find on the [issue tracker](https://github.com/geocoder-php/Geocoder/issues).

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 77.3% 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 ~46 days

Recently: every ~247 days

Total

67

Last Release

2176d ago

Major Versions

1.7.0 → 2.0.02013-07-08

1.7.1 → 2.3.12013-10-22

2.8.1 → v3.0.0-alpha12014-12-18

2.8.2 → v3.0.0-alpha32015-02-13

v3.3.1 → 4.0.0-beta12017-06-17

PHP version history (4 changes)1.0.0PHP &gt;=5.3.0

v3.0.0-alpha1PHP &gt;=5.4.0

v3.3.1PHP ^5.5 || ^7.0

4.0.0-beta1PHP ^7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/122ddf761c1930e407cdf5a0a20a3f4570a5ea3ff1e465c07e97e413b53baf2c?d=identicon)[magrathea](/maintainers/magrathea)

---

Top Contributors

[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (58 commits)")[![jbelien](https://avatars.githubusercontent.com/u/1150563?v=4)](https://github.com/jbelien "jbelien (4 commits)")[![damienalexandre](https://avatars.githubusercontent.com/u/225704?v=4)](https://github.com/damienalexandre "damienalexandre (1 commits)")[![danhunsaker](https://avatars.githubusercontent.com/u/1534396?v=4)](https://github.com/danhunsaker "danhunsaker (1 commits)")[![ddinchev](https://avatars.githubusercontent.com/u/1397692?v=4)](https://github.com/ddinchev "ddinchev (1 commits)")[![eugenekurasov](https://avatars.githubusercontent.com/u/7052418?v=4)](https://github.com/eugenekurasov "eugenekurasov (1 commits)")[![glensc](https://avatars.githubusercontent.com/u/199095?v=4)](https://github.com/glensc "glensc (1 commits)")[![leevigraham](https://avatars.githubusercontent.com/u/25124?v=4)](https://github.com/leevigraham "leevigraham (1 commits)")[![maxhelias](https://avatars.githubusercontent.com/u/12966574?v=4)](https://github.com/maxhelias "maxhelias (1 commits)")[![Mechazawa](https://avatars.githubusercontent.com/u/1144171?v=4)](https://github.com/Mechazawa "Mechazawa (1 commits)")[![norkunas](https://avatars.githubusercontent.com/u/2722872?v=4)](https://github.com/norkunas "norkunas (1 commits)")[![Stadly](https://avatars.githubusercontent.com/u/7263579?v=4)](https://github.com/Stadly "Stadly (1 commits)")[![atymic](https://avatars.githubusercontent.com/u/50683531?v=4)](https://github.com/atymic "atymic (1 commits)")[![svrdlic](https://avatars.githubusercontent.com/u/8766956?v=4)](https://github.com/svrdlic "svrdlic (1 commits)")[![carlosmaiello](https://avatars.githubusercontent.com/u/3230041?v=4)](https://github.com/carlosmaiello "carlosmaiello (1 commits)")

---

Tags

geocodingabstractiongeocodergeoip

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/carlosmaiello-geocoder/health.svg)

```
[![Health](https://phpackages.com/badges/carlosmaiello-geocoder/health.svg)](https://phpackages.com/packages/carlosmaiello-geocoder)
```

###  Alternatives

[willdurand/geocoder

Common files for PHP Geocoder

17435.7M159](/packages/willdurand-geocoder)[league/geotools

Geo-related tools PHP 7.3+ library

1.4k5.3M26](/packages/league-geotools)[toin0u/geocoder-laravel

Geocoder Service Provider for Laravel

7385.1M13](/packages/toin0u-geocoder-laravel)[toin0u/geotools-laravel

Geo-related tools PHP library for Laravel 4 &amp; 5

250388.0k1](/packages/toin0u-geotools-laravel)[willdurand/geocoder-bundle

Integration of Geocoder into Symfony

3226.4M12](/packages/willdurand-geocoder-bundle)[toin0u/geotools

Geo-related tools PHP 7.3+ library

1.4k1.3k](/packages/toin0u-geotools)

PHPackages © 2026

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