geocoder-php/Geocoder
64.9
Adequate · 17 November 2026
12.1k
lines of production code
PHP
primary language
5
measurements over time
What this system is
This system is a PHP geocoding library that standardizes address resolution and reverse geocoding across numerous external providers. It provides a unified interface for querying location data, supporting both street addresses and IP-based geolocation through a modular provider architecture. The library also includes utilities for formatting results, serializing geographic data into standard formats like GeoJSON, and applying middleware for caching and logging.
How it got here
2011–2017 — PHP Geocoder 5.0 modernization
67 changes.
The project underwent a major architectural overhaul to align with PHP Geocoder 5.0 standards, replacing legacy autoloading and HTTP clients with Composer and PSR-18. This period introduced a strict, typed data model with immutable query objects and expanded the library with new providers, caching, and plugin middleware. Legacy components and deprecated services were removed while comprehensive test coverage was established for the new architecture.
2018–2020 — Provider expansion and model enrichment
19 changes.
This period focused on significantly expanding the library's provider ecosystem by integrating new geocoding services such as Algolia Places, Ipstack, Photon, GraphHopper, Geocode Earth, Google Maps Places, Pelias, IP2Location, and Azure Maps. Concurrently, existing providers like Nominatim, Here, Mapbox, and Photon were enhanced with detailed address models exposing finer-grained location metadata and OpenStreetMap-specific identifiers. The work was supported by the addition of comprehensive test suites and cached fixtures to ensure reliability across the new and updated integrations.
Features
Add Geocode Earth provider
Introduces a new Geocode Earth provider that extends the existing Pelias provider, allowing users to perform geocoding and reverse geocoding against the Geocode Earth API (https://api.geocode.earth/) by supplying an API key and a PSR-18 HTTP client.
src/Provider/GeocodeEarth · high confidence
Add Geonames-specific model classes for country and address data
Introduced new \CountryInfo\ and \GeonamesAddress\ model classes in the Geonames provider to expose provider-specific data fields. \CountryInfo\ adds access to country details such as bounds, continent, capital, languages, ISO codes, population, and currency. \GeonamesAddress\ extends the base address model to include Geonames-specific attributes like fcode, fclName, population, geonameId, alternate names, and ascii name, allowing users to access this richer geographic context.
src/Provider/Geonames/Model · high confidence
Add IP2Location provider
Introduces a new IP2Location provider that enables IP geolocation via the IP2Location Web Service (WS9 package). Users can now instantiate the provider with a PSR-18 HTTP client and an API key to resolve IP addresses to location data (latitude, longitude, city, region, country, and postal code); reverse geocoding is not supported.
src/Provider/IP2Location, src/Provider/IP2LocationBinary · high confidence
Add IpInfo provider for IP geocoding
A new IpInfo provider has been added to the library, enabling users to geocode IP addresses using the ipinfo.io service. The provider supports forward geocoding for valid IPv4 and IPv6 addresses (including localhost handling) and returns location data such as latitude, longitude, city, postal code, region, and country code. Reverse geocoding is not supported by this provider.
src/Provider/IpInfo · high confidence
Add Ipstack geocoding provider
Introduces a new Ipstack provider for the PHP Geocoder library, enabling IP-based geolocation lookups. The provider supports forward geocoding of IPv4 and IPv6 addresses, including optional language localization for results, and extracts administrative region data (region name) as an admin level. Reverse geocoding is not supported by this provider. It requires an API key and uses a PSR-18 HTTP client for requests.
src/Provider/Ipstack, src/Provider/Mapbox · high confidence
Add MapboxAddress model for Mapbox provider
A new MapboxAddress class has been added to the Mapbox provider's model layer. This class extends the base Address model and introduces specific fields for Mapbox geocoding data, including ID, street number, street name, result type, formatted address, and neighborhood. It provides immutable setter methods (with\*) and getter methods to access these specific attributes, enabling users to retrieve detailed location information from Mapbox API responses.
src/Provider/Mapbox/Model · high confidence
Add PickPoint geocoder provider
Users can now integrate the PickPoint geocoding service into their applications. This new provider supports both forward geocoding (address to coordinates) and reverse geocoding (coordinates to address) by querying the PickPoint API (https://api.pickpoint.io/v1). It requires a valid API key for authentication and utilizes a PSR-18 HTTP client for network requests, returning structured location data including administrative levels, postal codes, and geographic bounds.
(repo-wide) · high confidence
Add plugin promise implementations for geocoder results
Introduced \GeocoderFulfilledPromise\ and \GeocoderRejectedPromise\ classes within the \Geocoder\\Plugin\\Promise\ namespace to handle asynchronous geocoding operations. These classes implement the \Http\\Promise\\Promise\ interface, allowing the plugin to integrate with existing promise-based workflows by wrapping successful \Collection\ results or \Exception\ errors into standardized promise states.
src/Plugin/Promise · high confidence
Expanded GoogleAddress model with granular location details
The GoogleAddress model now exposes a significantly richer set of properties derived from the Google Maps API, including place ID, location type, formatted address, street address, intersection, postal code suffix, and various specific address components such as political area, colloquial area, ward, neighborhood, premise, subpremise, natural feature, airport, park, point of interest, and establishment. It also introduces support for sub-locality levels via an AdminLevelCollection and tracks whether a result is a partial match, allowing users to access more precise geocoding data than before.
src/Provider/GoogleMaps/Model · high confidence
Here provider model exposes location metadata and additional data
The HereAddress model now provides access to specific location metadata (locationId, locationType, locationName) and supports storing arbitrary additional data and shape information. Users can retrieve these new fields via getter methods and update them using immutable with\* methods, allowing for more detailed address resolution results from the Here provider.
src/Provider/Here/Model · high confidence
Initial release of the IpInfoDb provider
This change introduces the IpInfoDb provider, allowing users to resolve IP addresses to geographic locations (city, country, timezone) using the IpInfoDb API. The provider supports IPv4 addresses only, offers configurable precision (city or country level), and requires an API key for authentication. It is built on PSR-18 HTTP clients and includes standard provider metadata and changelog documentation.
src/Provider/IpInfoDb · high confidence
Initial release of the MaxMind Binary provider
This change introduces the MaxMind Binary provider as a standalone component, enabling IP-to-location geocoding for IPv4 addresses using the MaxMind binary database format. The provider requires the MaxMind PHP extension (geoip) to be installed and loaded, and it supports both forward geocoding (IP to location) while explicitly rejecting reverse geocoding and IPv6 addresses. The implementation includes proper UTF-8 encoding for country and city names, strict type declarations, and standard provider metadata such as changelog, license, and PHPUnit configuration.
src/Provider/MaxMindBinary · high confidence
Initial release of the common-http package
This change introduces the \src/Http\ package, which provides common classes for HTTP-based geocoders, including the \AbstractHttpProvider\ base class. The package establishes the foundational structure for the library, including a CHANGELOG detailing version history from 4.0.0-beta1 through 4.7.0, a PHPUnit configuration for version 9.3, and standard repository metadata files like \.gitattributes\ and \LICENSE\. This separation allows users to install HTTP-specific dependencies independently of other geocoder providers.
src/Http · high confidence
Introduce Algolia Places provider for geocoding
Adds a new Algolia Places provider to the geocoder library, enabling users to perform forward geocoding of street addresses, cities, and points of interest (such as airports, train stations, and bus stops) via the Algolia Places API. The provider supports optional authentication via API key and application ID for higher request limits, allows filtering by specific place types and ISO country codes, and requires a PSR-18 HTTP client. Reverse geocoding is not supported by this provider.
src/Provider/AlgoliaPlaces · high confidence
Introduce Azure Maps geocoder provider
Added a new Azure Maps provider that enables geocoding and reverse geocoding via the Azure Maps API. Users can now instantiate the provider with an HTTP client and a subscription key to resolve addresses or coordinates, with support for options such as language, country set, and result limits.
src/Provider/AzureMaps · high confidence
Introduce GeoIP2 provider for IP geolocation
Adds a new GeoIP2 provider that enables geocoding of IP addresses using MaxMind GeoIP2 databases or the Precision Web Service. The provider supports city and country lookup models, returns detailed location data (including country, city, coordinates, timezone, and postal code), and handles specific exceptions for invalid credentials or quota limits. Reverse geocoding is not supported.
src/Provider/GeoIP2 · high confidence
Introduce Google Maps Places provider
Adds a new Google Maps Places provider that enables geocoding and reverse geocoding via the Google Places API. Users can perform text-based searches (Find and Search modes) and reverse lookups using either Search or Nearby modes, with support for filtering by location bounds, language, and specific place types.
src/Provider/GoogleMapsPlaces · high confidence
Introduce Photon geocoder provider
Adds the Photon provider, enabling geocoding and reverse geocoding via the Photon API (photon.komoot.io). The implementation supports query parameters for latitude/longitude, bounding box, multiple layers, and OpenStreetMap tag filters, and returns enriched address details including state, county, district, and OSM identifiers.
src/Provider/Photon · high confidence
Introduce Plugin middleware for Geocoder providers
Adds a new plugin system that allows wrapping a Geocoder provider with middleware to transform queries or collections. The \PluginProvider\ implements the standard \Provider\ interface, chaining \Plugin\ instances around the underlying provider call. Plugins can intercept requests, modify them, or restart the chain (up to a configurable \max\_restarts\ limit, defaulting to 10), with a \LoopException\ thrown if the restart limit is exceeded. This enables features like caching, rate limiting, or logging to be added to any provider without modifying the provider itself.
src/Plugin · high confidence
Introduce ProviderCache for geocaching results
Adds a new \ProviderCache\ class that wraps an existing geocoder provider to cache query results using any PSR-6 compatible cache implementation. Users can now significantly reduce API calls by storing responses in a cache store, with optional support for setting a specific cache lifetime (in seconds) and separating cache keys by provider name to avoid collisions.
src/Provider/Cache · high confidence
Introduce new Address model and supporting value objects
The \src/Common/Model\ directory now contains a new \Address\ class that implements the \Location\ interface, replacing the previous implicit structure. This class exposes specific fields for coordinates, bounds, street details, locality, postal code, sub-locality, administrative levels, country, and timezone, along with a \providedBy\ identifier. To support this, new value-object classes have been added: \Coordinates\ and \Bounds\ for spatial data, \Country\ for location metadata, \AdminLevel\ and \AdminLevelCollection\ for hierarchical administrative divisions, and \AddressCollection\ to manage lists of locations. An \AddressBuilder\ is also provided to facilitate the construction of \Address\ instances. This change establishes a stricter, more explicit data model for geocoding results.
src/Common/Model · high confidence
Introduce new Dumper classes for location serialization
The \src/Common/Dumper\ directory now contains a new set of classes that implement the \Dumper\ interface to serialize \Location\ objects into various formats. This includes \GeoJson\ and \GeoArray\ for JSON-based outputs, \Gpx\, \Kml\, \Wkt\, and \Wkb\ for geographic data exchange standards, supported by \AbstractDumper\ and \AbstractArrayDumper\ base classes. Users can now utilize these specific dumpers to convert geocoding results into structured strings or arrays suitable for mapping and GIS applications.
src/Common/Dumper · high confidence
Introduces new query plugins for bounds, caching, limits, locale, logging, and data injection
This change adds five new plugin classes (BoundsPlugin, CachePlugin, LimitPlugin, LocalePlugin, LoggerPlugin) and refactors the legacy AbstractProvider into QueryDataPlugin. BoundsPlugin allows users to enforce geographic search bounds on geocode queries. CachePlugin integrates with PSR-16 cache implementations to store query results, supporting configurable lifetime and precision for reverse geocoding coordinates. LimitPlugin enforces a maximum number of results. LocalePlugin sets the query language when not already specified. LoggerPlugin records query duration and result counts or errors using PSR-3 loggers. QueryDataPlugin enables attaching arbitrary key-value data to queries, replacing the old HTTP adapter dependency with a generic data injection mechanism.
src/Plugin/Plugin · high confidence
MapQuest provider released as a standalone package
The MapQuest geocoding provider is now available as a separate, standalone package (\geocoder-php/mapquest-provider\) rather than being bundled within the main Geocoder library. This change includes the provider's source code, configuration files (such as \.gitattributes\ and \phpunit.xml.dist\), and documentation, allowing users to install it independently via Composer. The provider supports PHP 8.1 and PHP Geocoder 5, and has migrated from the PHP-HTTP client to the PSR-18 standard.
src/Provider/MapQuest, src/Provider/MaxMind · high confidence
New GraphHopper provider for geocoding
Added a new GraphHopper provider that enables geocoding and reverse geocoding via the GraphHopper API. The provider accepts a PSR-18 HTTP client and an API key, supports bounding box filtering for geocode queries, and returns structured address data including bounds, street details, and locality information.
src/Provider/GraphHopper · high confidence
New Pelias geocoder provider
Adds a new Pelias provider to the geocoder library, enabling users to geocode street addresses and perform reverse geocoding against a Pelias API instance. The implementation supports query parameters for filtering by layers and country boundaries, respects locale settings via Accept-Language headers, and exposes additional address details such as id, layer, source, name, confidence, and accuracy through the new PeliasAddress model.
src/Provider/Pelias · high confidence
New StringFormatter for address stringification
A new StringFormatter class has been added to the Geocoder package, allowing users to transform Location instances into formatted string representations using a template-based approach with placeholders for street number, name, locality, postal code, sub-locality, admin levels, country, country code, and timezone.
src/Common/Formatter · high confidence
New model classes for Google Places API data
Added new model classes (GooglePlace, OpeningHours, Photo, PlusCode) to represent structured data from the Google Places provider. These classes expose properties such as place ID, name, types, formatted address, vicinity, icon, plus code, photos, price level, rating, phone number, website, and opening hours, enabling users to access detailed place information returned by the API.
src/Provider/GoogleMapsPlaces/Model · high confidence
Nominatim address model now exposes quarter, neighbourhood, and extra metadata
The Nominatim provider's address model has been expanded to include new fields for finer-grained location data. Users can now access the 'quarter' and 'neighbourhood' components of an address, as well as additional metadata such as OSM type and ID, category, display name, attribution, and arbitrary tags. This allows for more detailed reverse-geocoding results and better integration with OpenStreetMap-specific data structures.
src/Provider/Nominatim/Model · high confidence
OpenCage provider now exposes confidence and additional address annotations
The OpenCage provider now returns a \confidence\ score for each geocoded result, allowing users to assess the reliability of the returned location. Additionally, the provider exposes several new address annotations via the \OpenCageAddress\ model, including MGRS, Maidenhead, geohash, what3words, and a formatted address string, providing richer context for geocoding results.
src/Provider/OpenCage · high confidence
Yandex provider now exposes location kind and name in address model
The Yandex provider's address model (YandexAddress) now includes dedicated properties and accessor methods for the location's name and kind, in addition to the existing precision field. Users can now retrieve the specific name and type (kind) of a geocoded location returned by Yandex, allowing for more granular handling of address data beyond just coordinates and precision.
src/Provider/Yandex/Model · high confidence
Removals
Mapzen provider deprecated and marked as abandoned
The Mapzen geocoder provider is now deprecated and marked as abandoned because the Mapzen API service shut down on February 1, 2018. The provider class remains in the codebase but carries deprecation notices, and the CHANGELOG explicitly states this is the final release (4.0.1) with no further support. Users relying on this provider will receive no results from the service and should migrate to an alternative geocoder provider listed in the main repository.
src/Provider/Mapzen · high confidence
Removal of legacy Geocoder class and interface
The legacy \Geocoder\ class and \GeocoderInterface\ have been removed from the \src/Geocoder\ directory. This deletion eliminates the previous implementation that relied on instance properties for storing geocoding results (such as latitude, longitude, city, and country) and a single-provider model, marking the end of support for this specific API surface.
src/Geocoder · high confidence
Removed IpInfoDb and Yahoo geocoding providers
The IpInfoDbProvider and YahooProvider classes have been removed from the codebase. Users relying on these specific geocoding services will no longer be able to resolve addresses through them and must switch to alternative providers supported by the library.
src/Geocoder/Provider · high confidence
Behavioural changes
Bing Maps provider now requires a PSR-18 HTTP client
The Bing Maps provider has migrated from the legacy PHP-HTTP client interface to the standard PSR-18 \ClientInterface\. This change updates the provider's constructor to accept a PSR-18 compliant HTTP client, ensuring compatibility with modern HTTP libraries and simplifying integration for users upgrading to PHP Geocoder 5.
src/Provider/BingMaps · high confidence
Chain provider now supports configurable log levels for geocoding errors
The Chain provider now allows users to configure the PSR-3 log levels used when logging errors from individual providers during geocoding and reverse geocoding operations. Previously, errors were logged at a fixed level; now, users can set distinct log levels for forward geocoding queries (via \setGeocodeQueryLogLevel\) and reverse geocoding queries (via \setReverseQueryLogLevel\), enabling more granular control over error reporting and log verbosity.
src/Provider/Chain · high confidence
FreeGeoIp provider now uses freegeoip.app and allows custom base URLs
The FreeGeoIp provider has migrated its default endpoint from the shut-down freegeoip.net to freegeoip.app. Additionally, the provider constructor now accepts an optional $baseUrl argument, allowing users to configure a custom endpoint (such as a self-hosted instance) instead of relying on the default hosted service.
src/Provider/FreeGeoIp · high confidence
GeoIPs provider marked as deprecated and abandoned
The GeoIPs provider is now deprecated because the GeoIPs service has shut down. Users will see deprecation notices when using the provider, and the README explicitly states that the package is abandoned, directing users to alternative IP geolocation providers.
src/Provider/GeoIPs · high confidence
GeoPlugin provider returns empty collection for unrecognized IPs
The GeoPlugin provider now returns an empty AddressCollection when the geocoding service returns a response with no location data (e.g., empty region, city, country, and zero coordinates), instead of returning a result with null fields. This change ensures that queries for unrecognized or unlocatable IP addresses yield no results, aligning with the behavior described in the 4.0.1 changelog entry for "Better check if we got a empty result."
src/Provider/GeoPlugin · high confidence
Geocoder interface refactored to extend Provider with typed geocoding methods
The core \Geocoder\ interface has been moved to \src/Common\ and refactored to extend the \Provider\ interface, replacing the previous \HttpAdapterInterface\ which only defined HTTP-specific methods like \getContent\. The new interface defines strongly-typed \geocode(string $value)\ and \reverse(float $latitude, float $longitude)\ methods that return a \Collection\, establishing a unified contract for all geocoding providers. This change is implemented across common components such as \ProviderAggregator\, \StatefulGeocoder\, and \TimedGeocoder\, which now adhere to this standardized provider-based API.
src/Common · high confidence
Geoip provider extracted to standalone package
The Geoip provider has been separated from the main Geocoder repository into its own standalone package. This change includes the provider implementation (Geoip.php), configuration files (.gitattributes, .gitignore, phpunit.xml.dist), and documentation (Readme.md, CHANGELOG.md, LICENSE). The provider relies on the deprecated PHP GeoIP extension and only supports IPv4 addresses for geocoding queries; reverse geocoding is not supported. Users should note that this provider is deprecated in favor of the Geoip2 provider.
src/Provider/Geoip · high confidence
Geonames provider now uses PSR-18 HTTP client
The Geonames provider has migrated its HTTP client dependency from the legacy PHP-HTTP interface to the standard PSR-18 \ClientInterface\. This change updates the provider's constructor to accept a PSR-18 compatible HTTP client, ensuring compatibility with modern HTTP client implementations while maintaining existing geocoding, reverse geocoding, and country info capabilities.
src/Provider/ArcGISOnline, src/Provider/Geonames · high confidence
Google Maps provider now uses PSR-18 HTTP client
The Google Maps provider has migrated from the legacy PHP-HTTP client to a PSR-18 HTTP client. This change updates the underlying HTTP adapter interface, meaning users must now provide a PSR-18 compatible HTTP client (such as \Http\\Discovery\\Psr18Client\) when instantiating the provider, rather than the previous PHP-HTTP adapter.
src/Provider/GoogleMaps · high confidence
HTTP provider now requires a PSR-18 client instead of the legacy PHP-HTTP client
The AbstractHttpProvider has been updated to depend on a PSR-18 HTTP client (Psr\\Http\\Client\\ClientInterface) rather than the older PHP-HTTP client interface. This change aligns the provider with modern HTTP standards, simplifying integration for users who already utilize PSR-18 compliant clients, while maintaining backward compatibility for factory creation via PSR-17 or the deprecated MessageFactory.
src/Http/Provider · high confidence
HostIp provider now returns empty collections for unknown or private addresses
The HostIp provider has been updated to return an empty address collection instead of a result with placeholder data when an IP address is not found or is identified as private. This change, implemented in the AbstractHostIp base class, ensures that callers receive a clean empty collection for 'Unknown City/Country' or 'Private Address' responses from the HostIp API, rather than addresses containing generic placeholder strings.
src/Provider/HostIp · high confidence
Introduce a unified exception hierarchy under the Geocoder\\Exception namespace
The library now provides a dedicated set of exception classes in the Geocoder\\Exception namespace, replacing scattered or test-based implementations. A new Exception interface extends PHP's Throwable interface, serving as the base for specific exceptions such as CollectionIsEmpty, ExtensionNotLoaded, InvalidCredentials, InvalidServerResponse, LogicException, OutOfBounds, ProviderNotRegistered, QuotaExceeded, UnsupportedOperation, and FunctionNotFound. These exceptions offer clearer error signaling for common geocoder scenarios (e.g., empty collections, missing extensions, invalid credentials, quota limits, unsupported operations, and missing functions), with some providing static factory methods for contextual messages. This change improves error handling consistency and makes it easier for users to catch and react to specific geocoder-related failures.
src/Common/Exception · high confidence
Introduce immutable Query objects with builder methods
The query layer now uses immutable value objects for geocoding requests. New classes GeocodeQuery and ReverseQuery implement the Query interface, replacing previous mutable patterns. Users can now construct queries via static create() or fromCoordinates() methods and configure them using fluent, immutable builder methods such as withText, withCoordinates, withBounds, withLocale, withLimit, and withData. Each method returns a new instance, ensuring thread safety and predictable state. The classes also implement \_\_toString for logging and unique key generation.
src/Common/Query · high confidence
Nominatim provider now uses JSON (v2) format and PSR-18 client
The Nominatim provider has been updated to communicate with the Nominatim API using the JSON (v2) response format instead of the previous XML format, and it now relies on a PSR-18 HTTP client rather than the older PHP-HTTP client. This change improves compatibility with modern PHP standards and ensures correct parsing of address details, extra tags, and query parameters like country codes and viewboxes. Users must ensure their HTTP client implementation adheres to PSR-18 and provide a User-Agent string as required by the Nominatim Usage Policy.
src/Provider/Nominatim · high confidence
PhotonAddress model exposes OSM details and administrative subdivisions
The Photon provider's address model now exposes OpenStreetMap-specific identifiers (OSM ID, type, and tag) alongside administrative subdivisions including state, county, and district. Additionally, the locality getter has been updated to fall back to the address name when the result type is 'city', ensuring more accurate city-level locality data for users.
src/Provider/Photon/Model · high confidence
Provider interface refactored to use query objects and strict typing
The provider contract has been updated to enforce strict types and a more structured API. The interface (renamed from ProviderInterface to Provider) now requires providers to implement geocodeQuery and reverseQuery methods that accept specific GeocodeQuery and ReverseQuery objects, replacing the previous getData method. Additionally, the interface and the new AbstractProvider base class include strict type declarations, and the abstract provider now provides a helper for handling localhost special cases.
src/Common/Provider · high confidence
Removed custom PSR-0 autoloader in favor of Composer
The custom PSR-0 autoloader previously defined in src/autoload.php has been removed. The application now relies on Composer for dependency management and class autoloading, simplifying the bootstrap process and aligning with modern PHP standards.
src · high confidence
TomTom provider now includes postal codes in reverse geocoding results
The TomTom provider has been updated to extract and return the postal code field when performing reverse geocoding queries. Previously, reverse lookups only returned location coordinates, street details, and country information; users can now access the postal code in the resulting address objects, aligning reverse geocoding capabilities with those of forward geocoding.
src/Provider/TomTom · high confidence
Upgrade to PHPUnit 9 and modernize test configuration
The test suite has been upgraded to PHPUnit 9, requiring a new \phpunit.xml.dist\ configuration that uses the Composer autoloaded \vendor/autoload.php\ as the bootstrap file instead of the legacy \tests/bootstrap.php\. The test discovery scope has shifted from the root \./tests/\ directory to the provider-specific \./src/\*/Tests/\ directories, and code coverage reporting is now configured to explicitly exclude test and vendor subdirectories. Additionally, the configuration now supports environment variables for API keys and allows users to bypass the caching layer via the \USE\_CACHED\_RESPONSES\ setting.
(repo-wide) · high confidence
Yandex provider now requires an API key and uses PSR-18
The Yandex geocoder provider has been updated to require an API key for authentication, which must now be passed to the constructor. Additionally, the provider has migrated from the PHP-HTTP client to a PSR-18 HTTP client, and the constructor now accepts a \toponym\ parameter to bias reverse geocoding results.
src/Provider/Yandex · high confidence
Test coverage
Add tests for the OpenRouteService provider; Added ArcGIS Online provider tests and cached responses; Added cached API responses for Google Maps provider tests; Added cached API responses for IP2Location provider tests; Added cached API responses for OpenCage geocoder tests; Added cached GeoPlugin test responses; Added test fixtures for Algolia Places provider; Added tests for AbstractHttpProvider's HTTP client getter; Added tests for Azure Maps provider; Added tests for HostIp and HostIpXml providers; Added tests for Nominatim provider features and edge cases; Added tests for Query \_\_toString serialization; Added tests for StringFormatter address formatting; Added tests for address dumper components; Added tests for the GeoIPs provider; Added tests for the Pelias geocoding provider; Added tests for the Yandex geocoder provider; Added unit and integration tests for the GeoIP2 provider; Added unit and integration tests for the MaxMind Binary provider; Added unit tests for Address and AddressCollection models; Added unit tests for Geocoder Plugin components; Added unit tests for ProviderAggregator and TimedGeocoder; Added unit tests for the Chain provider; Added unit tests for the ProviderCache component; Initial test suite for the Photon geocoding provider; Removed legacy Geocoder unit tests; Removed legacy test bootstrap file; Removed legacy test suite for AbstractProvider, IpInfoDb, and Yahoo providers; Updated BingMaps test fixtures to remove trailing newlines; Updated Geonames test fixtures for API response changes; Updated TomTom provider test fixtures.
Dependencies
Update provider dependencies to support willdurand/geocoder 4.0 and 5.0
All geocoder provider packages have been updated to require willdurand/geocoder ^4.0\|^5.0, ensuring compatibility with the latest major versions of the core geocoder library. Common HTTP providers also now depend on geocoder-php/common-http ^4.0, and specific providers like GeoIP2 and GeoPlugin have been updated to support geoip2/geoip2 ^2.0\|^3.0.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 67.1 → 64.9 (-2.2)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 71.0 → 70.1 (-0.9)
- Architecture 96.8 → 97.3 (+0.5)
- Maturity 54.4 → 50.3 (-4.1)
- Readiness 90.0 → 89.0 (-1.0)
- Security 80.7 → 80.7 (0.0)
Resolved (7)
- Duplicated block (10 lines × 2) (src/Provider/IP2LocationBinary/IP2LocationBinary.php)
- Duplicated block (11 lines × 3) (src/Provider/GeoIPs/GeoIPs.php)
- Duplicated block (14 lines × 2) (src/Provider/Here/Here.php)
- Duplicated block (8 lines × 2) (src/Provider/FreeGeoIp/FreeGeoIp.php)
- Edited copy of a member (16 corresponding lines) (src/Provider/LocationIQ/LocationIQ.php)
- Further sole-owners (lower concentration)
- Off-boarding risk: anonymized user #1
New (22)
- Documentation: no build, run or usage example (src/Provider/GeoIPs/README.md)
- Documentation: no build, run or usage example (src/Provider/Mapzen/README.md)
- Edited copies of one member (3 members, 11+ corresponding lines) (src/Provider/GeoPlugin/GeoPlugin.php)
- Edited copies of one member (3 members, 6+ corresponding lines) (src/Provider/Geonames/Geonames.php)
- Edited copies of one member (3 members, 7+ corresponding lines) (src/Provider/BingMaps/BingMaps.php)
- Edited copies of one member (3 members, 8+ corresponding lines) (src/Common/Dumper/Kml.php)
- Edited copies of one member (4 members, 16+ corresponding lines) (src/Provider/GeoIPs/GeoIPs.php)
- Edited copy of a member (10 corresponding lines) (src/Provider/MapTiler/MapTiler.php)
- Edited copy of a member (11 corresponding lines) (src/Common/StatefulGeocoder.php)
- Edited copy of a member (11 corresponding lines) (src/Provider/MapQuest/MapQuest.php)
- Edited copy of a member (15 corresponding lines) (src/Http/Provider/AbstractHttpProvider.php)
- Edited copy of a member (24 corresponding lines) (src/Provider/GoogleMaps/GoogleMaps.php)
- Edited copy of a member (30 corresponding lines) (src/Provider/IP2LocationBinary/IP2LocationBinary.php)
- Edited copy of a member (30 corresponding lines) (src/Provider/LocationIQ/LocationIQ.php)
- Edited copy of a member (7 corresponding lines) (src/Common/Model/AddressBuilder.php)
- Edited copy of a member (7 corresponding lines) (src/Provider/MapQuest/MapQuest.php)
- Edited copy of a member (9 corresponding lines) (src/Plugin/Plugin/CachePlugin.php)
- Edited copy of a member (9 corresponding lines) (src/Plugin/PluginProvider.php)
- Orphaned file (src/Provider/IP2Location/IP2Location.php)
- Orphaned file (src/Provider/LocationIQ/LocationIQ.php)
- …and 2 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
geocoder-php/Geocoder was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 00f87e73afd612f37a01c112e51ff53e17d062c6 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.