Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Google Maps Geocoder provider

Build Status Latest Stable Version Total Downloads Monthly Downloads Code Coverage Quality Score Software License

This is the Google Maps provider from the PHP Geocoder. This is a READ ONLY repository. See the main repo for information and documentation.


$httpClient = new \GuzzleHttp\Client();

// 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 available. Please see this page for information on getting an API key.

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 \GuzzleHttp\Client();

// 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'));


composer require geocoder-php/google-maps-provider


Contributions are very welcome! Send a pull request to the main repository or report any issues you find on the issue tracker.