Подсказки адресов


Методы сохранения и отправки заказа могут требовать передачи адреса доставки (если заказ оформляется на доставку). У аутентифицированных покупателей есть возможность выбрать ранее добавленный адрес либо указать новый адрес (доступно всем покупателям).

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

На текущий момент мы обрабатываем подсказки с помощью сервиса DaData.ru, поэтому поиск ограничен только Российской Федерацией.

Используемые структуры

Настройки подсказок

API подсказок зависит от выбранного города и значений настроек подсказок. Эти настройки позволяют управлять ограничениями поиска адресов на клиенте:

  1. Поиск адреса может выполняться только внутри указанного города;
  2. Поиск адреса может выполняться по всей России;
  3. Поиск адреса может выполняться внутри указанного города в указанном радиусе (не более 100 км.).

Первый пункт нужен тем магазинам, которые выполняют доставку строго внутри рабочего города. Второй пункт будет полезен магазинам, которые могут отправлять товары по всей России почтой или транспортными компаниями. Третий пункт позволяет захватывать рабочий город, а так же близлежащие населённые пункты.

Получив и обработав настройки, вы можете проинформировать покупателя в какой области выполняется поиск, а так же что нужно вводить в строку поиска.

Например, если поиск выполняется внутри города, то покупателю нужно ввести только улицу и номер дома. Поиск по всей России и внутри указанного радиуса требует передачи населённого пункта, улицы и номера дома.

Настройки адресов загружаются с помощью включения городов settings и находятся по адресу settings.addresses.

Адрес DaData

В ответе запроса подсказок каждым элементом поля suggestions будет являться объект со следующей структурой:

Получение подсказок

Для получения подсказок необходимо выполнить POST-запрос на URL https://api.zenky.io/v2/suggestions/address, передав следующие параметры:

В ответе будет объект со следующей структурой: