PHPackages                             dhl/sdk-api-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-location-finder

ActiveLibrary[API Development](/categories/api)

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

DHL Pick Up/Drop Off Location Search

1.0.0(6y ago)22.6k[1 issues](https://github.com/netresearch/dhl-sdk-api-location-finder/issues)[4 PRs](https://github.com/netresearch/dhl-sdk-api-location-finder/pulls)MITPHPPHP ^7.0.0CI failing

Since Jan 27Pushed 1mo ago7 watchersCompare

[ Source](https://github.com/netresearch/dhl-sdk-api-location-finder)[ Packagist](https://packagist.org/packages/dhl/sdk-api-location-finder)[ RSS](/packages/dhl-sdk-api-location-finder/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)Dependencies (4)Versions (7)Used By (0)

DHL Location Finder API SDK
===========================

[](#dhl-location-finder-api-sdk)

The DHL Location Finder API SDK package offers an interface to the *DHL Standortsuche*. Use this SDK to get a list of DHL Paketboxes, parcel stations, and postal offices around a given address or a set of coordinates.

The SDK currently uses the *DHL Standortsuche Deutschland API* to retrieve locations, although this may change in a future version. You can find developer documentation for the *DHL Standortsuche Deutschland API* at

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

[](#requirements)

### System Requirements

[](#system-requirements)

- PHP 7.0+ with SOAP extension

### Package Requirements

[](#package-requirements)

- `psr/log`: PSR-3 logger interfaces

### Development Package Requirements

[](#development-package-requirements)

- `phpunit/phpunit`: Testing framework

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

[](#installation)

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

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

[](#uninstallation)

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

Testing
-------

[](#testing)

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

Features
--------

[](#features)

The SDK offers the following service methods:

- **getPickUpLocations**
    - find pickup locations in a 15 km radius from a given address.
- **getPickUpLocationsByCoordinate**
    - find pickup locations in a 15 km radius from a given set of coordinates.
- **getDropOffLocations**
    - find drop-off locations in a 15 km radius from a given address.
- **getDropOffLocationsByCoordinate**
    - find drop-off locations in a 15 km radius from a given set of coordinates.

Usage Example
-------------

[](#usage-example)

```
$sandboxMode = false;
$serviceFactory = new \Dhl\Sdk\LocationFinder\Service\ServiceFactory();
$service = $serviceFactory->createLocationFinderService(
    'appId',
    'appToken',
    new \Psr\Log\NullLogger(),
    $sandboxMode
);

try {
    /** @var \Dhl\Sdk\LocationFinder\Api\Data\LocationInterface $locations  */
    $locations = $service->getPickUpLocations(
        'DE',
        '04129',
        'Leipzig',
        'Nonnenstraße',
        '11d'
    );
} catch (\Dhl\Sdk\LocationFinder\Exception\ServiceException $e) {
    // handle errors
}

foreach ($locations as $location) {
    echo $location->getName();
    echo $location->getType();
    echo $location->getLatitude();
    echo $location->getLongitude();
    // ...
}
```

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

[](#error-handling)

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

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

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance50

Moderate activity, may be stable

Popularity19

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

2298d ago

### Community

Maintainers

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

---

Top Contributors

[![AndreasMueller75](https://avatars.githubusercontent.com/u/32193606?v=4)](https://github.com/AndreasMueller75 "AndreasMueller75 (9 commits)")[![mam08ixo](https://avatars.githubusercontent.com/u/1771622?v=4)](https://github.com/mam08ixo "mam08ixo (4 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (3 commits)")[![CybotTM](https://avatars.githubusercontent.com/u/326348?v=4)](https://github.com/CybotTM "CybotTM (2 commits)")[![magicsunday](https://avatars.githubusercontent.com/u/564393?v=4)](https://github.com/magicsunday "magicsunday (2 commits)")[![Sebastian80](https://avatars.githubusercontent.com/u/6400300?v=4)](https://github.com/Sebastian80 "Sebastian80 (1 commits)")

---

Tags

dhldhl-apidhl-phpdhl-php-sdkdhl-sdkphp-librarysdksdk-phpphpsdk

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[alexacrm/php-crm-toolkit

PHP Toolkit for Microsoft Dynamics CRM

109293.3k1](/packages/alexacrm-php-crm-toolkit)[paddlehq/paddle-php-sdk

Paddle's PHP SDK for Paddle Billing.

53301.7k](/packages/paddlehq-paddle-php-sdk)

PHPackages © 2026

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