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

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

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

Зарегистрируйтесь на app.pickpoint.io — карта не нужна. Ключ API создаётся сразу (2500 запросов/день на Free). Скопируйте его в разделе API Key личного кабинета.

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

Да. Регистрация без карты: 2500 запросов/день, одно устройство трекинга и один API-ключ. Геокодинг и поиск без лимита RPS; routing — 1 req/s. Платные тарифы от $50/мес с пробными 14 днями.

На платных тарифах — 14 дней с полным доступом к API. Платежи обрабатывает Stripe. Если отменить триал до первой оплаченной фактуры, вы остаётесь на Free.

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 для пакетной передачи позиций из вашей телематической системы.

Только routing на Free: 1 req/s (burst 2). Геокодинг и поиск без RPS в рамках дневной квоты. Платные тарифы без RPS-лимита.

Да — одно устройство, без overage, ingest до 1 Гц. Флот — на Pro или Ultra.

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

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

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

Да. Повышение тарифа вступает в силу сразу. После первой оплаченной фактуры нельзя самостоятельно вернуться на Free. Отмена неоплаченного триала оставляет вас на Free. После оплаты отмена в конце периода отключает API, а не понижает до Free.

Рекомендуем официальные SDK — JavaScript, Python, Go, Ruby, Java/Kotlin, Rust, Dart, C++ — см. Integration guide. SDK закрывают auth, retry, refresh client-token, reconnect/resume треков и batch-geocoding с первого дня. Для кастомных стеков: HTTP — OpenAPI, трекинг — pickpoint-proto. В Geo Lab — интерактивные Try It для каждого endpoint.

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

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

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