Введение и авторизация

KCR ASIA Map API предоставляет доступ к тайлам карт, геокодированию и маршрутизации. Все защищённые эндпоинты требуют Bearer Token авторизацию в HTTP-заголовках. Токен выдаётся администратором при подключении информационной системы заказчика.

Заголовок авторизации

Authorization: Bearer <YOUR_API_TOKEN>

Vector & Raster Tiles

Получение высокоскоростных картографических тайлов в формате Mapbox Vector Tile (PBF). Используется для отображения карт в веб- и мобильных ГИС-приложениях.

Пример запроса

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://mapapi.cur.kz/tiles/data/kazakhstan/12/2855/1368.pbf"

Прямое геокодирование

Поиск точных координат по строковому адресу или названию объекта. Возвращает список совпадений с координатами и отображаемым именем.

Пример запроса

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://mapapi.cur.kz/geocode?q=Алматы&format=json&limit=1"

Пример ответа

[
  {
    "lat": "43.238949",
    "lon": "76.889709",
    "display_name": "Алматы, Казахстан"
  }
]

Обратное геокодирование

Определение точного адреса и названия объекта по GPS-координатам. Используется для отображения адреса на карте по положению пользователя.

Пример запроса

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://mapapi.cur.kz/reverse?lat=43.238&lon=76.945&format=json"

Пример ответа

{
  "lat": "43.2389490",
  "lon": "76.8897090",
  "display_name": "проспект Абая, Алматы, Казахстан"
}

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

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

Пример запроса

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://mapapi.cur.kz/route?start=76.9286,43.2389&end=76.9455,43.2382"

Пример ответа (фрагмент)

{
  "routes": [{
    "geometry": {
      "type": "LineString",
      "coordinates": [[76.9286, 43.2389], [76.9455, 43.2382]]
    },
    "distance": 1240.5,
    "duration": 142.3
  }]
}

Поиск организаций (Places API)

Поиск организаций и объектов инфраструктуры по названию или типу (например, больница, кафе, аптека). Ответ включает атрибуты инклюзивности из OpenStreetMap — доступность для маломобильных граждан (пандусы, коляски) в блоке details.

Пример запроса

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://mapapi.cur.kz/places?q=hospital+almaty"

Пример ответа

{
  "query": "hospital",
  "count": 1,
  "results": [{
    "name": "City Hospital, Main Street",
    "type": "hospital",
    "category": "amenity",
    "location": { "lat": "43.238", "lon": "76.945" },
    "details": {
      "wheelchair": "yes",
      "opening_hours": "Mo-Fr 08:00-18:00",
      "phone": "+7 700 123 4567",
      "website": "https://example.org"
    }
  }]
}

Инклюзивность: поле details.wheelchair принимает значения OSM — yes (доступно), no (недоступно), limited (частично) или null, если данные отсутствуют.

Коды ошибок (Status Codes)

Стандартные HTTP-коды ответа API Gateway.