Настройка модуля DaData

DaData является отличным дополнением к модулю Яндекс Карт и может использоваться как основной сервис геокодирования на сайте.

Что дает модуль DaData

После подключения модуля на сайте становятся доступны:

• автоматические подсказки адресов при вводе;
• поиск адресов по части строки;
• исправление опечаток в адресах;
• автоматическое заполнение региона, города, улицы, дома и квартиры;
• получение координат объекта;
• стандартизация адресов;
• проверка корректности введенных данных;
• работа с адресами по России и другим странам.

Установка модуля

Установить модуль можно двумя способами.

Способ 1. Через встроенный Маркетплейс

1. Перейдите в раздел Каталог → Маркетплейс.
2. В поиске введите DaData.
3. Найдите модуль DaData.
4. Нажмите кнопку Установить.

Способ 2. Через сайт Маркетплейса

1. Перейдите на страницу:
2. Найдите модуль DaData.
3. Откройте страницу модуля.
4. Нажмите кнопку Установить.
5. После установки модуль автоматически появится в панели управления сайта.

Получение API-ключей DaData

Для работы модуля необходимо получить API-ключи в личном кабинете DaData.

Регистрация в DaData

1. Перейдите на сайт:
2. Нажмите Регистрация.
3. Создайте учетную запись.
4. Подтвердите адрес электронной почты.

После подтверждения аккаунта откроется доступ к API DaData.

Получение ключей доступа

После авторизации:

1. Откройте личный кабинет.
2. Перейдите в раздел API-ключи.
3. Скопируйте следующие данные:

API Key (Токен)

Используется для выполнения запросов к сервису подсказок.

Пример:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Secret Key

Используется для защищенных методов API и получения статистики использования.

Пример:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Для работы модуля обычно требуется указать оба ключа.

Скриншот 4. API Key и Secret Key

Бесплатный тариф DaData

После регистрации предоставляется бесплатный лимит запросов.

Бесплатный тариф позволяет использовать до 10 000 запросов в сутки для сервисов подсказок адресов, организаций, ФИО и других сущностей. После исчерпания лимита подсказки временно перестанут работать до начала следующих суток.

Для большинства сайтов данного лимита более чем достаточно.

Настройка модуля

После получения ключей:

1. Перейдите в раздел Управлять → Настройки у модуля DaData.
2. В поле API Key вставьте полученный токен.
3. В поле Secret Key вставьте секретный ключ.
4. Сохраните настройки.

Скриншот 5. Настройки модуля DaData

Включение DaData в настройках системы

После настройки модуля необходимо выбрать его в качестве сервиса геокодирования.

1. Перейдите в раздел настроек интеграций:
2. Пролистайте страницу до блока Геокодирование.
3. Выберите значение DaData.
4. Сохраните изменения.

Скриншот 6. Выбор DaData в настройках системы

Как работает DaData на сайте

После активации модуля пользователю достаточно начать вводить адрес.

Например:

Москва Тверская 7

Система автоматически предложит варианты адресов.

После выбора адреса могут автоматически заполняться:

• индекс;
• регион;
• город;
• улица;
• дом;
• квартира;
• координаты объекта;
• дополнительные адресные данные.

Скриншот 7. Пример подсказок адресов

Проверка работы

После завершения настройки:

1. Откройте любую форму с полем адреса.
2. Начните вводить адрес.
3. Убедитесь, что появляется список подсказок.
4. Выберите один из предложенных вариантов.
5. Проверьте корректность заполнения данных.

Возможные проблемы

Подсказки не появляются

Проверьте:

• правильность API Key;
• правильность Secret Key;
• подтверждение электронной почты в DaData;
• сохранение настроек модуля;
• наличие свободного лимита запросов.

Ошибка доступа (403 Forbidden)

Наиболее частые причины:

• указан неверный API-ключ;
• электронная почта не подтверждена;
• исчерпан дневной лимит запросов.

Рекомендации

Для максимального удобства пользователей рекомендуется использовать следующую связку:

• Яндекс Карты — для отображения карт и объектов на карте;
• DaData — для подсказок адресов и геокодирования.

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