2ГИС: адреса, места, маршруты и зоны доступности
Навык отвечает на вопросы о местах и дорогах по данным 2ГИС: где находится адрес или организация, что есть рядом, как и сколько ехать или идти, какую территорию можно охватить за заданное время. К маршруту, зонам и отмеченным точкам Искра прикладывает картинку карты 2ГИС, к местам рядом — по просьбе. Если 2ГИС не прислал картинку, ответ придёт без неё.
Способ подключения: через Искру или свой ключ 2ГИС
Способ выбирается на странице навыка: «Настройки» → «Способ подключения».
| Способ | Откуда берётся ключ | Кто оплачивает запросы 2ГИС |
|---|---|---|
| Через Искру (по умолчанию) | Корпоративный ключ задаёт администратор платформы | Искра переводит стоимость запросов 2ГИС в МТ и списывает её с профиля |
| Свой ключ | Вы вводите свой ключ из Менеджера Платформы 2ГИС в поле «Ваш ключ API 2ГИС» | Подписка 2ГИС владельца ключа; МТ за запросы 2ГИС не списываются |
Обычный расход МТ на сам диалог с Искрой действует при обоих способах.
«Через Искру» подключать не нужно: он работает, когда администратор задал ключ. Если ключа нет, Искра ответит, что 2ГИС не настроен администратором, и предложит обратиться к нему или выбрать «Свой ключ».
Для способа «Свой ключ» ключ получают в Менеджере Платформы 2ГИС: демо-ключ на месяц или ключ подписки. При первом вопросе Искра откроет защищённую форму ключа; вставьте ключ туда, а не в сообщение чата. Если форма не появилась, откройте Навыки → 2ГИС → Настройки → Способ подключения. Ключ личный: даже если владелец организации выбрал «Свой ключ» для всей организации, каждый участник вводит свой. При ошибке ключа навык не переключается на ключ Искры. Чтобы вернуться к оплате в МТ, выберите в настройках «Через Искру». Режим «Выкл / По команде / Авто» способ не меняет.
Отдельного навыка «2ГИС (свой ключ)» больше нет: тем, кто им пользовался, уже выбран «Свой ключ», а ключ нужно один раз ввести заново.
Что можно спросить
| Задача | Пример вопроса | Что придёт в ответе |
|---|---|---|
| Найти место | «Где Ельцин Центр?» | Объект 2ГИС: название, адрес, тип, координаты |
| Узнать, что в точке | «Что находится по координатам 56.838, 60.5975?» | До трёх объектов рядом и расстояние |
| Найти места рядом | «Открытые аптеки рядом с Малышева 51» | Список с рейтингом, расстоянием и ссылкой на карточку 2ГИС (у платформ станций ссылки нет); карта по просьбе |
| Построить маршрут | «Сколько сейчас ехать от Ельцин Центра до Кольцово?» | Время с учётом пробок, расстояние, альтернативы, главные манёвры, карта и ссылка «Открыть маршрут в 2ГИС» для поездки на машине, пешком или на грузовике без промежуточных точек |
| Сравнить зоны доступности | «Какую территорию охватывают 15 минут пешком от метро Геологическая и Ботаническая?» | Площадь каждой зоны в км² и карта с закрашенными зонами |
| Показать точки | «Покажи на карте наши три офиса» | Карта с номерами меток |
Поиск рядом находит организации, достопримечательности, станции и входы метро, остановки транспорта и парковки; в ответе указан тип каждого места. Просьба «только открытые сейчас» оставляет организации с расписанием работы, поэтому станции метро и парковки в такую выдачу не попадают.
Для каждой точки, заданной адресом, Искра называет, что именно нашёл 2ГИС, например «ст. метро Геологическая, Екатеринбург». Адрес пишите с городом.
Маршрут на общественном транспорте навык не строит; зоны доступности на общественном транспорте строит.
Искра называет, как 2ГИС посчитал время маршрута: с учётом пробок или без. Если вы просили объехать платные дороги, паромы, грунтовки или трассы, а 2ГИС этого не сделал или не подтвердил, Искра скажет, какие из них остались на маршруте.
Зоны на общественном транспорте и на машине зависят от времени суток: ночью они не такие, как днём. Если время важно, назовите его в вопросе. Если время не названо, Искра уточнит его или возьмёт обычное дневное и скажет, на какое время построены зоны.
Как читать карту
- Места рядом и отмеченные точки пронумерованы так же, как в списке ответа.
- Маршрут — синяя линия, альтернативы — серые; зелёная метка — откуда, красная — куда.
- Зоны закрашены полупрозрачным цветом своей точки без обводки: чем ближе к точке по времени, тем плотнее цвет. Обычно каждая следующая по времени зона включает предыдущую. Иногда 2ГИС оставляет в большей зоне незакрашенный участок там, где меньшая зона есть: карта показывает ответ 2ГИС как есть.
- Точки зон отмечены тёмными фигурами: первая — ромб, вторая — квадрат, третья — треугольник.
- Недоступные участки внутри зоны остаются незакрашенными. Очень узкие проходы — уже одного-двух пикселей картинки — могут слиться с зоной; площадь в ответе считается по полной геометрии 2ГИС.
- Большие зоны на машине показываются на одну-две ступени масштаба мельче, чтобы заливка поместилась в картинку. Если карта не помещается и так, Искра ответит без картинки, а цифры останутся.
Если адрес найден неточно
Если 2ГИС нашёл не дом, а только улицу или город (например, на «Екатеринбург, Ленина 9999» — весь проспект Ленина), Искра не строит маршрут до середины улицы. Она скажет, что адрес найден неточно, и покажет кандидатов 2ГИС. Уточните дом или ориентир. Если вам нужна именно улица или район, скажите об этом: Искра продолжит по выбранному кандидату.
Искра всегда называет, что именно нашёл 2ГИС. Сверяйте это с тем, что вы имели в виду: если такого номера дома в 2ГИС нет, а улица называется так же, как станция метро, 2ГИС находит станцию. Например, на «Москва, Тверская 9999» или «Казань, Кремлёвская 777» 2ГИС находит станцию метро, и маршрут строится до неё. Существующие дома на таких улицах находятся как обычно.
Стоимость при способе «Через Искру»
Перед запросами Искра проверяет доступные МТ и рассчитывает наибольшую стоимость вызова по ценам 2ГИС, которые задал администратор, с коэффициентом платформы. После ответа списываются МТ только за запросы 2ГИС, на которые пришёл успешный ответ. Если вызов закончился ошибкой (например, адрес найден неточно), МТ не списываются.
Если не получилась только картинка, Искра покажет найденные данные без неё, и МТ спишутся за запросы поиска и расчёта. Для просьбы «покажи на карте» это значит: вы получите список найденных точек, а МТ спишутся за их поиск. За картинку МТ списываются, только если 2ГИС ответил на запрос карты успешно, даже когда картинка пришла пустой или сохранить её в чат не удалось.
Ориентир при коэффициенте 3: места рядом с картой — около 4 ₽, маршрут с картой — около 6 ₽, зоны двух точек с картой — около 8 ₽ в пересчёте на МТ вашего тарифа.
Ограничения и ошибки
| Что видите | Что делать |
|---|---|
| 2ГИС не настроен администратором | Обратитесь к администратору Искры или выберите способ «Свой ключ» |
| Ключ 2ГИС ещё не задан | Вставьте свой ключ в открывшуюся форму. Если форма не открылась — в Навыки → 2ГИС → Настройки → Способ подключения |
| 2ГИС не принял ключ | Свой ключ: проверьте его в Менеджере Платформы и сохраните верный в форме; на странице навыка будет пометка об ошибке ключа. Если форма не открылась — в Навыки → 2ГИС → Настройки → Способ подключения. Ключ Искры: сообщите администратору, вводить ключ вам не нужно |
| 2ГИС отказал сервису | В подписке нет нужного сервиса, исчерпан месячный лимит или истёк срок ключа |
| Маршрут не построен | На демо-ключе 2ГИС расстояние между точками ограничено 50 км; выберите другие точки или вид транспорта |
| 2ГИС ограничил частоту запросов | Повторите вопрос чуть позже. МТ за такой вызов не списываются. Демо-ключ ограничивает частоту сильнее, чем подписка, особенно на вопросах с несколькими точками |
| Карта недоступна | Данные показаны без картинки, причина названа в ответе |
Какие данные уходят в 2ГИС
В 2ГИС передаются адреса, координаты и поисковые запросы из вашего вопроса. Ключ берётся из защищённого хранилища и в текст чата не попадает. Картинка карты сохраняется в файлах чата со сроком хранения файлов чата. Приватный режим «Антоним» не распространяется на обращения навыка к 2ГИС.