نوع پرداز زدن (شطرنجی و برداری)

‫Maps JavaScript API دو پیاده‌سازی مختلف از نقشه ارائه می‌دهد: شطرنجی و بُرداری. نقشه شطرنجی نقشه را به‌صورت شبکه‌ای از کاشی‌های تصویر شطرنجی مبتنی بر پیکسل بار می‌کند که توسط سمت سرور «پلاتفرم Google Maps» تولید می‌شوند و سپس به برنامه وب شما ارائه می‌شوند. نقشه بُرداری از کاشی‌های مبتنی بر بُردار تشکیل شده است که در زمان بارگیری در سمت کارخواه بااستفاده از WebGL ترسیم می‌شوند. WebGL یک فناوری وب است که به مرورگر اجازه می‌دهد برای ارائه گرافیک‌های دوبعدی و سه‌بعدی به GPU در دستگاه کاربر دسترسی داشته باشد.

نوع نقشه بُرداری برای بهترین تجربه کاربری توصیه می‌شود، زیرا دقت بصری بهبودیافته، ذخیره بهتر در حافظه نهان در نقشه‌ها، و همچنین توانایی کنترل شیب و جهت در نقشه را ارائه می‌دهد. درباره ویژگی‌های نقشه بُرداری بیشتر بدانید.

نوع پردازش پیش‌فرض

نوع پیش‌فرض پرداز نقشه بسته به پیاده‌سازی شما متفاوت است.

  • نقشه‌هایی که از عنصر <gmp-map> استفاده می‌کنند به‌طور پیش‌فرض از نوع پرداز برداری استفاده می‌کنند.

  • نقشه‌هایی که از عنصر <div> با google.maps.Map استفاده می‌کنند، به‌طور پیش‌فرض از نوع رندر کردن شطرنجی استفاده می‌کنند.

نوع پرداز را برای نقشه با مشخص کردن گزینه نقشه renderingType یا با تنظیم گزینه در شناسه نقشه مرتبط تنظیم کنید. گزینه renderingType هرگونه تنظیمات نوع پردازش را که با پیکربندی شناسه نقشه انجام شده است لغو می‌کند.

گزینه renderingType را مشخص کنید

از گزینه renderingType برای مشخص کردن نوع رندر کردن شطرنجی یا برداری برای نقشه‌تان استفاده کنید (به شناسه نقشه نیازی نیست). برای نقشه‌های بارشده بااستفاده از عنصر div و جاوا اسکریپت، نوع پیش‌پرداز پیش‌فرض google.maps.RenderingType.RASTER است. برای تنظیم گزینه renderingType، این مراحل را دنبال کنید:

  1. کتابخانه RenderingType را بار کنید؛ این کار را می‌توان هنگام بار کردن کتابخانه Maps انجام داد:

    const { Map, RenderingType } = await google.maps.importLibrary("maps");
    
  2. هنگام مقداردهی اولیه نقشه، از گزینه renderingType برای مشخص کردن RenderingType.VECTOR یا RenderingType.RASTER استفاده کنید:

    map = new Map(
      document.getElementById('map'),
      {
        zoom: 4,
        center: position,
        renderingType: RenderingType.VECTOR,
      }
    );
    

وقتی نوع پرداز نقشه بُرداری تنظیم شد، باید گزینه‌های ویژگی‌های موردنیاز را تنظیم کنید.

  • برای فعال کردن کج کردن، گزینه نقشه tiltInteractionEnabled را روی true تنظیم کنید یا map.setTiltInteractionEnabled(true) را فراخوانی کنید.
  • برای فعال کردن حرکت، گزینه نقشه headingInteractionEnabled را روی true تنظیم کنید یا map.setHeadingInteractionEnabled(true) را فراخوانی کنید.

برای نقشه‌های بارشده بااستفاده از عنصر <gmp-map>، نوع پیش‌فرض ارائه google.maps.RenderingType.VECTOR است و کنترل کج کردن و جهت فعال است. برای تنظیم نوع پردازش بااستفاده از عنصر <gmp-map>، از مشخصه rendering-type استفاده کنید.

استفاده از شناسه نقشه برای تنظیم نوع پرداز_سازی

همچنین می‌توانید نوع پردازش را بااستفاده از شناسه نقشه مشخص کنید. با دنبال کردن مراحل استفاده از سبک‌پردازی نقشه بااستفاده از فضای ابری - دریافت شناسه نقشه، شناسه نقشه ایجاد کنید. حتماً «نوع نقشه» را روی جاوا اسکریپت تنظیم کنید و گزینه‌ای (برداری یا شطرنجی) را انتخاب کنید. برای فعال کردن کج کردن و چرخاندن در نقشه، کج کردن و چرخاندن را علامت بزنید. با این کار می‌توانید این مقادیر را به‌صورت برنامه‌نویسی‌شده تنظیم کنید و همچنین به کاربران اجازه می‌دهد شیب و جهت را مستقیماً روی نقشه تنظیم کنند. اگر استفاده از شیب یا جهت بر برنامه شما تأثیر منفی می‌گذارد، شیب و چرخش را علامت‌نزده رها کنید تا کاربران نتوانند شیب و چرخش را تنظیم کنند.

ایجاد شناسه نقشه بُرداری

سپس، کد مقداردهی اولیه نقشه را با شناسه نقشه‌ای که ایجاد کردید به‌روز کنید. می‌توانید شناسه‌های نقشه‌تان را در صفحه مدیریت Maps پیدا کنید. هنگام نمونه‌سازی نقشه بااستفاده از ویژگی mapId، شناسه نقشه را به‌صورت زیر ارائه دهید:

map = new google.maps.Map(document.getElementById('map'), {
  center: {lat: -34.397, lng: 150.644},
  zoom: 8,
  mapId: 'MAP_ID'
});

تشخیص اینکه کدام نوع پردازش درحال استفاده است

برای تشخیص اینکه از کدام نوع پرداز استفاده می‌شود، getRenderingType() را در شیء نقشه فراخوانی کنید، همان‌طور که در مثال زیر نشان داده شده است:

  // Wait for the map to finish loading.
  google.maps.event.addListenerOnce(map, "tilesloaded", () => {
      // Print the rendering type to the console.
      console.log(`${map.getRenderingType()}`);
  });```