Форма обратной связи

Мы рекомендуем использовать форму обратной связи при каждом использовании API справочника. Партнёру это поможет избежать получения информации от своих пользователей, если она касается данных 2ГИС. Нам это поможет оперативно обновлять контент, чтобы делать его ещё точнее.

Форма реализована в нейтральном стиле, поэтому её можно использовать практически в любом дизайне. Так она будет выглядеть:
«Нашли неточность в данных? Сообщите нам об этом» или «Не нашли организацию? Сообщите нам об этом»

Подключение формы

В теге head необходимо разместить следующий код:

<script src=“http://feedback.api.2gis.ru/js/dg-api-feedback-loader.js" type=“text/javascript”></script>

Существует два случая, когда рекомендуется показывать ссылку на форму.

1. Неточность в данных

Рекомендуется показывать ссылку на форму в карточке организации.

Отображение происходит через вызов метода DG.feedback.showPopupDataError(FilialID, FilialName, FilialAddress), где
FilialID — string — ID филиала организации, полученное в профиле организации в поле ID,
FilialName — string — наименование филиала организации, полученное в профиле организации в поле name,
FilialAddress — string — адрес филиала организации, полученный в профиле организации в поле address.

2. Не найдены результаты

Рекомендуется показывать ссылку на форму после результатов поиска и особо заметно в случае их отсутствия.

Отображение происходит через вызов метода DG.feedback.showPopupNotFound(what, where), где
what — string — соответствующий параметр поискового запроса,
where — string — параметр where или point поискового запроса. Если поиск велся по точке с заданием радиуса, то необходимо передать эти параметры, объединив в одну строку.

Способ открытия формы

Форму можно открывать на новой странице, а не в виде модального окна. Для этого используются следующие методы:
DG.feedback.showPopupDataError(FilialID, FilialName, FilialAddress)
DG.feedback.showPopupNotFound(what, where)

Параметры соответствуют методам, описанным выше.

Пример

Ниже приведено 4 примера для ссылок на оба типа форм в модальном или новом окне.

<!DOCTYPE html>
<html>
    <head>
        <meta charset=“utf-8” />
        <title>2GIS API Feedback</title>
        <script src=“http://feedback.api.2gis.ru/js/dg-api-feedback-loader.js" type=“text/javascript”></script>
    </head>
    <body>
       <p><a href =“javascript:void(0)” onClick=“DG.feedback.showPopupDataError
    (‘12345678’, ‘Название организации’,‘Адрес организации’)”>Нашли ошибку в данных? Сообщите нам об этом!</a></p>
       <p><a href =“javascript:void(0)” onClick=“DG.feedback.showPopupNotFound
    (‘кафе’,‘Новосибирск, Ленина, 14’)”>Не нашли организацию? Сообщите нам об этом!</a></p>
       <p><a href =“javascript:void(0)” onClick=“DG.feedback.showWindowDataError
    (‘12345678’, ‘Название организации’,‘Адрес организации’)”>Открыть в окне Нашли ошибку в данных? Сообщите нам об этом!
    (Откроется в новом окне)</a></p>
       <p><a href =“javascript:void(0)” onClick=“DG.feedback.showWindowNotFound
    (‘кафе’,‘Новосибирск, Ленина, 14’)”>Не нашли организацию? Сообщите нам об этом! (Откроется в новом окне)</a></p>
    </body>
</html>

Важно

Убедитесь, что в аттрибуте “onClick” тега “<a/>” параметры передаются как строки!