Часто задаваемые вопросы

PickPoint - геолокационная платформа с четырьмя REST и WebSocket API: Геокодинг (прямой, обратный и поиск по идентификатору), Маршрутизация (пошаговые маршруты и оптимизация мультистопов), Поиск адресов (предиктивный автодополнение), Трекинг устройств (GPS в реальном времени). Все API соответствуют спецификации OpenAPI 3.0 и доступны для тестирования в Geo Lab.

API v2 рекомендуется для всех новых интеграций. Аутентификация через заголовок X-API-KEY, поддержка всех четырёх API, активное развитие. API v1 - устаревшая версия, поддерживается только для обратной совместимости. Новые проекты не должны её использовать.

Зарегистрируйтесь на app.pickpoint.io, затем перейдите в раздел Подписка → API-ключи в личном кабинете. Каждый ключ можно ограничить конкретными методами API. Для продакшена создавайте отдельные ключи для каждого сервиса и окружения и меняйте их, если они попали в открытый доступ.

Добавляйте ключ API в каждый запрос к api.pickpoint.io через HTTP-заголовок X-API-KEY. Ключ чувствителен к регистру. Не встраивайте ключи в клиентский JavaScript - проксируйте запросы через свой сервер, чтобы не раскрывать учётные данные.

Да. Каждый платный тариф включает бесплатный пробный период с полным доступом к API. Платежи обрабатывает Stripe.

Geo Lab - интерактивная площадка в личном кабинете. Запускайте геокодинг, строите маршруты на карте, тестируйте автодополнение адресов и наблюдайте за треками устройств в реальном времени. Каждый ответ содержит сырой JSON и готовые примеры кода на cURL, Python, JavaScript и Ruby.

• Прямой геокодинг - адрес или название места → координаты (GET /v2/geocode/forward)
• Обратный геокодинг - координаты → адрес (GET /v2/geocode/reverse)
• Lookup по идентификатору - place ID → полные данные с GeoJSON-полигоном (GET /v2/geocode/lookup)

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

Да. Передайте разделённый запятыми список кодов стран по ISO 3166-1 alpha-2 в параметре country (например, country=RU,KZ). Также можно смещать результаты с помощью ограничивающего прямоугольника (bbox) или точки близости (focus.point.lat / focus.point.lon), не ограничивая жёстко зону поиска.

PickPoint объединяет данные OpenStreetMap с коммерческими наборами, включающими почтовые индексы, официальные адресные реестры, контуры зданий и точки интереса. Индекс непрерывно обновляется из живых изменений OSM и фидов поставщиков.

Точность зависит от плотности данных. В крупных городах Европы, Северной Америки и Восточной Азии большинство запросов разрешаются до уровня улицы или здания. В сельской местности и менее картографированных регионах результат может быть на уровне города или района. Проверяйте поля type и rank.confidence в ответе для оценки точности.

Да. Endpoint Geocode Lookup (GET /v2/geocode/lookup?ids=...) возвращает поле geometry с полными GeoJSON-границами для административных единиц, парков, зданий и других объектов там, где данные полигонов доступны в источнике.

Автомобиль, велосипед, автобус, грузовик, такси, мотоцикл, мопед, пешеход, велопрокат и мультимодальные маршруты. Каждый профиль учитывает ограничения скорости, правила доступа и предпочтительные покрытия. Маршрутизация для грузовиков учитывает габариты (высота, масса, нагрузка на ось) и ограничения для HGV. Подробнее в руководстве по маршрутизации.

Да. POST /v2/route/optimized принимает массив точек и возвращает оптимальный порядок посещения. Поддерживаются эвристика ближайшего соседа и улучшения 2-opt. Доступны временные окна для планирования доставок в заданные промежутки. Идеально для курьеров, выездного обслуживания и логистики.

Используйте массив avoid в теле запроса: допустимые значения - tolls, ferries, motorways, unpaved. Для географических исключений задайте произвольные полигоны в поле avoid_polygons - удобно для зон доставки, школьных зон или строительных участков.

Да. Установите instructions=true, чтобы получить массив шагов с типом манёвра, названием улицы, расстоянием и продолжительностью. Инструкции доступны на десятках языков через параметр language. Ответ также включает геометрию маршрута в виде закодированного полилайна или GeoJSON LineString.

Данные о реальном трафике доступны в поддерживаемых регионах на тарифах Business и Enterprise. При наличии трафика ответ содержит поле duration_in_traffic наряду с оценкой без учёта пробок. Передайте departure_time=now для активации маршрутизации с учётом трафика.

Address Search предоставляет предиктивное автодополнение по мере ввода. Отправьте частичный запрос на GET /v2/address/search?q=... и получите ранжированный список адресов-кандидатов со стабильными place ID. Поддерживаются фильтры по языку, стране, bbox, уровню масштаба и тегам OSM. Создан для форм оформления заказа, поисковых строк и адресных пикеров.

Address Lookup (GET /v2/address/lookup?ids=...) преобразует place ID из результата автодополнения в полные данные об адресе: координаты, GeoJSON-геометрию и метаданные. Используйте его вторым шагом, когда пользователь выбирает подсказку, чтобы получить полную запись без дополнительного вызова геокодера.

Передайте bbox (minLng,minLat,maxLng,maxLat) для жёсткого ограничения. Для мягкого смещения используйте focus.point.lat и focus.point.lon - ближайшие результаты получат больший вес без фильтрации остальных. Фильтр country можно комбинировать с обоими подходами.

Address Search оптимизирован для UX в реальном времени - быстрый, ранжированный по вероятности намерения пользователя, создан для выпадающих списков. Геокодинг лучше подходит для пакетной обработки или детерминированных одиночных запросов (например, при импорте CSV с адресами). Оба API используют один индекс данных и возвращают совместимые place ID.

Зарегистрируйте устройство через POST /v2/devices, затем подключитесь к WebSocket-endpoint для потоковой передачи GPS-фиксов в реальном времени. Каждое устройство получает уникальный токен. История треков хранится на сервере и доступна через GET /v2/devices/{id}/history. Дашборд показывает живую карту с позициями всех активных устройств и инструменты воспроизведения.

GPS-фиксы могут передаваться по WebSocket до 50 Гц. Большинство сценариев (трекинг транспорта, курьерская доставка, выездное обслуживание) хорошо работают при 1-5 Гц. Высокочастотные режимы для дронов, точного земледелия и навигационных приложений доступны на тарифах Business и Enterprise.

Да. GET /v2/devices/{id}/history возвращает временной GeoJSON LineString за любой диапазон дат. Срок хранения зависит от тарифа: 30 дней на Starter, 1 год на Business, настраивается на Enterprise. Треки можно экспортировать в GeoJSON или CSV.

Используйте WebSocket-endpoint с токеном устройства (отдельным от API-ключа). Примеры интеграции для iOS и Android доступны в руководстве по трекингу. Для серверных интеграций флота используйте REST API для пакетной передачи позиций из вашей телематической системы.

Нет. PickPoint не ограничивает запросы поминутно ни на одном тарифе. Вы можете отправлять всплески запросов в рамках дневной и месячной квоты без искусственных ограничений. Политика добросовестного использования применяется только для предотвращения злоупотреблений.

По умолчанию запросы сверх месячного лимита продолжают обрабатываться по тарифу за превышение, а не блокируются. Стоимость превышения варьируется от $0,04 до $0,25 за 1 000 дополнительных запросов в зависимости от тарифа. Для ограничения расходов отключите доп. запросы в настройках профиля - запросы сверх квоты будут возвращать ответ 429 до следующего периода.

Да. Мы предоставляем бесплатный или льготный доступ для квалифицированных некоммерческих организаций и open-source проектов. Напишите нам, описав свой проект - мы обычно отвечаем в течение одного рабочего дня.

Платежи обрабатываются через Stripe. Оплата картой или банковским переводом. Счета доступны в личном кабинете. Для Enterprise-тарифов возможно оформление счёта на оплату (инвойса) с отсрочкой net-30. Повышение тарифа учитывается пропорционально; понижение вступает в силу со следующего платёжного периода.

Да. Повышение тарифа вступает в силу немедленно с пропорциональным пересчётом. Понижение применяется с начала следующего цикла. Вы можете отменить подписку без штрафа в любой момент - долгосрочных обязательств нет, если вы не выбрали годовой план для получения скидки.

Готовые примеры кода на cURL, Python, JavaScript и Ruby доступны для каждого endpoint в Developer Portal и в Geo Lab. Полная спецификация OpenAPI 3.0 может быть импортирована в Postman, Insomnia или любой совместимый инструмент для автогенерации клиентов на любом языке.

API возвращает CORS-заголовки, поэтому запросы из браузера технически возможны. Тем не менее, настоятельно рекомендуем проксировать вызовы API через собственный сервер, чтобы не раскрывать API-ключ в публичном JavaScript. Для публичных виджетов создайте ограниченный ключ, привязанный к конкретным методам.

Да. Показатели доступности, история инцидентов и метрики времени ответа доступны на API Status page. Подпишитесь на уведомления по email или webhook для получения оповещений в реальном времени.

Пишите на support@pickpoint.io или воспользуйтесь формой обратной связи. Для срочных вопросов - виджет чата на любой странице. Тариф Starter включает поддержку по email. Тарифы Business и Enterprise обеспечивают приоритетную поддержку с гарантированным временем первого ответа по SLA.