امکانات نقشه و مستندات فنی

امکانات

احراز هویت

همه‌ی درخواست‌ها باید کلید API را در هدر x-api-key (یا پارامتر api_key) ارسال کنند:

curl -H "x-api-key: YOUR_KEY" https://api.kojamoja.ir/style.json

نمایش نقشه (MapLibre)

استایل نقشه از /style.json و تایل‌ها از /pmtiles/{archive}/{z}/{x}/{y} دریافت می‌شوند. با MapLibre GL JS:

const map = new maplibregl.Map({
  container: 'map',
  style: 'https://api.kojamoja.ir/style.json',
  transformRequest: (url) => ({ url, headers: { 'x-api-key': 'YOUR_KEY' } }),
})

مسیریابی

GET /route?point=lat,lng&point=lat,lng&profile=car|bicycle|foot — نقطه‌ی اول مبدأ و نقطه‌ی دوم مقصد است. پاسخ شامل هندسه‌ی مسیر، مسافت (متر)، زمان (ثانیه) و instructionsFa (دستورالعمل فارسی) است.

curl -H "x-api-key: YOUR_KEY" \
  "https://api.kojamoja.ir/route?point=35.7,51.4&point=35.8,51.45&profile=car"

جست‌وجو و داده‌ی کشوری

Lookup از مسیر /api/lookup و Core API از مسیر /api/core در دسترس‌اند. ساختار کامل درخواست و پاسخ در مستندات API آمده است.

محدودیت‌ها و خطاها