API Documentation

Tasker Map API-г хэрхэн ашиглах бүрэн заавар

Authentication

Бүх API хүсэлтэд API key шаардлагатай. Dashboard-аас API key авна уу.

Authentication
// Query parameter
https://map.tasker.mn/tiles/{z}/{x}/{y}.pbf?key=gm_your_api_key

// Header
curl -H "X-API-Key: gm_your_api_key" \
  https://map.tasker.mn/tiles/{z}/{x}/{y}.pbf

Vector Tiles API

GET/tiles/{z}/{x}/{y}.pbf

Mapbox Vector Tile (PBF) формат. MapLibre GL JS-тэй ашиглана.

ParamТайлбар
zZoom level (0-14)
xTile X coordinate
yTile Y coordinate

Source layers

waterУс, нуур, гол
waterwayГолын урсгал
landuseГазар ашиглалт
buildingБарилга
transportationЗам
transportation_nameЗамын нэр
boundaryХил (admin 2, 4)
placeГазрын нэр
poiPOI
housenumberБайрны дугаар
MapLibre GL JS
const map = new maplibregl.Map({
  container: 'map',
  style: {
    version: 8,
    sources: {
      tasker: {
        type: 'vector',
        tiles: ['https://map.tasker.mn/tiles/{z}/{x}/{y}.pbf?key=YOUR_KEY'],
        maxzoom: 14
      }
    },
    glyphs: 'https://map.tasker.mn/fonts/{fontstack}/{range}.pbf',
    layers: [
      { id: 'water', type: 'fill', source: 'tasker',
        'source-layer': 'water', paint: { 'fill-color': '#a4c4e8' } },
      { id: 'roads', type: 'line', source: 'tasker',
        'source-layer': 'transportation', paint: { 'line-color': '#fff', 'line-width': 2 } },
      { id: 'buildings', type: 'fill', source: 'tasker',
        'source-layer': 'building', paint: { 'fill-color': '#d4cdc5' } }
    ]
  },
  center: [106.9176, 47.9187], zoom: 13
});

Routing API

GET/route/v1/{mode}/{lon1},{lat1};{lon2},{lat2}

OSRM-д суурилсан routing. Монгол орны бүх замыг дэмждэг.

ParamТайлбар
modedriving, walking, cycling
overviewfull, simplified, false
geometriesgeojson, polyline
stepstrue/false — алхам бүрийн заавар
Routing example
const res = await fetch(
  'https://map.tasker.mn/route/v1/driving/106.9176,47.9187;106.8830,47.9080' +
  '?overview=full&geometries=geojson&steps=true&key=YOUR_KEY'
);
const data = await res.json();
// data.routes[0].distance — зай (метр)
// data.routes[0].duration — хугацаа (секунд)
// data.routes[0].geometry — GeoJSON LineString

Geocoding API

GET/geocode?q={query}

Газрын нэрээр хайх (forward geocoding). OpenStreetMap дата дээр суурилсан.

ParamТайлбар
qХайх текст (газрын нэр, хаяг)
formatjson, jsonv2, geojson (default: jsonv2)
limitХариуны тоо (default: 10)
accept-languageХэл (mn, en)
Forward geocoding
// Газрын нэрээр хайх
const res = await fetch(
  'https://map.tasker.mn/geocode?q=Сүхбаатарын+талбай&format=jsonv2&key=YOUR_KEY'
);
const places = await res.json();
// places[0].lat, places[0].lon — координат
// places[0].display_name — бүтэн нэр
GET/reverse?lat={lat}&lon={lon}

Координатаар газрын нэр олох (reverse geocoding).

Reverse geocoding
// Координатаар хайх
const res = await fetch(
  'https://map.tasker.mn/reverse?lat=47.9187&lon=106.9176&format=jsonv2&key=YOUR_KEY'
);
const place = await res.json();
// place.display_name — "Сүхбаатарын талбай, ..."
// place.address — { city, country, ... }

Fonts API

GET/fonts/{fontstack}/{range}.pbf

MapLibre GL JS-д хэрэглэх font glyphs. API key шаардахгүй.

Боломжит фонтууд: Noto Sans Regular, Noto Sans Bold

Rate Limits

PlanTiles/сарRoutes/сарҮнэ
Free10,0001,000Үнэгүй
Pro1,000,000100,000₮50,000/сар
EnterpriseХязгааргүйХязгааргүйТохиролцоно