Node.js-də Statik Xəritələrin Yaradılması üçün Açıq Mənbə Kitabxanası

StaticMaps ilə işə başlamaq

StaticMaps quraşdırmanın tövsiyə olunan yolu NPM-dən istifadə etməkdir. Düzgün quraşdırma üçün aşağıdakı əmrdən istifadə edin.

npm i staticmaps 

Node.js-də Fərdiləşdirilə bilən Xəritə Yaradılması

Açıq mənbəli StaticMaps kitabxanasının əsas xüsusiyyətlərindən biri onun Node.js proqramları daxilində yüksək səviyyədə fərdiləşdirilə bilən xəritələr yaratmaq qabiliyyətidir. Proqram Tərtibatçıları təsvir ölçülərini, mərkəz koordinatlarını, böyütmə səviyyələrini, kafel təbəqələrini və daha çoxunu təyin edə bilərlər. Bu parametrlər tərtibatçılara xəritənin görünüşü üzərində incə nəzarət imkanı verir. Aşağıdakı kod nümunəsində xəritə 12 böyütmə səviyyəsi və 800x600 piksel təsvir ölçüsü ilə Berlin, Almaniya ətrafında mərkəzləşmişdir. Siz tətbiqinizin ehtiyaclarına əsasən bu parametrləri asanlıqla tənzimləyə bilərsiniz.

const StaticMaps = require('staticmaps');

// Create a new instance of StaticMaps with a specified width and height
const map = new StaticMaps({ width: 800, height: 600 });

// Set the map center and zoom level
map.center = [13.404954, 52.520008]; // Coordinates for Berlin
map.zoom = 12;

// Render and save the map as a PNG file
map.render()
  .then(() => map.image.save('basic_map.png'))
  .catch(err => console.error('Error generating map:', err));

Node.js-də Məkanları Göstərmək üçün Markerlər

StaticMaps xəritəyə markerlər əlavə etmək imkanı verir. Markerlər maraq nöqtələri, istifadəçi yerləri və ya digər mühüm yerlər kimi xüsusi yerləri vurğulamaq üçün faydalıdır. Açıq mənbəli StaticMaps kitabxanası proqram tərtibatçılarına Node.js proqramları daxilində xüsusi yeri göstərmək üçün markerlər əlavə etməyi asanlaşdırır. Aşağıdakı nümunə xəritədəki yerə fərdi markerin (xarici təsvirdən istifadə etməklə) necə əlavə olunacağını nümayiş etdirir. Siz markerin ölçüsünü və mövqeyini təyin edə, həmçinin müxtəlif yerlər üçün müxtəlif ikonalardan istifadə edə bilərsiniz.

// Create a marker object
const marker = {
  coord: [13.405, 52.52], // Berlin coordinates
  img: 'https://path-to-marker-icon.com/marker.png', // Custom marker image
  height: 32,
  width: 32
};

// Add the marker to the map
map.addMarker(marker);

// Render and save the map
map.render()
  .then(() => map.image.save('map_with_marker.png'))
  .catch(err => console.log(err));

Çoxlu Çıxış Formatlarına Dəstək

StaticMaps kitabxanası ilk növbədə çıxış formatı kimi PNG-ni dəstəkləyir, lakin əsas şəkil yaratma kitabxanası (Sharp) sizə şəkilləri JPEG, GIF və ya hətta PDF kimi müxtəlif populyar fayl formatlarına çevirməyə imkan verir. Bu, xəritələri müxtəlif növ sənədlərə və ya mediaya inteqrasiya edərkən faydalı ola bilər. Formatlar arasında keçid sadədir, çünki xəritəni saxlayarkən yalnız fayl uzantısını dəyişmək lazımdır. Node.js proqramlarında buna necə nail olmağı göstərən bir nümunədir.

map.render()
  .then(() => map.image.save('output_map.jpg'))  // Saving as a JPEG
  .catch(err => console.log('Error saving as JPEG:', err));

Marşrutların və ya Sərhədlərin Çəkilməsi üçün Polixəttlər

Polylines xəritədə yolları və ya sərhədləri vizuallaşdırmaq üçün vacibdir. Siz çoxlu xətlər çəkmək üçün StaticMaps-dən istifadə edə bilərsiniz, bu da onu çatdırılma xidmətləri və ya fitness izləmə proqramları kimi marşrutları göstərən proqramlar üçün əla seçimdir. Aşağıdakı nümunə göstərir ki, marşrutu təmsil etmək üçün bir neçə koordinat arasında qırmızı polixətt çəkilir. Siz tətbiqinizin üslubuna uyğun olaraq polixəttin rəngini və enini asanlıqla tənzimləyə bilərsiniz.

// Define a polyline with multiple coordinates
const polyline = {
  coords: [
    [13.405, 52.52], // Starting point in Berlin
    [13.4, 52.51],   // Intermediate point
    [13.42, 52.49]   // Ending point
  ],
  color: '#FF0000', // Red line
  width: 3          // Line width in pixels
};

// Add the polyline to the map
map.addLine(polyline);

// Render and save the map
map.render()
  .then(() => map.image.save('map_with_polyline.png'))
  .catch(err => console.error('Error rendering polyline map:', err));