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

Всё для интеграции Me3ka в ваш проект

Быстрый старт

Подключите API за 5 минут. Регистрация, API-ключ, первый запрос с примерами.

API Reference

Полное описание всех эндпоинтов: геокодинг, маршрутизация, поиск, AI-чат, тайлы.

Аутентификация

Получение API-ключа, JWT-авторизация, X-API-Key заголовок.

Тарифы

Бесплатный тариф, платные планы, лимиты и превышения.

Карта

Интерактивная карта на основе MapLibre GL JS с векторными тайлами.

Геокодинг

Прямое и обратное геокодирование с нечётким поиском по 30M+ адресам.

Маршрутизация

Построение маршрутов на автомобиле через OSRM. Расстояние и время в пути.

Быстрый старт

1

Зарегистрируйтесь

Создайте аккаунт на странице регистрации. Бесплатный тариф — 1 000 запросов/мес.

2

Получите API-ключ

В личном кабинете создайте API-ключ. Используйте его в заголовке X-API-Key.

3

Отправьте первый запрос

Используйте любой HTTP-клиент (curl, fetch, axios) для вызова API.

Пример запроса 
curl "https://me3ka.ru/api/geocode?q=Москва+Тверская+1&limit=3" \
  -H "X-API-Key: YOUR_API_KEY"
Ответ 
{
  "results": [
    {
      "name": "г Москва, ул Тверская, д 1",
      "lat": 55.7558,
      "lon": 37.6173,
      "type": "building",
      "score": 0.92
    }
  ],
  "query": "Москва Тверская 1",
  "count": 1,
  "time_ms": 87
}

Аутентификация

Все запросы к API требуют передачи ключа одним из способов:

Для управления аккаунтом используется JWT-авторизация через заголовок Authorization: Bearer <token>.

Лимиты

Каждый тарифный план имеет ежемесячный лимит запросов. При превышении запросы тарифицируются по ставкам превышения. Текущий расход можно отслеживать в личном кабинете.

Коды ошибок