{"id":25839686,"url":"https://github.com/netresearch/dhl-sdk-api-location-finder","last_synced_at":"2026-02-09T21:15:34.007Z","repository":{"id":56967618,"uuid":"228391951","full_name":"netresearch/dhl-sdk-api-location-finder","owner":"netresearch","description":"Library package for calling the DHL Standortsuche web service","archived":false,"fork":false,"pushed_at":"2025-02-19T13:08:04.000Z","size":97,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-02-19T13:41:47.511Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-12-16T13:20:16.000Z","updated_at":"2025-02-19T12:57:07.000Z","dependencies_parsed_at":"2022-08-21T09:50:42.259Z","dependency_job_id":null,"html_url":"https://github.com/netresearch/dhl-sdk-api-location-finder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fdhl-sdk-api-location-finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fdhl-sdk-api-location-finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fdhl-sdk-api-location-finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fdhl-sdk-api-location-finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/dhl-sdk-api-location-finder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241317607,"owners_count":19943199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-01T04:34:04.156Z","updated_at":"2026-02-09T21:15:33.945Z","avatar_url":"https://github.com/netresearch.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DHL Location Finder API SDK \n\nThe DHL Location Finder API SDK package offers an interface to the *DHL Standortsuche*.\nUse this SDK to get a list of DHL Paketboxes, parcel stations, and postal offices around a given address or a set of coordinates.\n\nThe SDK currently uses the *DHL Standortsuche Deutschland API* to retrieve locations,\nalthough this may change in a future version.\nYou can find developer documentation for the *DHL Standortsuche Deutschland API* at \u003chttps://entwickler.dhl.de/group/ep/wsapis/standortsuche\u003e\n\n## Requirements\n\n### System Requirements\n\n- PHP 7.0+ with SOAP extension\n\n### Package Requirements\n\n- `psr/log`: PSR-3 logger interfaces\n\n### Development Package Requirements\n\n- `phpunit/phpunit`: Testing framework\n\n## Installation\n\n```bash\n$ composer require dhl/sdk-api-location-finder\n```\n\n## Uninstallation\n\n```bash\n$ composer remove dhl/sdk-api-location-finder\n```\n\n## Testing\n\n```bash\n$ composer update\n$ ./vendor/bin/phpunit -c test/phpunit.xml\n```\n\n## Features\n\nThe SDK offers the following service methods:\n\n- **getPickUpLocations**\n    - find pickup locations in a 15 km radius from a given address.\n- **getPickUpLocationsByCoordinate**\n    - find pickup locations in a 15 km radius from a given set of coordinates.\n- **getDropOffLocations**\n    - find drop-off locations in a 15 km radius from a given address.\n- **getDropOffLocationsByCoordinate**\n    - find drop-off locations in a 15 km radius from a given set of coordinates.\n\n## Usage Example\n\n```php\n$sandboxMode = false;\n$serviceFactory = new \\Dhl\\Sdk\\LocationFinder\\Service\\ServiceFactory();\n$service = $serviceFactory-\u003ecreateLocationFinderService(\n    'appId',\n    'appToken',\n    new \\Psr\\Log\\NullLogger(),\n    $sandboxMode\n);\n\ntry {\n    /** @var \\Dhl\\Sdk\\LocationFinder\\Api\\Data\\LocationInterface $locations  */\n    $locations = $service-\u003egetPickUpLocations(\n        'DE',\n        '04129',\n        'Leipzig',\n        'Nonnenstraße',\n        '11d'\n    );\n} catch (\\Dhl\\Sdk\\LocationFinder\\Exception\\ServiceException $e) {\n    // handle errors\n}\n\nforeach ($locations as $location) {\n    echo $location-\u003egetName();\n    echo $location-\u003egetType();\n    echo $location-\u003egetLatitude();\n    echo $location-\u003egetLongitude();\n    // ...\n}\n```\n\n## Error handling\n\nThe SDK will only ever throw exceptions of type `\\Dhl\\Sdk\\LocationFinder\\Exception\\ServiceException`.\nSubclasses of `ServiceException` may be used to describe the kind of error that occurred. \n\nA `\\Dhl\\Sdk\\LocationFinder\\Exception\\DetailedServiceException` indicates that the exception holds a\nhuman-readable error message suitable for display to the end-user.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fdhl-sdk-api-location-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fdhl-sdk-api-location-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fdhl-sdk-api-location-finder/lists"}