راهنمای API نقشه وکتوری (MVT) سرویس می‌مپس

تایل‌ها به صورت Mapbox Vector Tiles (پروتوباف) با extent 4096 تولید می‌شوند و با Leaflet.VectorGrid، MapLibre GL JS و OpenLayers سازگار هستند.

فقط تایل‌هایی که با محدوده جغرافیایی ایران تلاقی دارند از دیتابیس خوانده می‌شوند. برای نواحی خارج از ایران پاسخ 204 No Content برگردانده می‌شود.

سه لایه مستقل: roads (جاده‌ها از planet_osm_line)، buildings (ساختمان‌ها از planet_osm_polygon)، points (نقاط POI از planet_osm_point). زوم ۰ تا ۲۲.

تایل‌های تولیدشده در var/cache/vector-tiles ذخیره می‌شوند. درخواست‌های بعدی همان تایل از کش پاسخ داده می‌شوند.

خطوط جاده از planet_osm_line با فیلتر highway IS NOT NULL. ویژگی‌ها: osm_id، name، highway.

source-layer: roads

پلیگون ساختمان از planet_osm_polygon با فیلتر building IS NOT NULL. ویژگی‌ها: osm_id، name، building.

source-layer: buildings

نقاط POI از planet_osm_point با نام یا amenity/shop/tourism. ویژگی‌ها: osm_id، name، amenity، shop، tourism.

source-layer: points

<script src="https://unpkg.com/leaflet@1.9.4/dist/leaflet.js"></script>
<script src="https://unpkg.com/leaflet.vectorgrid@1.3.0/dist/Leaflet.VectorGrid.bundled.js"></script>
<script>
var map = L.map('map').setView([35.6892, 51.3890], 10);
L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png').addTo(map);

var roads = L.vectorGrid.protobuf('https://memaps.ir/api/vector/roads/{z}/{x}/{y}.pbf', {
  vectorTileLayerStyles: {
    roads: { color: '#555', weight: 1.5 }
  },
  interactive: true
}).addTo(map);
</script>

var base = 'https://memaps.ir/api/vector/';
var roads = L.vectorGrid.protobuf(base + 'roads/{z}/{x}/{y}.pbf', {
  vectorTileLayerStyles: { roads: { color: '#555', weight: 1.5 } }
});
var buildings = L.vectorGrid.protobuf(base + 'buildings/{z}/{x}/{y}.pbf', {
  vectorTileLayerStyles: { buildings: { fillColor: '#ddd', color: '#888', weight: 0.8 } }
});
var points = L.vectorGrid.protobuf(base + 'points/{z}/{x}/{y}.pbf', {
  vectorTileLayerStyles: { points: { radius: 4, color: '#c00', fillColor: '#f66' } }
});
map.addLayer(roads);
map.addLayer(buildings);
map.addLayer(points);

map.addSource('roads', {
  type: 'vector',
  tiles: ['https://memaps.ir/api/vector/roads/{z}/{x}/{y}.pbf'],
  maxzoom: 22
});
map.addLayer({
  id: 'roads-layer',
  type: 'line',
  source: 'roads',
  'source-layer': 'roads',
  paint: { 'line-color': '#555', 'line-width': 1.5 }
});

async function getVectorTile(layer, z, x, y) {
  const url = `https://memaps.ir/api/vector/${layer}/${z}/${x}/${y}.pbf`;
  const res = await fetch(url);
  if (res.status === 204) return null; // خارج از ایران
  if (!res.ok) throw new Error(res.statusText);
  return await res.arrayBuffer();
}
getVectorTile('roads', 16, 41240, 26154);