Загрузка аналитики...
Tiles API
Векторные и растровые тайлы
0% использовано
Geocoder API
Прямое и обратное геокодирование
0% использовано
API Keys
Управление ключами для картографических запросов
Запросы за 7 дней
Агрегация по дням (tiles + geocode)
Recent Logs
Последние 50 запросов
API Reference
Полная документация картографического шлюза KCR ASIA
https://api.kcr.asia
Введение и авторизация
KCR ASIA Map API предоставляет доступ к тайлам карт, геокодированию и маршрутизации. Все защищённые эндпоинты требуют Bearer Token авторизацию в HTTP-заголовках. Токен выдаётся администратором при подключении информационной системы заказчика.
Заголовок авторизации
Authorization: Bearer <YOUR_API_TOKEN>/tiles/{z}/{x}/{y}.pbf
Vector & Raster Tiles
Получение высокоскоростных картографических тайлов в формате Mapbox Vector Tile (PBF). Используется для отображения карт в веб- и мобильных ГИС-приложениях.
Параметры пути
- z
- integer — уровень масштаба (zoom), 0–18
- x
- integer — координата тайла по оси X
- y
- integer — координата тайла по оси Y
Пример запроса
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.kcr.asia/tiles/data/zurich/12/2048/1365.pbf"/geocode
Прямое геокодирование
Поиск точных координат по строковому адресу или названию объекта. Возвращает список совпадений с координатами и отображаемым именем.
Query-параметры
- q
- string, required — адрес или название для поиска
- format
- string — формат ответа, по умолчанию
json
Пример запроса
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.kcr.asia/geocode?q=Алматы&format=json&limit=1"Пример ответа
[
{
"lat": "43.238949",
"lon": "76.889709",
"display_name": "Алматы, Казахстан"
}
]/reverse
Обратное геокодирование
Определение точного адреса и названия объекта по GPS-координатам. Используется для отображения адреса на карте по положению пользователя.
Query-параметры
- lat
- float, required — широта (latitude)
- lon
- float, required — долгота (longitude)
Пример запроса
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.kcr.asia/reverse?lat=43.238&lon=76.945&format=json"Пример ответа
{
"lat": "43.2389490",
"lon": "76.8897090",
"display_name": "проспект Абая, Алматы, Казахстан"
}/route
Маршрутизация OSRM
Построение оптимального автомобильного маршрута между двумя точками.
Возвращает GeoJSON-геометрию типа LineString с полным обзором маршрута,
расстоянием и временем в пути.
Query-параметры
- start
- string, required — начальная точка в формате
lon,lat - end
- string, required — конечная точка в формате
lon,lat
Пример запроса
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.kcr.asia/route?start=7.41,43.73&end=7.42,43.74"Пример ответа (фрагмент)
{
"routes": [{
"geometry": {
"type": "LineString",
"coordinates": [[7.41, 43.73], [7.42, 43.74]]
},
"distance": 1240.5,
"duration": 142.3
}]
}Коды ошибок (Status Codes)
Стандартные HTTP-коды ответа API Gateway.
| Код | Статус | Описание |
|---|---|---|
| 200 | OK | Запрос выполнен успешно |
| 401 | Unauthorized | Токен отсутствует, недействителен или просрочен |
| 429 | Too Many Requests | Превышен месячный лимит запросов (1.5M tiles / 300K geocode) |
| 500 | Internal Server Error | Внутренняя ошибка сервера или недоступность backend-сервиса |
Техническая поддержка
По вопросам подключения, выдачи токенов и инцидентов:
- Email support@kcr.asia
- Телефон +7 (700) 123-45-67
- Telegram @kcr_asia_support