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

ActiveLibrary

geocoder-php/mapquest-provider
==============================

Geocoder MapQuest adapter

4.4.0(1y ago)2268.9k↓14.2%22MITPHPPHP ^8.0CI failing

Since Jun 17Pushed 5mo ago2 watchersCompare

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

READMEChangelog (5)Dependencies (5)Versions (6)Used By (2)

MapQuest Geocoder provider
==========================

[](#mapquest-geocoder-provider)

[![Build Status](https://camo.githubusercontent.com/cb413d25569907f2dba41f3fb491725a5854bb7772e170682c0e09ca67772a9b/68747470733a2f2f7472617669732d63692e6f72672f67656f636f6465722d7068702f6d617071756573742d70726f76696465722e7376673f6272616e63683d6d6173746572)](http://travis-ci.org/geocoder-php/mapquest-provider)[![Latest Stable Version](https://camo.githubusercontent.com/edc7b39bfaded0236e896bae24ce7f4c1e2757bab905a17606762d0c52898d2c/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f6d617071756573742d70726f76696465722f762f737461626c65)](https://packagist.org/packages/geocoder-php/mapquest-provider)[![Total Downloads](https://camo.githubusercontent.com/5630033c7034c259b8d7548d9c8e2c37c74d41055a55411bb9484ec79e86e4bb/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f6d617071756573742d70726f76696465722f646f776e6c6f616473)](https://packagist.org/packages/geocoder-php/mapquest-provider)[![Monthly Downloads](https://camo.githubusercontent.com/e5e5450e15d66952db80a1b09b8568d23db4357bc337e691b3b927d8bccc8309/68747470733a2f2f706f7365722e707567782e6f72672f67656f636f6465722d7068702f6d617071756573742d70726f76696465722f642f6d6f6e74686c792e706e67)](https://packagist.org/packages/geocoder-php/mapquest-provider)[![Code Coverage](https://camo.githubusercontent.com/e978a129a941d3c7e347176e0fdc07b979d79205bc84c15126adade89023cccc/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f67656f636f6465722d7068702f6d617071756573742d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/mapquest-provider)[![Quality Score](https://camo.githubusercontent.com/f44fa92b58c3613ad2fe33e281c4db112e2f69617b498f51c890d147e6d6626d/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f67656f636f6465722d7068702f6d617071756573742d70726f76696465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/geocoder-php/mapquest-provider)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

This is the MapQuest 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.

### Install

[](#install)

```
composer require geocoder-php/mapquest-provider
```

### Geocode with more exact addresses

[](#geocode-with-more-exact-addresses)

The MapQuest Provider allows you to create and pass geocode queries based on a full Address object of class `Geocoder\Model\Address` or any other object that implements `Geocoder\Location`.

This will take advantage of what MapQuest calls the 5-box Input address format. Quote from [MapQuest Developer: Specifying Locations](https://developer.mapquest.com/documentation/common/forming-locations/):

> The 5-Box Input address format (which is compatible with JSON and XML), allows for a higher degree of address specification by entering the full address in its individual location parameters. The 5-Box Input format is beneficial as it bypasses the parsing functionality of the single-line request.

If you have an object of a class that implements `Geocoder\Location` stored in the variable `$address`, this new type of GeocodeQuery can be created with:

```
$query = GeocodeQuery::create('foobar');
$query = $query->withData(MapQuest::DATA_KEY_ADDRESS, $address);

```

If you want the GeocodeQuery to also work fine with all the other providers, you will need to convert the `$address` object to a text string first. Say you have stored this text string in the variable `$addressAsString`, the the example will read as follows:

```
$query = GeocodeQuery::create($addressAsString);
$query = $query->withData(MapQuest::DATA_KEY_ADDRESS, $address);

```

Here is a more complete example with use statements, and building of the address object:

**Example**

```
use Geocoder\Model\AddressBuilder;
use Geocoder\Provider\MapQuest\MapQuest;
use Geocoder\Query\GeocodeQuery;

$provider = new MapQuest($httpClient, $apiKey);

$addressBuilder = new AddressBuilder('Address provided by me');
$addressBuilder
  ->setStreetNumber(4868)
  ->setStreetName('Payne Rd');
  ->setLocality('Nashville');
  ->setSubLocality('Antioch');
  ->setAdminLevels([
      new AdminLevel(1, 'Tennessee', 'TN')
  ])
  ->setPostalCode('37013');
  ->setCountry('USA');
  ->setCountryCode('US');
$address = $addressBuilder->build();

$query = GeocodeQuery::create('dummy data');
$query = $query->withData(MapQuest::DATA_KEY_ADDRESS, $address);

$results = $provider->geocodeQuery($query);

```

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

51

—

FairBetter than 96% of packages

Maintenance59

Moderate activity, may be stable

Popularity38

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Total

5

Last Release

398d ago

PHP version history (5 changes)4.0.0PHP ^7.0

4.1.0PHP ^7.2

4.2.0PHP ^7.3 || ^8.0

4.3.0PHP ^7.4 || ^8.0

4.4.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 (28 commits)")[![jbelien](https://avatars.githubusercontent.com/u/1150563?v=4)](https://github.com/jbelien "jbelien (18 commits)")[![Chris53897](https://avatars.githubusercontent.com/u/7104259?v=4)](https://github.com/Chris53897 "Chris53897 (6 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)")[![TerjeBr](https://avatars.githubusercontent.com/u/2794247?v=4)](https://github.com/TerjeBr "TerjeBr (1 commits)")[![fbuchlak](https://avatars.githubusercontent.com/u/30214087?v=4)](https://github.com/fbuchlak "fbuchlak (1 commits)")[![JaZo](https://avatars.githubusercontent.com/u/3475007?v=4)](https://github.com/JaZo "JaZo (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[league/geotools

Geo-related tools PHP 7.3+ library

1.4k5.3M26](/packages/league-geotools)[geocoder-php/google-maps-provider

Geocoder GoogleMaps adapter

18517.9M44](/packages/geocoder-php-google-maps-provider)[geocoder-php/geo-plugin-provider

Geocoder GeoPlugin adapter

975.0M8](/packages/geocoder-php-geo-plugin-provider)[geocoder-php/nominatim-provider

Geocoder Nominatim adapter

354.4M27](/packages/geocoder-php-nominatim-provider)[geocoder-php/ipstack-provider

Geocoder Ipstack adapter

60334.1k2](/packages/geocoder-php-ipstack-provider)[swisnl/geocoder-php-nationaal-georegister-provider

PDOK (formerly Nationaal Georegister) provider for Geocoder PHP

28330.8k2](/packages/swisnl-geocoder-php-nationaal-georegister-provider)

PHPackages © 2026

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