سیستم نقشه

ایجاد تجسم جغرافیایی خیره کننده با نقشه های تعاملی، رنگ آمیزی داده های کولین، و انیمیشن نشان می دهد.

[World Map Natural Earth] (…/images/map-world-natural-earth.png

بررسی اجمالی

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

• ** نقشه های جهانی و منطقه ای - نقشه های پیش بارگذاری شده از CDN (جهان، ایالات متحده، اروپا و غیره)
• ** پروژه های چند مرحله ای – Mercator، Natural Earth، Orthographic (globe)، Albers و بیشتر
• • نورپردازی منطقه - کشورهای با نور بالا، ایالت ها یا استان ها
• اطلاعات بصری سازی نقشه های Choropleth با مقیاس رنگ
• ** مارکرها و برچسب ها – اضافه کردن امتیاز
• • کیفیت حرفه ای - پشتیبانی چند قطبی از کشورهای پیچیده

دانلود فیلم A Map

از Templates

ساده ترین راه برای شروع استفاده از یک قالب نقشه است:

1. باز کردن پنل **Templates
2. دسته بندی Maps
3. یک الگو مانند “نقشه توسعه جهانی” یا “تجسم اطلاعات آمریکا” را انتخاب کنید

پنل ژنراتور

1. باز کردن Generator Panel
2. گزینه **Map به عنوان نوع پس زمینه
3. یک نقشه (World، USA، Europe و غیره) را انتخاب کنید
4. پیش بینی چهره و طراحی

انواع نقشه

پروژه

پیش بینی مناسب برای تجسم خود را انتخاب کنید:

زمین طبیعی (Default)

بهترین نقشه های جهان تحریف تعادل، طبیعی به نظر می رسد.

[پروژه زمین طبیعی] (…/images/map-world-natural-earth.png)

Mercator

زاویه ها را حفظ می کند، نگاه آشنا. خوب برای نقشه های سبک ناوبری.

[Mercator Projection]

Orthographic (Globe)

زمین را به عنوان یک کره 3D نشان می دهد. عالی برای دیدگاه های منطقه متمرکز.

[Orthographic Globe]

ایالات متحده آمریکا

پیش بینی ویژه برای نقشه های آمریکا که شامل آلاسکا و هاوایی است.

[آمریکا]

سایر پروژه ها

• **Robinson - Compromise پیش بینی، خوب برای نقشه های جهانی
• ** Winkel Tripel - پیش بینی جهان تحریف پایین
• • منطقه برابر باونیک - خوب برای مناطق متوسط

مناطق مرتفع

کشور / کشور

روی هر منطقه کلیک کنید تا آن را انتخاب کنید. سپس از پنل Properties برای تغییر رنگ آن استفاده کنید.

مناطق متعدد

از API یا قالب برای برجسته کردن مناطق مختلف استفاده کنید:

// Highlight North American countries
app.mapSystem.highlightRegions(
  ['United States of America', 'Canada', 'Mexico'],
  { fillColor: '#22c55e', strokeColor: '#16a34a' }
);

انیمیشن Reveals

قالب ها می توانند منطقه ای را با زمان بندی شده برای اثرات داستان سرایی برجسته کنند.

[مناطق با نور بالا]

منطقه ID Formats

نقشه های مختلف از فرمت های مختلف ID استفاده می کنند:

اطلاعات بصری سازی (Choropleth)

مناطق رنگی بر اساس ارزش های داده:

app.mapSystem.applyDataColors({
  'California': 39538223,
  'Texas': 29145505,
  'Florida': 21538187
}, {
  colorScale: 'blues',
  showLegend: true,
  legendTitle: 'Population'
});

مقیاس های رنگی

مارکرز

اضافه کردن نشانگر نقطه در مختصات خاص:

app.mapSystem.addMarker({
  lat: 37.7749,
  lon: -122.4194,
  label: 'San Francisco',
  color: '#ef4444',
  pulse: true  // Animated pulse effect
});

تنظیمات کیفیت

گزارشگر: استفاده از کیفیت professionalبرای کشورهایی با اشکال پیچیده (روسیه، فرانسه، ایالات متحده آمریکا) برای اطمینان از تمام قطعات منطقه به درستی ارائه می شود.

کشورهای چند زبانه

برخی از کشورها شامل چندین بخش مجزا هستند:

• ** روسیه - سرزمین اصلی + جزیره های کالیینگاد +
• ** فرانسه - سرزمین اصلی + Corsica + مناطق خارج از کشور
• ** ایالات متحده - سرزمین اصلی + آلاسکا + هاوایی (در نقشه های جهانی)
• ** هزاران جزیره
• *Fiji ** جزیره های متعدد

سیستم نقشه به طور خودکار از ترکیب Paper.js برای این کشورها استفاده می کند، زمانی که کیفیت برای professional تنظیم شده است.

عدم فعالیت

Hover Effects

ویژگی های بازی:

app.mapSystem.loadMap('world', {
  enableHover: true,
  hoverFill: '#93c5fd'
});

Click Events

پاسخ به کلیک های منطقه:

app.mapSystem.on('regionClick', (event) => {
  console.log('Clicked:', event.regionId);
  // Show info panel, highlight related regions, etc.
});

Map Templates

نقشه توسعه جهانی

توسعه کسب و کار در سراسر مناطق با برجسته سازی مبتنی بر مرحله متحرک را نشان می دهد.

اطلاعات آمریکا Visualization

نمایش داده ها در سراسر ایالات متحده با رنگ آمیزی کولین.

نقشه سفارشی واردات

برای نقشه های منطقه ای دقیق، استفاده از importCustomMap()

// Load from GeoJSON
await app.mapSystem.importCustomMap(geoJsonData, {
  projection: 'mercator',
  idProperty: 'name'
});

منابع داده:

• زمین طبیعی (https://naturalearthdata.com) - داده های نقشه عمومی
• [GADM] (https://gadm.org) - مرزهای اداری دقیق
• [Mapshaper] (https://mapshaper.org) - فایل های GeoJSON

نکات کلیدی

1. • استفاده از جهان HighRes ** برای صادرات حرفه ای با کشورهای چند قطبی
2. • پیش بینی طبیعی زمین - برای اکثر نقشه های جهان بهترین کار را می کند
3. • ایالات متحده آمریکا - به طور خاص برای نقشه های ایالات متحده طراحی شده است
4. Orthographic ایجاد دیدگاه های چشمگیر جهان برای ارائه
5. • کیفیت حرفه ای ** جلوگیری از شکل دادن فساد در کشورهای پیچیده

صفحه کلید میانبر

انیمیشن Map Zone Animation

مناطق نقشه Animate با تغییرات رنگ زمانی کامل برای نشان دادن تغییرات داده در طول زمان، توالی های توسعه جهانی یا ایجاد تجسم داده های جذاب.

انیمیشن های Basic Zone Animation

مناطق خاصی را با انتقال رنگ های مبتنی بر فریم کلید قرار دهید:

// Load a world map first
await app.loadMap('world', {
  projection: 'naturalEarth',
  fillColor: '#e2e8f0'
});

// Animate specific regions
app.animateMapRegions({
  duration: 5,
  loop: true,
  regions: {
    'USA': [
      { time: 0, fillColor: '#ef4444' },      // Red at start
      { time: 2.5, fillColor: '#22c55e' },    // Green at midpoint
      { time: 5, fillColor: '#ef4444' }       // Red at end (loops)
    ],
    'France': [
      { time: 0, fillColor: '#3b82f6' },      // Blue at start
      { time: 5, fillColor: '#fbbf24' }       // Yellow at end
    ]
  }
});

انیمیشن Wave Animation

ایجاد یک موج رنگ در تمام مناطق بر اساس موقعیت جغرافیایی:

app.animateMapWave({
  duration: 10,
  loop: true,
  colors: ['#ef4444', '#fbbf24', '#22c55e', '#3b82f6'],
  waveDirection: 'horizontal'  // 'horizontal', 'vertical', 'radial'
});

ادغام Timeline

مناطق متحرک با UI Timeline ادغام می شوند:

• مناطق متحرک در پانل Timeline ظاهر می شوند
• استفاده از زمان برای پیش نمایش تغییرات رنگ
• انیمیشن های Play/pause با کنترل جدول زمانی
• انیمیشن های صادرات به ویدئو یا GIF

[Timeline with Map Animations]

توقف انیمیشن

// Stop all region animations
app.stopMapAnimations();

// Stop specific regions
app.stopMapAnimations({ regions: ['USA', 'Canada'] });

// Stop but preserve current colors
app.stopMapAnimations({ resetColors: false });

دریافت مناطق متحرک

const animated = app.getAnimatedMapRegions();
// Returns: [{ regionId, keyframes, duration, loop }, ...]

صادرات CSV و واردات

صادرات و واردات داده های منطقه از جمله رنگ ها، موقعیت برجسته و حالت انتخاب برای تصاویر مبتنی بر داده ها.

صادرات داده های منطقه

// Export all regions with current state
const csv = app.exportMapRegionDataCSV();

// Export with custom options
const csv = app.exportMapRegionDataCSV({
  includeHighlighted: true,  // Include highlight status column
  includeSelected: true,     // Include selection status column
  includeColors: true        // Include fill/stroke colors
});

// Download directly as CSV file
app.downloadMapRegionDataCSV('my-map-data.csv');

CSV Format:

regionId,name,highlighted,selected,fillColor,strokeColor
USA,United States of America,1,0,#22c55e,#16a34a
CAN,Canada,0,0,#e5e7eb,#9ca3af
FRA,France,1,1,#3b82f6,#2563eb

واردات داده های منطقه

اطلاعات واردات CSV برای به روز رسانی کشورهای منطقه:

// Import from CSV text
app.importMapRegionDataCSV(csvText, {
  applyColors: true,      // Apply fill/stroke colors from CSV
  applyHighlight: true,   // Update highlight status
  applySelection: true    // Update selection status
});

انتخاب موضوعی

// Select regions programmatically
app.selectMapRegions(['USA', 'Canada', 'Mexico']);

// Deselect regions
app.deselectMapRegions(['Mexico']);

// Get highlighted regions
const highlighted = app.getHighlightedMapRegions();
// Returns: ['USA', 'France', ...]

Workflow: Spreadsheet-based Map Editing

1. یک نقشه را بارگذاری کنید و برخی مناطق را برجسته کنید
2. صادرات به CSV:
3. ویرایش در اکسل / Google Sheets (تغییر رنگ، برجسته شده)
4. واردات: app.importMapRegionDataCSV(updatedCsv)

این جریان کار برای:

• کاربران غیر فنی ویرایش داده های نقشه
• به روز رسانی های فله به بسیاری از مناطق
• ادغام خط لوله داده
• پیکربندی نقشه کنترل نسخه

صادرات GeoJSON و واردات

نقشه های صادرات به عنوان GeoJSON برای ویرایش در ابزارهای خارجی مانند QGIS یا Mapshaper، سپس با تغییرات خود دوباره گزارش دهید.

نقشه اصلاح شده

صادرات نقشه با رنگ ها و سبک های فعلی:

// Export as GeoJSON (includes current colors/styles)
const geoJson = app.exportMapGeoJSON();

// Download directly
app.downloadMapGeoJSON('my-styled-map.geojson');

منبع اصلی صادرات

GeoJSON را که برای بارگذاری نقشه استفاده می شد، دانلود کنید:

// Get original source data
const original = app.getOriginalMapGeoJSON();

// Download for external editing
app.downloadOriginalMapGeoJSON('world-source.geojson');

نقشه های سفارشی واردات

واردات اطلاعات GeoJSON یا نقشه خارجی

// Import from URL
await app.importCustomMap('https://example.com/my-map.geojson');

// Import from object
await app.importCustomMap(editedGeoJson, {
  projection: 'naturalEarth'
});

Full Workflow: Edit – Re-import

1. ** سود و صادرات - نقشه اصلی:

   await app.loadMap('world');
   app.downloadOriginalMapGeoJSON('world-source.geojson');
   

2. ** محدودیت ها در ابزارهای خارجی:

   • [QGIS] (https://qgis.org) سردبیر کامل GIS
   • [Mapshaper] (https://mapshaper.org) - ساده سازی آنلاین و ویرایش
   • [geojson.io] (https://geojson.io) ویرایشگر آنلاین سریع

3. *Re-import ** نقشه ویرایش شده شما:

   await app.importCustomMap(editedGeoJson, { projection: 'naturalEarth' });
   

4. ** نقشه سفارشی شما:

   app.animateMapRegions({
     duration: 5,
     regions: { 'MyRegion': [{ time: 0, fillColor: '#ef4444' }, ...] }
   });
   

Map Source Info

اطلاعات مربوط به نقشه بارگذاری شده در حال حاضر:

const info = app.getMapSourceInfo();
// {
//   source: 'world',
//   projection: 'naturalEarth',
//   quality: 'standard',
//   regionCount: 177,
//   hasOriginalGeoJSON: true,
//   isCustomImport: false
// }

منابع خارجی

Map Data Sources

تبدیل و ویرایش ابزار

تبدیل Workflow

Shapefile – GeoJSON (استفاده از Mapshaper):

1. به [mapshaper.org] (https://mapshaper.org
2. کشیدن و رها کردن فایل .shp (همراه با فایل های .dbf و .prj)
3. Click Simplify برای کاهش اندازه فایل (استفاده از 10-20٪ برای وب)
4. گزینه GeoJSON
5. واردات به PinePaper با app.importCustomMap()

TopoJSON

فایل های TopoJSON به طور خودکار هنگامی که به PinePaper وارد می شوند، تبدیل می شوند.

ویژگی های File Size

مرجع API

برای کنترل نقشه برنامه ریزی شده، [Map System API] را ببینید (/api/features/maps).