Цена доставки в зависимости от расстояния

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

Модуль заменяет фиксированные и зональные тарифы на доставку моделью, при которой стоимость рассчитывается исходя из реального расстояния между магазином (или продавцом в Multi-Vendor) и адресом покупателя. Расстояние запрашивается через Google Maps, Яндекс или бесплатный OpenStreetMap Nominatim и сопоставляется с тарифными таблицами, которые вы настраиваете внутри каждого способа доставки. В итоге покупатель видит справедливую стоимость доставки, привязанную к реальной географии.

⚠ Важно — внешние API платные: Google Maps и Яндекс — это сторонние сервисы с оплатой по количеству запросов. Стоимость API-запросов выставляет сам провайдер; лицензия на модуль её не включает. Если вы хотите избежать любых сторонних расходов, выберите провайдер OpenStreetMap — он использует бесплатный публичный Nominatim и не требует API-ключа.

Ключевые возможности

• Три картографических провайдера — выберите Google Distance Matrix, Яндекс Distance Matrix или бесплатный OpenStreetMap (прямое расстояние через Nominatim) в одном переключателе; менять провайдер можно в любой момент без потери настроек тарифов.
• Автоматический резервный провайдер — если Google или Яндекс возвращает ошибку или таймаут, модуль автоматически переключается на OpenStreetMap, и стоимость доставки всегда будет рассчитана.
• Тарифные таблицы по расстоянию — добавляйте условие расстояния (D) к любому существующему способу доставки наряду с условиями по сумме, весу и количеству позиций; полная совместимость со структурой base_rate в CS-Cart 4.13.1+.
• Минимальное и максимальное расстояние для тарификации — установите нижний и верхний порог расстояния, чтобы корректно обрабатывать очень близкие и очень дальние заказы.
• Встроенный кеш сессии — рассчитанные расстояния и результаты геокодирования сохраняются в сессии корзины с настраиваемым TTL, сокращая запросы к API и расход квоты.
• Встроенная проверка подключения — убедитесь в правильности API-ключа и доступности провайдера прямо на странице настроек модуля одним нажатием кнопки.
• Подробное логирование — три уровня (ошибки / предупреждения / отладка) с возможностью маскировать чувствительные данные (адреса, API-ключи) для соответствия требованиям 152-ФЗ и GDPR.
• Расстояние на странице товара — опционально показывайте покупателю рассчитанное расстояние и адреса маршрута на странице товара для прозрачности условий доставки.
• Multi-Vendor и Ultimate — в Multi-Vendor адрес склада каждого продавца подставляется автоматически; в Ultimate адрес компании берётся из настроек витрины.
• Поддержка собственного сервера Nominatim — укажите URL своего экземпляра Nominatim для магазинов с высокой нагрузкой, которым нужна независимость от лимитов публичного сервиса.

Как это работает

1. Установка и настройка — выберите провайдер карт, введите API-ключ (обязателен для Google и Яндекс; не нужен для OpenStreetMap), задайте единицы расстояния (км или миля) и сохраните настройки.
2. Настройка тарифных таблиц — откройте любой способ доставки, добавьте условия по расстоянию и укажите стоимость для каждого диапазона — точно так же, как для условий по весу или сумме заказа.
3. Покупатель оформляет заказ — модуль геокодирует адрес доставки покупателя и адрес продавца, запрашивает расстояние у выбранного провайдера и передаёт результат в движок расчёта доставки CS-Cart.
4. Применяется тариф — CS-Cart выбирает подходящий диапазон расстояния и показывает соответствующую стоимость доставки на странице оформления заказа. Результат кешируется в сессии, так что последующие загрузки страниц выполняются мгновенно.

Требования

• CS-Cart или Multi-Vendor версии 4.9.0 и выше
• API-ключ Google Maps — обязателен при использовании провайдера Google (получить ключ)
• API-ключ Яндекс Distance Matrix — обязателен при использовании провайдера Яндекс (получить ключ)
• API-ключ не нужен для OpenStreetMap / Nominatim (публичный или собственный сервер)

Сравнение провайдеров

Google и Яндекс дают более точный результат на маршрутах с серпантинами и объездными дорогами. OpenStreetMap быстрее и бесплатен, но может занижать реальное расстояние в сложном рельефе.

Частые вопросы

В: Работает ли модуль с Multi-Vendor?
О: Да. Адрес склада каждого продавца подставляется автоматически. Расстояние рассчитывается для каждого продавца отдельно, поэтому при наличии товаров от нескольких продавцов каждый получает свой тариф по расстоянию.

В: Нужно ли платить за API-ключ Google Maps или Яндекс?
О: Да, если вы выбираете Google или Яндекс в качестве провайдера. Оба сервиса оплачиваются напрямую их компаниям по схеме pay-per-use — лицензия на модуль эти расходы не покрывает. Встроенный кеш сессии минимизирует число запросов к API, однако расходы со стороны Google или Яндекс всё равно будут зависеть от трафика вашего магазина. Если вы хотите полностью избежать сторонних расходов, выберите провайдер OpenStreetMap — он полностью бесплатен (публичный сервер Nominatim) или может быть развёрнут самостоятельно.

В: Что произойдёт, если провайдер карт временно недоступен?
О: Включите параметр «Использовать OpenStreetMap при ошибке провайдера». Если Google или Яндекс вернул ошибку, модуль автоматически переключится на OpenStreetMap, и стоимость доставки будет рассчитана в любом случае.

В: Не замедлит ли модуль оформление заказа?
О: Нет. Результаты кешируются в сессии корзины (TTL настраивается). Запрос к API отправляется только при изменении адреса; все последующие обращения в рамках сессии используют кешированное значение.