Документация

Полная информация для оперативного решения ваших вопросов

Карты и маршруты

Для чего нужны геосервисы и какие они бывают
Использование геосервисов в Gootax
Настройка геосервисов в Gootax
Как получить ключ доступа для Яндекс
Как получить ключ доступа для Google
Как получить ключ доступа для 2GIS
Как получить ключ доступа для DaData

Для чего нужны геосервисы и какие они бывают

При создании заказа клиенту нужно указать адрес доставки. Для этого подключаем геосервисы. Они помогают клиентам, операторам искать и выбирать адреса, составлять маршруты по точкам, считать время в дороге и определять адрес по координатам на карте.Gootax интегрирован с несколькими геосервисами. Часть из них предлагают доступ к своим данным только на платной основе (например, Google или Яндекс), но есть бесплатные (OSM, бесплатная версия Яндекса) и условно-бесплатные (Dadata). Рассмотрим некоторые особенности и различия между сервисами.
OSM (OpenStreetMap) — полностью бесплатный сервис, карты наполняются сообществом, изменения проверяются и принимаются модераторами. Его плюсом является то, что работает на бесплатной основе, а минусом— неравномерная точность карт, небольшие города и поселки могут быть плохо прорисованы (мало улиц, нет новых домов). При этом для расчета маршрута сервис можно использовать, т.к. дороги практически не меняются.
DaData — условно-бесплатный сервис. Использует как базу систему КЛАДР (Классификатор адресов Российской Федерации, в который внесены все дома, организации, контакты) и карту OSM. Но т.к. КЛАДР не хранит координаты домов, DaData сопоставляет данные двух сервисов, если дом с координатами в OSM совпал с домом в КЛАДР, то у дома есть точные координаты. Если сопоставить дома не удалось, то DaData за координаты дома берет центр улицы, а иногда и центр города. Это отражается на расчете расстояния, времени подачи авто и построении маршрута, поэтому данный сервис лучше всего подходит для доставки ресторанов и магазинов. Бесплатный тариф рассчитан на 10 000 запросов в сутки — этого достаточно для работы сети ресторанов и магазинов. При регистрации сервис выдает Api Key и Secret Key.
2GIS — предоставляет платный доступ к данным. Необходимо заключить договор и получить ключ доступа у корпоративного менеджера 2GIS.
Google — предоставляет платный доступ к данным. Необходимо получить ключи доступа к Google Places API, Google Geocoding API, Google Routing API.
Yandex — предоставляет платный доступ к данным. Необходимо заключить договор и получить ключ доступа. Считается одним из самых дорогих, но и самых точных сервисов. Лучше всех считает пробки при расчете маршрута, т.к. у них больше всех статистики с навигаторов водителей.
Here.com — условно-бесплатный сервис. Рекомендуется для Европейского региона.

Использование геосервисов в Gootax

Сервисы используются в Gootax по разному, в зависимости от задачи. Под каждую задачу можно выбрать свой, наиболее подходящий сервис. Например для подложки — Яндекс, для поиска адресов — DaData, для расчета маршрута — OSM, для матрицы расстояний — OSM. Рассмотрим некоторые задачи и каким образом Gootax использует геосервисы для их решения.

«Карта-картинка»

В этом случае карта сервиса используется в качестве подложки, она не интерактивна, это просто рисунок, где отображены все объекты — дома, дороги, лес и т.д.
Gootax никак с картинкой не взаимодействует и не может «считать» с нее объекты, определить координаты, рассчитать маршрут. 
«Карта-картинка» отображается в мобильном приложении на первом экране, когда клиент только запустил приложение такси. Используется также в приложении водителя и в Панели Управления Gootax.
На данный момент это бесплатная услуга. Но некоторые сервисы уже накладывают ограничения на использование подложки. Например, у Яндекса есть лимит на количество отображений подложки и если его превысить, то подложка не будет отображаться в Панели управления службы.

Автокомплит и геокодинг

На данном этапе Gootax начинает взаимодействовать с сервисами, используя интеграцию с ними по определенному API.
Карты и сервисы, их предоставляющие, в данном случае используются Gootax для поиска местоположения клиента, поиска координат введенного им адреса, а также для подсказки адреса по нескольким буквам.
Использование геокодера помогает определить Gootax координаты объекта по его адресу или, наоборот, установить адрес по координатам. Например по запросу клиента «Москва, ул. Льва Толстого, 16» геокодер передаст координаты этого дома [37.587874, 55.73367] в систему Gootax для дальнейшего построения маршрута и расчета времени подачи автомобиля или доставки. Если клиент выбрал просто точку на карте, то геокодер определяет местоположение данной точки и отправляет в Gootax заданные координаты.
Автокомплит позволяет клиенту не писать полностью адрес, а выбирать из предложенных наименований нужное, что значительно сокращает время создания заказа.

Расчет маршрута

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

Матрица расстояний и времени

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

Система Gootax автоматически синхронизируется с базой OSM для загрузки обновлений карт. Таким образом, запросы координат проходят уже внутри системы, что значительно ускоряет процесс поиска адреса и построения маршрута.
Если при использовании любого из сервисов обнаруживается, что часть адресов в поиске не находится, их можно добавить вручную в Панели управления Gootax: Справочники → База адресов. И они будут выводиться в результатах поиска. Это внутренний инструмент, который позволяет накопить свою базу адресов для дальнейшей работы. А также можно загрузить в Gootax уже готовую базу небольшого объема адресов (файл в виде таблицы определенного формата и содержания).
Таким образом, у каждого сервиса есть свои плюсы и минусы, идеального бесплатного сервиса нет. У платных сервисов необходимо покупать минимум 3 ключа, некоторые стоимостью до 400 тысяч рублей в год.
Поэтому при выборе сервиса необходимо учитывать особенности вашего бизнеса (масштаб и специфику запросов), изучить точность отображения вашего региона на разных картах, узнать, каким сервисом чаще пользуются «местные» бизнесы, и используйте тот сервис, который больше всего Вам подходит.

Настройка геосервисов

Заходим в Настройки → Карты и маршруты. В верхней части окна отражены все филиалы — настраиваем карты для каждого из них.

Автокомплит и геокодинг

Автокомплит — как только вводим название улицы в заказе, система предлагает варианты, похожие на запрос. Геокодинг — отмечая точку на карте, система определяет адрес этой точки
Радиус — задаем радиус от центра филиала, внутри которого система будет искать адреса — указываем в километрах.
Расчет маршрута — выбираем сервис, через который система прокладывает маршрут по дорогам с учетом пробок: считает время и расстояние доставки. Рекомендуем указать OSM, так как сервис бесплатный.
При расчете маршрута избегать платные дороги — данную настройку можно активировать, если в настройках «Расчет маршрута» и «Матрица расстояний и времени» выбран через геосервис 2GIS.
Матрица расстояний и времени — выбираем OSRM. Система рассчитывает маршрут и время от адреса клиента до водителей, работающих на смене. Затем предлагает заказ тому, кто находится ближе всех к адресу клиента. Настроить распределение заказов между исполнителями можно в разделе Настройки → Заказы.

Как получить ключ доступа для Яндекс

  1. Переходим на сайт Яндекса https://developer.tech.yandex.ru/services/
  2. Нажимаем Подключить API
  3. Выбираем нужные инструменты и сервисы, заполняем заявку в коммерческую службу Яндекса.
  4. Для платного ключа в настройках указываем домен gootax.pro или коробки.

Как получить ключ доступа для Google

  1. Переходим на сайт Google https://console.cloud.google.com/
  2. Создаем новый проект
  3. Подключаем необходимые API для вашего проекта
  4. Добавляем банковскую карту, с которой будут списываться деньги за использование сервисов Google
  5. Ограничиваем доступ к вашим ключам
  6. Вводим ключ в панели Gootax

Как получить ключ доступа для 2GIS

  1. Запрашиваем ключ доступа у корпоративного менеджера 2GIS
  2. Вводим ключ в панели Gootax

Как получить ключ доступа для Dadata

Переходим на официальный сайт Dadata.ru и регистрируемся. 

После этого автоматически генерируется ключ и появляется в личном кабинете. 


Заходим в раздел Настройки → Карты и маршруты. Выбираем нужный филиал, в поле Автокомплит и геокодинг указываем Dadata. В поле Api Key вставляем сгенерированный API-ключ из Личного кабинета, а в поле Secret Key — секретный ключ.

Dadata.ru удобно использовать для сервисов доставки ресторанов и магазинов: он автоматически проверяет, исправляет и геокодирует адреса. 
Бесплатный тариф рассчитан на 10 000 запросов в день — этого достаточно для работы даже сети ресторанов и магазинов. 

Важно! Сервис Dadata построен на базе КЛАДР (общероссийская классификация адресов), предназначен только для России и не содержит адреса публичных мест (кафе, рестораны, магазины и тд) — только дома. Точность зависит от тщательной прорисовки города на карте OSM. Поэтому большая часть домов будет иметь точную координату, а остальные — с точностью до улицы или города


Заказать звонок

Заполните ваши контактные данные, и мы свяжемся с вами в ближайшее время

Нажимая кнопку Отправить, я принимаю политику конфиденциальности

Успешно

Данные отправлены.
Мы свяжемся с вами в ближайшее время.

Закрыть

Попробуйте бесплатно

Заполните ваши контактные данные, и мы свяжемся с вами в ближайшее время

Нажимая кнопку Отправить, я принимаю политику конфиденциальности

Успешно

Данные отправлены.
Мы свяжемся с вами в ближайшее время.

Закрыть

Попробовать

Оставить заявку