Унифицированный поиск местоположения

Поиск местоположения — унифицированный.

Подходит для:

Поиск всех пунктов приема и сдачи DHL для отправки и получения посылок Интеграция нескольких типов отделений Deutsche Post DHL Места в Германии и многих странах Европы.

API поиска местоположения DHL предоставляет данные о точках обслуживания DHL, которые необходимы пользователю для отправки и получения посылок..

Пользователи этого API могут:

Получение пунктов обслуживания DHL рядом с определенным местоположением на основе адресной информации или географических координат. Определение услуг, предлагаемых в пункте обслуживания DHL. Получение информации о часах работы и времени закрытия каждого пункта обслуживания DHL в праздничные дни..

Объем.

API охватывает местоположения следующих подразделений DHL:

Почта & Посылка Германия (P&P) и страны с решениями для электронной коммерции, доступными через этот API:

Австрия (AT), Бельгия (BE), Болгария (BG), Чехия (CZ), Германия (DE), Дания (DK), Эстония (EE), Испания (ES), Финляндия (FI), Франция (FR), Соединенное Королевство Великобритании и Северной Ирландии (GB), Греция (GR), Хорватия (HR), Венгрия (HU), Ирландия (IE), Литва (LT), Люксембург (LU), Латвия (LV), Нидерланды (NL) ), Норвегия (NO), Польша (PL), Португалия (PT), Румыния (RO), Швеция (SE), Словения (SI), Словакия (SK) и Украина (UA)

Страны DHL Express, доступные через этот API:

Объединенные Арабские Эмираты (AE), Афганистан (AF), Албания (AL), Армения (AM), Ангола (AO), Аргентина (AR), Австрия (AT), Австралия (AU), Босния и Герцеговина (BA), Барбадос (BB), Бангладеш (BD), Бельгия (BE), Буркина-Фасо (BF), Болгария (BG), Бахрейн (BH), Бенин (BJ), Бермудские острова (BM), Бруней-Даруссалам (BN), Боливия (BO) , Бразилия (BR), Багамы (BS), Бутан (BT), Ботсвана (BW), Беларусь (BY), Канада (CA), Конго (CG), Швейцария (CH), Кот-д’Ивуар (CI), Cook Острова (CK), Чили (CL), Китай (CN), Колумбия (CO), Коста-Рика (CR), Кабо-Верде (CV), Кипр (CY), Чехия (CZ), Германия (DE), Дания (DK) ), Доминиканская Республика (DO), Алжир (DZ), Эквадор (EC), Эстония (EE), Египет (EG), Испания (ES), Эфиопия (ET), Финляндия (FI), Фиджи (FJ), Франция ( FR), Соединенное Королевство Великобритании и Северной Ирландии (GB), Грузия (GE), Французская Гвиана (GF), Гернси (GG), Гана (GH), Гамбия (GM), Гваделупа (GP) , Греция (GR), Гватемала (GT), Гвинея-Бисау (GW), Гонконг (HK), Гондурас (HN), Хорватия (HR), Гаити (HT), Венгрия (HU), Индонезия (ID), Ирландия (IE), Израиль (IL), Индия (IN), Ирак (IQ), Иран (IR), Исландия (IS), Италия (IT), Джерси (JE), Ямайка (JM), Иордания (JO), Япония (JP), Кения (KE), Кыргызстан (KG), Камбоджа (KH), Кирибати (KI), Коморские острова (KM), Северная Корея (KP), Южная Корея (KR), Косово (KV), Кувейт (KW) , Каймановы острова (KY), Казахстан (KZ), Ливан (LB), Шри-Ланка (LK), Либерия (LR), Лесото (LS), Литва (LT), Люксембург (LU), Латвия (LV), Марокко ( Массачусетс), Молдова (MD), Мадагаскар (MG), Северная Македония (MK), Мали (ML), Мьянма (MM), Монголия (MN), Макао (MO), Северные Марианские острова (MP), Мартиника (MQ) , Мавритания (MR), Мальта (MT), Маврикий (MU), Мальдивы (MV), Малави (MW), Мексика (MX), Малайзия (MY), Мозамбик (MZ), Намибия (NA), Новая Каледония (NC) ), Нигерия (N G), Никарагуа (NI), Нидерланды (NL), Норвегия (NO), Непал (NP), Науру (NR), Ниуэ (NU), Новая Зеландия (NZ), Оман (OM), Панама (PA), Перу (PE), Французская Полинезия (PF), Папуа-Новая Гвинея (PG), Филиппины (PH), Пакистан (PK), Польша (PL), Пуэрто-Рико (PR), Португалия (PT), Парагвай (PY), Катар ( QA), Реюньон (RE), Румыния (RO), Сербия (RS), Россия (RU), Руанда (RW), Саудовская Аравия (SA), Соломоновы Острова (SB), Сейшельские Острова (SC), Судан (SD), Швеция (SE), Сингапур (SG), Словения (SI), Словакия (SK), Сьерра-Леоне (SL), Сенегал (SN), Южный Судан (SS), Сальвадор (SV), Сирийская Арабская Республика (SY), Эсватини (SZ), Того (TG), Таиланд (TH), Тимор-Лешти (TL), Тунис (TN), Тонга (TO), Турция (TR), Тринидад и Тобаго (TT), Тувалу (TV), Тайвань (TW), Танзания (TZ), Украина (UA), Уганда (UG), Соединенные Штаты Америки (US), Уругвай (UY), Узбекистан (UZ), Венесуэла (VE), Виргинские острова (VG), Виргинские острова (VI), Вьетнам (VN), Вануату (VU), Самоа (WS), Сеута (XC), Черногория (XM), Майотта (YT), Южная Африка (ZA), Замбия (ZM), Зимбабве (ZW)

API предоставляет следующую информацию из пункта обслуживания DHL:

Имя Адрес Предлагаемые услуги геолокации (см. Ниже) Часы работы Периоды закрытия.

Предлагаются следующие услуги:

Тип услуги Описание услуги посылка: самовывоз Потребители могут забрать посылки DHL Parcel. Это касается последней мили. посылка: доставка посылки Потребители могут отправлять посылки DHL Parcel. Это касается первой мили. экспресс: самовывоз Потребители могут забрать посылки DHL Express. Это касается последней мили. Экспресс: доставка. Потребители могут отправлять посылки DHL Express. Это касается первой мили. посылка: зарегистрированный пункт выдачи Автоматическая камера хранения для получения посылок для предварительно зарегистрированных потребителей (например, Parcel Locker, Packstation, SwipBox, Lean Parcel Locker). посылка: получение-незарегистрированная Автоматизированная камера хранения для получения посылок для незарегистрированных потребителей (например, Parcel Locker, Packstation, SwipBox, Lean Parcel Locker). посылка: выдача — незарегистрированная Автоматизированная камера хранения для сдачи посылок незарегистрированным потребителям (например, Parcel Locker, Packstation, SwipBox, Lean Parcel Locker). Письменная почта Предлагаются услуги письменной корреспонденции (например, почтовое отделение). postbank Предложение услуг от немецкого финансового учреждения Deutsche Postbank AG, дочернего предприятия Deutsche Bank AG. В дополнение к основной деятельности, связанной с банковскими услугами, также предлагаются почтовые услуги (например, прием писем и посылок, а также продажа писем и почтовых марок). С индивидуальным предложением можно ознакомиться в Deutsche Postbank AG. наложенный платеж Предложение "оплата при доставке". Посылка передается получателю только против оплаты. франкирование Предложение этикеток для франкирования. Это не включает продукт "Мобильный Пакетмарке". Кассовое обслуживание Кассовое обслуживание осуществляется наличными или карточными платежами. В Германии поддерживаются Giro, Maestro, Postcard и наличный расчет. упаковочный материал Предложение для упаковочного материала, такого как пакеты для посылок, конверты для писем, бумага, карандаши и ручки. postident Postident — это сервис для надежной проверки личности потребителя. Эта услуга обычно используется для проверки личности банковского счета в Интернете. проверка возраста Надежная проверка возраста клиента. Эта услуга обычно используется для проверки того, что потребитель достиг определенного возраста для онлайн-предложения (например, 14 или 18 лет). доступ для инвалидов Справедливый доступ для инвалидов. парковка Парковка рядом.

Использование API.

Вам необходимо предоставить адресную информацию и ключ подписки API (этот ключ необходимо указать в заголовке запроса).

Примеры использования.

Поиск пунктов обслуживания DHL на основе адресной информации.

API позволяет пользователю искать точки обслуживания DHL в зависимости от местоположения — от области или города до полного адреса. Возвращаемые пункты обслуживания DHL будут упорядочены по расстоянию от места нахождения клиента..

Поиск пунктов обслуживания DHL по точному месту.

Когда известно точное местонахождение покупателя, можно выполнить поиск по этой широте и долготе. В ходе этого поиска будут найдены ближайшие к пользователю пункты обслуживания DHL, отсортированные по расстоянию..

Узнавайте, когда открывается пункт обслуживания DHL.

Не все пункты обслуживания DHL имеют одинаковое время работы, а некоторые могут быть открыты не все дни недели. С помощью API клиенту показывают точные часы работы пункта обслуживания DHL, чтобы можно было принять обоснованное решение..

Какие услуги предлагаются в пунктах обслуживания DHL.

Все услуги, предлагаемые Пунктом обслуживания DHL, перечислены в API; пользователь может фильтровать на основе требуемых услуг.

Получить доступ.

Вы должны запрашивать учетные данные для любых разрабатываемых вами приложений..

Чтобы зарегистрировать приложение и получить ключи подписки API:

Щелкните Мои приложения на веб-сайте портала. Щелкните Добавить приложение разработчика. Появится форма «Добавить приложение». Заполните форму добавления приложения. Вы можете выбрать API, к которым хотите получить доступ. Заполнив форму, нажмите кнопку «Добавить приложение». Метка «Одобрено» появится рядом с названием приложения, когда оно будет одобрено. Примечание. Для некоторых приложений могут потребоваться дополнительные шаги проверки..

Аутентификация.

Для каждого вызова API требуется ключ подписки. Этот ключ необходимо указать в заголовке запроса (DHL-API-Key)..

Чтобы просмотреть ключи подписки на API:

На экране «Мои приложения» щелкните имя своего приложения. Появится экран подробностей. Если у вас есть доступ к нескольким API, щелкните имя соответствующего API. Примечание. API перечислены в разделе «Учетные данные». Щелкните ссылку «Показать» под звездочками, скрывающую ключ клиента. Появится потребительский ключ..

Среды.

Адресуемая среда базового URL / URI API:

Описание среды https://api.dhl.com/location-finder/v1 Производственная среда.

Пределы скорости.

Ограничения скорости защищают инфраструктуру DHL от подозрительных запросов, превышающих установленные пороговые значения..

Когда вы впервые запрашиваете доступ к Location Finder — Unified API, вы получаете начальный уровень обслуживания, который позволяет звонить 500 в день. .

Доступны дополнительные ограничения скорости, и они предоставляются в соответствии с вашим конкретным вариантом использования. Если вы хотите запросить дополнительные ограничения, выполните следующие действия:

Создайте приложение, как описано в разделе «Получить доступ». Щелкните Мои приложения на веб-сайте портала. Щелкните созданное приложение. Прокрутите вниз до списка API и щелкните значок "Запросить обновление" кнопка. См. Пример ниже:

Когда лимит будет достигнут, вы получите код состояния HTTP:

Как обращаться с отправлениями.

Возможна отправка посылок напрямую в пункты обслуживания DHL. Для этого следует применять схемы адресации, описанные ниже..

Обращение к шкафчику в Германии.

Если вы хотите отправить свой груз в камеру хранения («DHL Packstation») в Германии, выполните следующие действия:

Укажите свое имя. Используйте «DHL Packstation» в качестве названия улицы. Используйте номер DHL Packstation (здесь «145») в качестве номера дома. Укажите свой почтовый номер (здесь «987654321») во втором поле имени или дополнительном поле адреса. Если у вас еще нет почтового номера, зарегистрируйтесь здесь. Введите страну (здесь «DE»), почтовый индекс (здесь «53113») и город (здесь «Бонн») Имя Макс. Фамилия Образец Дополнительная информация об адресе 987654321 Улица DHL Packstation Номер дома 145 Страна DE Почтовый индекс 53113 Город Бонн.

В приведенном ниже примере ответа API представлены все необходимые данные о местоположении:

"url": "/ location / 8007-453113145", "расположение": "идентификаторы": [ "locationId": "8003-453113145", "провайдер": "посылка" > ], "ключевое слово": " DHL Packstation ", "keywordId": " 145 ", "тип": "шкафчик" >, "имя": "DHL Packstation 145", "расстояние": 52, "место": "адрес": "код страны": " DE ", "Почтовый Код": " 53113 ", "адрес": " Бонн ", "адрес улицы": "Charles-de-Gaulle-Str. 20" >, > …

Обращение в пункт обслуживания DHL в Германии.

Если вы хотите отправить посылку в пункт обслуживания DHL («Почтовое отделение» или «Посылочный магазин») в Германии, выполните следующие действия:

Укажите свое имя. Используйте «Postfiliale» в качестве названия улицы. Используйте номер Postfiliale (здесь «502») в качестве номера дома. Необязательно: укажите свой PostNumber (здесь «987654321») во втором поле имени или дополнительном адресе. Если у вас еще нет почтового номера, зарегистрируйтесь здесь. Введите страну (здесь «DE»), почтовый индекс (здесь «53113») и город (здесь «Бонн»).

Важные примечания: — Отправления могут быть отправлены напрямую только в тот пункт обслуживания DHL, у которого есть назначенный номер Postfiliale (указывается как keywordID в ответе API) — Пожалуйста, укажите адрес электронной почты получателя. Это необходимо для того, чтобы проинформировать вас по электронной почте, как только получатель сможет забрать посылку..

Имя Макс Фамилия Образец Дополнительная информация об адресе (необязательно) 987654321 Street Postfiliale Номер дома 502 Страна DE Почтовый индекс 53113 Город Bonn.

В приведенном ниже примере ответа API представлены все необходимые данные о местоположении:

"url": "/ location / 8003-4008202", "расположение": "идентификаторы": [ "locationId": "8003-4008202", "провайдер": "посылка" > ], "ключевое слово": " Postfiliale ", "keywordId": " 502 ", "тип": "почта России" >, "имя": "Postfiliale 502", "расстояние": 26, "место": "адрес": "код страны": " DE ", "Почтовый Код": " 53113 ", "адрес": " Бонн ", "адрес улицы": "Charles-de-Gaulle-Str. 20" >, > …

Обращение к шкафчику в Европе.

Если вы хотите отправить свой груз в камеру хранения в Европе, выполните следующие действия:

Укажите свое имя. Используйте ключевое слово страны (здесь «DHL Packstation») в качестве названия улицы. Используйте ключевое слово ID (здесь «NL-110151») в качестве номера дома. Введите страну (здесь «NL»), почтовый индекс (здесь «1101DZ») и город (здесь «Амстердам»)

Важное примечание: укажите адрес электронной почты получателя. Это необходимо для того, чтобы проинформировать вас по электронной почте, как только получатель сможет забрать посылку..

Имя Макс Фамилия Образец Улица DHL Packstation Номер дома NL-110151 Страна NL Почтовый индекс 1101DZ Город Амстердам.

В приведенном ниже примере ответа API представлены все необходимые данные о местоположении:

"url": "/ location / 8004-NL-110151", "расположение": "идентификаторы": [ "locationId": "8004-NL-110151", "провайдер": "посылка" > ], "ключевое слово": " DHL Packstation ", "keywordId": " NL-110151 ", "тип": "шкафчик" >, "имя": "DHL Pakketautomaat Shell Lhweg", "расстояние": 472, "место": "адрес": "код страны": " NL ", "Почтовый Код": " 1101DZ ", "адрес": " Амстердам ", "адрес улицы": "Laarderhoogtweg 5-PS" >, > …

Обращение в пункт обслуживания DHL в Европе.

Если вы хотите отправить груз в пункт обслуживания DHL в Европе, выполните следующие действия:

Укажите свое имя. Используйте ключевое слово страны (здесь «DHL Parcelshop») и ключевое слово (здесь «NL-110603») в качестве дополнительной адресной информации. Введите страну (здесь «NL»), почтовый индекс (здесь «1106LN»), город ( здесь «Амстердам»), улица (здесь «Holendrechtplein») и номер дома (здесь «14»).

Важное примечание: укажите адрес электронной почты получателя. Это необходимо для того, чтобы сообщить вам по электронной почте, как только получатель сможет забрать посылку..

Имя Макс Фамилия Образец Дополнительная информация об адресе DHL Parcelshop NL-110603 Street Holendrechtplein Номер дома 14 Страна NL Почтовый индекс 1106LN Город Амстердам.

В приведенном ниже примере ответа API представлены все необходимые данные о местоположении:

"url": "/ location / 8004-NL-110603", "расположение": "идентификаторы": [ "locationId": "8004-NL-110603", "провайдер": "посылка" > ], "ключевое слово": " DHL Parcelshop ", "keywordId": " NL-110603 ", "тип": "точка обслуживания" >, "имя": "Акаш Мульти Плаза 14Б", "расстояние": 984, "место": "адрес": "код страны": " NL ", "Почтовый Код": " 1106LN ", "адрес": " Амстердам ", "адрес улицы": "Holendrechtplein 14" >, > …

Дополнительная информация.

Разрешенные методы HTTP.

GET для получения данных.

Примеры запросов к API.

Пример простого HTTP-запроса:

Найдите пункты доставки DHL в Германии?

Я розничный торговец из Германии. Мои клиенты могут заказывать мои товары через мой интернет-магазин. Я хочу использовать Location Finder — Unified API для отображения местоположений DPDHL при оформлении заказа в моем интернет-магазине в качестве варианта доставки. API должен возвращать только те местоположения, которые можно использовать для прямой адресации. Я предлагаю стандартную доставку (без экспресс-доставки), и мне интересны как магазины DPDHL (пункты обслуживания, почтовые отделения и Postbank), так и камеры хранения (в Германии они называются DHL Packstation)..

Решение.

В Германии бизнес-единицей DPDHL, занимающейся этим вариантом использования, является P&P (Сообщение & Parcel), доступный с помощью этого API через параметр providerType как parcel. Услуги, которые предлагают прямую адресацию, включают посылку: получение (предлагается в пунктах обслуживания, почтовых отделениях и почтовом банке) и посылка: получение с регистрацией (предлагается только в камерах хранения). Для получения дополнительной информации об этом бизнес-подразделении и этих услугах посетите нашу страницу обзора.

Параметр serviceType позволяет фильтровать местоположения по таким службам, как parcel: pick-up и parcel: pick-up-зарегистрированная. Учитывая, что этот параметр приведет к тому, что результат будет включать только местоположения, по крайней мере, со всеми запрошенными serviceTypes, а в Германии местоположения, которые предлагают parcel: pick-up, не предлагают parcel: pick-up-зарегистрированный, мне нужно сделать два звонка в Поиск местоположения — Единый API.

1. Получение мест, предлагающих сервисную посылку: получение.

широта и долгота: это ориентир, используемый для поиска местоположений вокруг него. В этом случае также можно было использовать / find-by-address, хотя / find-by-geo более прямолинейный, поскольку / find-by-address просто преобразует адрес в географическую точку в качестве первого шага. providerType: этот параметр со значением ‘parcel’ гарантирует, что результаты будут только из P&P (Сообщение & Parcel) будет возвращен, за исключением мест, не относящихся к данному случаю (например, DHL Express). serviceType: этот параметр со значением ‘parcel: pick-up’ гарантирует, что любое местоположение, которое не предлагает эту услугу, будет исключено. радиус: 2500 метров вокруг контрольной точки (широта, долгота) будет учитываться при поиске. limit: если доступно, в ответе будет возвращено до 20 местоположений.

2. Получение мест, которые предлагают сервисную посылку: регистрация получения.

serviceType: этот параметр со значением ‘parcel: pick-up-registration’ гарантирует, что любое место, которое не предлагает эту услугу, будет исключено. В этом случае все остальные параметры такие же..

Соображения.

Если бы я сделал только один вызов API, включая параметр serviceType дважды (по одному для каждого типа службы), у меня не было бы результатов, поскольку API искал бы местоположения, которые предлагают parcel: pick-up и parcel: pick-up-registration. В Германии нет локаций с такой характеристикой. Мне придется объединить результаты обоих вызовов, чтобы отобразить полный список мест для доставки моему клиенту..

Похожие статьи