PHPackages                             geocoder-php/google-maps-provider - 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. geocoder-php/google-maps-provider

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

geocoder-php/google-maps-provider
=================================

Geocoder GoogleMaps adapter

4.8.0(1y ago)18517.9M—5.6%1520MITPHPPHP ^8.0CI failing

Since Jun 17Pushed 5mo ago2 watchersCompare

[ Source](https://github.com/geocoder-php/google-maps-provider)[ Packagist](https://packagist.org/packages/geocoder-php/google-maps-provider)[ Docs](http://geocoder-php.org/Geocoder/)[ RSS](/packages/geocoder-php-google-maps-provider/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (13)Used By (20)

Google Maps Geocoder provider
=============================

[](#google-maps-geocoder-provider)

[![Build Status](https://camo.githubusercontent.com/71800e35daf78eaa32b7c49c924ca853ac7545cb0c699d1c8b072a340af03f8e/68747470733a2f2f7472617669732d63692e6f72672f67656f636f6465722d7068702f676f6f676c652d6d6170732d70726f76696465722e7376673f6272616e63683d6d6173746572)](http://travis-ci.org/geocoder-php/google-maps-provider)[![Latest Stable Version](https://camo.githubusercontent.com/6054a6a7301d2e661cc292a1e02730f5808894340153c727eefbeba63b95b867/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f676f6f676c652d6d6170732d70726f76696465722f762f737461626c65)](https://packagist.org/packages/geocoder-php/google-maps-provider)[![Total Downloads](https://camo.githubusercontent.com/b0df392a1ed210c5ead4c053e3b14ce2d6c6bb1b8af0e5c6226da96218b2c191/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f676f6f676c652d6d6170732d70726f76696465722f646f776e6c6f616473)](https://packagist.org/packages/geocoder-php/google-maps-provider)[![Monthly Downloads](https://camo.githubusercontent.com/e8ef6c4e88f4c2942d119c1e50014f8dd8bd1c3d7cbef8583c7d4ef411d52706/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f676f6f676c652d6d6170732d70726f76696465722f642f6d6f6e74686c792e706e67)](https://packagist.org/packages/geocoder-php/google-maps-provider)[![Code Coverage](https://camo.githubusercontent.com/7d5ef86348319995c20add78b20ba2016c9b91e4626e73200f1fd811014a91f0/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f67656f636f6465722d7068702f676f6f676c652d6d6170732d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/google-maps-provider)[![Quality Score](https://camo.githubusercontent.com/bb79af3494c8828109412a0d04e994c2de9d46ba849239d09358e362f2c9dbac/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f67656f636f6465722d7068702f676f6f676c652d6d6170732d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/google-maps-provider)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

This is the Google Maps provider from the PHP Geocoder. This is a **READ ONLY** repository. See the [main repo](https://github.com/geocoder-php/Geocoder) for information and documentation.

Usage
-----

[](#usage)

```
$httpClient = new \Http\Discovery\Psr18Client();

// You must provide an API key
$provider = new \Geocoder\Provider\GoogleMaps\GoogleMaps($httpClient, null, 'your-api-key');

$result = $geocoder->geocodeQuery(GeocodeQuery::create('Buckingham Palace, London'));
```

All requests require a valid API key, however google does have a [free tier](https://cloud.google.com/maps-platform/pricing/) available. Please see [this page for information on getting an API key](https://developers.google.com/maps/documentation/geocoding/get-api-key).

### Google Maps for Business

[](#google-maps-for-business)

Previously, google offered a "Business" version of their APIs. The service has been deprecated, however existing clients can use the static `business` method on the provider to create a client:

```
$httpClient = new \Http\Discovery\Psr18Client();

// Client ID is required. Private key is optional.
$provider = \Geocoder\Provider\GoogleMaps\GoogleMaps::business($httpClient, 'your-client-id', 'your-private-key');

$result = $geocoder->geocodeQuery(GeocodeQuery::create('Buckingham Palace, London'));
```

### Install

[](#install)

```
composer require geocoder-php/google-maps-provider
```

### 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

62

—

FairBetter than 99% of packages

Maintenance59

Moderate activity, may be stable

Popularity64

Solid adoption and visibility

Community37

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 50% 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 ~260 days

Recently: every ~436 days

Total

12

Last Release

398d ago

PHP version history (5 changes)4.0.0-beta1PHP ^7.0

4.5.0PHP ^7.2

4.6.0PHP ^7.3 || ^8.0

4.7.0PHP ^7.4 || ^8.0

4.8.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/401ccc5eea13c60cf807ae982af00e368e2166e2f26d8eb541dcd881a57385bc?d=identicon)[Nyholm](/maintainers/Nyholm)

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

---

Top Contributors

[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (51 commits)")[![jbelien](https://avatars.githubusercontent.com/u/1150563?v=4)](https://github.com/jbelien "jbelien (27 commits)")[![Chris53897](https://avatars.githubusercontent.com/u/7104259?v=4)](https://github.com/Chris53897 "Chris53897 (7 commits)")[![svrdlic](https://avatars.githubusercontent.com/u/8766956?v=4)](https://github.com/svrdlic "svrdlic (4 commits)")[![atymic](https://avatars.githubusercontent.com/u/50683531?v=4)](https://github.com/atymic "atymic (3 commits)")[![aditya-cherukuri](https://avatars.githubusercontent.com/u/13918532?v=4)](https://github.com/aditya-cherukuri "aditya-cherukuri (1 commits)")[![kornrunner](https://avatars.githubusercontent.com/u/725986?v=4)](https://github.com/kornrunner "kornrunner (1 commits)")[![leevigraham](https://avatars.githubusercontent.com/u/25124?v=4)](https://github.com/leevigraham "leevigraham (1 commits)")[![nicolas-grekas](https://avatars.githubusercontent.com/u/243674?v=4)](https://github.com/nicolas-grekas "nicolas-grekas (1 commits)")[![norkunas](https://avatars.githubusercontent.com/u/2722872?v=4)](https://github.com/norkunas "norkunas (1 commits)")[![JaZo](https://avatars.githubusercontent.com/u/3475007?v=4)](https://github.com/JaZo "JaZo (1 commits)")[![arubacao](https://avatars.githubusercontent.com/u/7462542?v=4)](https://github.com/arubacao "arubacao (1 commits)")[![dkemper](https://avatars.githubusercontent.com/u/1893744?v=4)](https://github.com/dkemper "dkemper (1 commits)")[![farskies](https://avatars.githubusercontent.com/u/163437514?v=4)](https://github.com/farskies "farskies (1 commits)")[![fbuchlak](https://avatars.githubusercontent.com/u/30214087?v=4)](https://github.com/fbuchlak "fbuchlak (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/geocoder-php-google-maps-provider/health.svg)

```
[![Health](https://phpackages.com/badges/geocoder-php-google-maps-provider/health.svg)](https://phpackages.com/packages/geocoder-php-google-maps-provider)
```

###  Alternatives

[geocoder-php/plugin

Plugins to Geocoder providers

705.1M2](/packages/geocoder-php-plugin)[geocoder-php/here-provider

Geocoder here adapter

131.2M3](/packages/geocoder-php-here-provider)[smile/module-store-locator

Smile Store Locator

51516.6k4](/packages/smile-module-store-locator)[geocoder-php/mapbox-provider

Geocoder Mapbox adapter

111.0M2](/packages/geocoder-php-mapbox-provider)[smile/module-map

Smile Map Utilities Module

10536.8k2](/packages/smile-module-map)[nonsapiens/realaddressfactory

Creates real-world street addresses from Google Maps, to use in database seeding, unit tests, or anything else. Supports Laravel 11+, and Faker

4910.2k7](/packages/nonsapiens-realaddressfactory)

PHPackages © 2026

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