PHPackages                             dhl/sdk-api-unified-location-finder - 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. [API Development](/categories/api)
4. /
5. dhl/sdk-api-unified-location-finder

ActiveLibrary[API Development](/categories/api)

dhl/sdk-api-unified-location-finder
===================================

DPDHL Group Unified Location Finder API SDK

3.3.0(1y ago)1315.8k↓42.4%1[5 PRs](https://github.com/netresearch/dhl-sdk-api-unified-location-finder/pulls)1MITPHPPHP ^8.1.0CI passing

Since Jun 26Pushed 4d ago7 watchersCompare

[ Source](https://github.com/netresearch/dhl-sdk-api-unified-location-finder)[ Packagist](https://packagist.org/packages/dhl/sdk-api-unified-location-finder)[ Docs](https://developer.dhl.com/api-reference/location-finder)[ RSS](/packages/dhl-sdk-api-unified-location-finder/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (5)Dependencies (18)Versions (14)Used By (1)

DPDHL Unified Location Finder API SDK
=====================================

[](#dpdhl-unified-location-finder-api-sdk)

The DPDHL Unified Location Finder API SDK package offers an interface to the following web services:

- Location Finder - Unified

Requirements
------------

[](#requirements)

### System Requirements

[](#system-requirements)

- PHP 8.1+ with JSON extension

### Package Requirements

[](#package-requirements)

- `netresearch/jsonmapper`: Mapper for deserialization of JSON response messages into PHP objects
- `php-http/discovery`: Discovery service for HTTP client and message factory implementations
- `php-http/httplug`: Pluggable HTTP client abstraction
- `php-http/logger-plugin`: HTTP client logger plugin for HTTPlug
- `psr/http-client`: PSR-18 HTTP client interfaces
- `psr/http-factory`: PSR-7 HTTP message factory interfaces
- `psr/http-message`: PSR-7 HTTP message interfaces
- `psr/log`: PSR-3 logger interfaces

### Virtual Package Requirements

[](#virtual-package-requirements)

- `psr/http-client-implementation`: Any package that provides a PSR-18 compatible HTTP client
- `psr/http-factory-implementation`: Any package that provides PSR-7 compatible HTTP message factories
- `psr/http-message-implementation`: Any package that provides PSR-7 HTTP messages

### Development Package Requirements

[](#development-package-requirements)

- `nyholm/psr7`: PSR-7 HTTP message factory & message implementation
- `phpunit/phpunit`: Testing framework
- `php-http/mock-client`: HTTPlug mock client implementation
- `phpstan/phpstan`: Static analysis tool
- `squizlabs/php_codesniffer`: Static analysis tool
- `rector/rector`: Automatic refactoring tool to help with PHP upgrades
- `fig/log-test`: Test utilities for `psr/log`

Installation
------------

[](#installation)

```
$ composer require dhl/sdk-api-unified-location-finder
```

Uninstallation
--------------

[](#uninstallation)

```
$ composer remove dhl/sdk-api-unified-location-finder
```

Testing
-------

[](#testing)

```
$ ./vendor/bin/phpunit -c test/phpunit.xml
```

Features
--------

[](#features)

The DPDHL Unified Location Finder API SDK supports the following features:

- Find DHL Service Points for sending and receiving packages.

Public API
----------

[](#public-api)

The library's components suitable for consumption comprise

- service:
    - service factory
    - location finder service
- data transfer objects:
    - service point location with address, geo coordinates, opening hours specifications

Usage
-----

[](#usage)

```
$consumerKey = 'Your application consumer key';
$logger = new \Psr\Log\NullLogger();

$serviceFactory = new \Dhl\Sdk\UnifiedLocationFinder\Service\ServiceFactory();
$service = $serviceFactory->createLocationFinderService($consumerKey, $logger);

try {
    /** @var \Dhl\Sdk\UnifiedLocationFinder\Api\Data\LocationInterface $locations  */
    $locations = $service->getPickUpLocations(
        $countryCode = 'DE',
        $postalCode = '04129',
        $city = 'Leipzig',
        $street = 'Nonnenstraße 11d',
        $service = 'parcel-eu',
        $radius = 2000,
        $limit = 25
    );
} catch (\Dhl\Sdk\UnifiedLocationFinder\Exception\ServiceException $e) {
    // handle errors
}
```

Error handling
--------------

[](#error-handling)

The SDK will only ever throw exceptions of type `\Dhl\Sdk\UnifiedLocationFinder\Exception\ServiceException`. Subclasses of `ServiceException` may be used to describe the kind of error that occurred.

A `\Dhl\Sdk\UnifiedLocationFinder\Exception\DetailedServiceException` indicates that the exception holds a human-readable error message suitable for display to the end-user.

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance76

Regular maintenance activity

Popularity37

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 56.5% 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 ~301 days

Recently: every ~283 days

Total

7

Last Release

394d ago

Major Versions

1.0.0 → 2.0.02020-06-26

2.1.0 → 3.0.02023-03-27

PHP version history (4 changes)1.0.0PHP ^7.0.0

2.0.0PHP ^7.1.0

2.1.0PHP ^7.2.0 || ^8.0.0

3.1.0PHP ^8.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/efd68399f95aa07110668d9af1a47a8030d8df5ec5af4b28e821d442d787583a?d=identicon)[team-mage](/maintainers/team-mage)

---

Top Contributors

[![Sebastian80](https://avatars.githubusercontent.com/u/6400300?v=4)](https://github.com/Sebastian80 "Sebastian80 (13 commits)")[![mam08ixo](https://avatars.githubusercontent.com/u/1771622?v=4)](https://github.com/mam08ixo "mam08ixo (8 commits)")[![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (1 commits)")[![powli](https://avatars.githubusercontent.com/u/4511053?v=4)](https://github.com/powli "powli (1 commits)")

---

Tags

dhl-apidhl-parceldhl-phpdhl-php-sdkdhl-sdkgitlab-mirrorlocation-finderphp-librarysdksdk-phpphpsdkdhl

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/dhl-sdk-api-unified-location-finder/health.svg)

```
[![Health](https://phpackages.com/badges/dhl-sdk-api-unified-location-finder/health.svg)](https://phpackages.com/packages/dhl-sdk-api-unified-location-finder)
```

###  Alternatives

[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35789.4k2](/packages/telnyx-telnyx-php)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28150.5k](/packages/phpro-http-tools)[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k28.0M318](/packages/openai-php-client)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

1003.9M50](/packages/getbrevo-brevo-php)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)

PHPackages © 2026

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