نوع رندر (رستر و وکتور)

Maps JavaScript API دو پیاده سازی متفاوت از نقشه را ارائه می دهد: شطرنجی و برداری. نقشه شطرنجی به‌طور پیش‌فرض بارگیری می‌شود و نقشه را به‌عنوان شبکه‌ای از کاشی‌های تصویر شطرنجی مبتنی بر پیکسل بارگیری می‌کند، که توسط Google Maps Platform در سمت سرور تولید می‌شوند، سپس به برنامه وب شما ارائه می‌شوند. نقشه برداری از کاشی های مبتنی بر برداری تشکیل شده است که در زمان بارگذاری در سمت کلاینت با استفاده از WebGL ترسیم می شوند، یک فناوری وب که به مرورگر اجازه می دهد تا به GPU دستگاه کاربر برای ارائه گرافیک های دو بعدی و سه بعدی دسترسی داشته باشد. نوع نقشه برداری برای بهترین تجربه کاربری توصیه می شود، زیرا وفاداری بصری بهبود یافته و همچنین توانایی کنترل شیب و عنوان روی نقشه را فراهم می کند. درباره ویژگی های نقشه برداری بیشتر بدانید.

نوع رندر نقشه را با تعیین گزینه renderingType map یا با تنظیم گزینه در شناسه نقشه مرتبط تنظیم کنید. گزینه 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 map را روی true تنظیم کنید یا map.setTiltInteractionEnabled(true) را فراخوانی کنید.
  • برای فعال کردن پاننگ، گزینه headingInteractionEnabled map را روی true تنظیم کنید یا map.setHeadingInteractionEnabled(true) را فراخوانی کنید.

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

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

همچنین می توانید نوع رندر را با استفاده از شناسه نقشه مشخص کنید. برای ایجاد شناسه نقشه جدید، مراحل استفاده از استایل نقشه مبتنی بر ابر را دنبال کنید - شناسه نقشه دریافت کنید . مطمئن شوید که نوع Map را روی جاوا اسکریپت تنظیم کرده و یک گزینه ( Vector یا Raster ) را انتخاب کنید. گزینه Tilt and Rotation را علامت بزنید تا شیب و چرخش روی نقشه فعال شود. انجام این کار به شما این امکان را می دهد که به صورت برنامه ریزی شده این مقادیر را تنظیم کنید و همچنین به کاربران امکان می دهد شیب و سمت را مستقیماً روی نقشه تنظیم کنند. اگر استفاده از شیب یا عنوان بر برنامه شما تأثیر منفی می گذارد، شیب و چرخش را علامت نزنید تا کاربران نتوانند شیب و چرخش را تنظیم کنند.

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

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

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

Maps JavaScript API دو پیاده سازی متفاوت از نقشه را ارائه می دهد: شطرنجی و برداری. نقشه شطرنجی به‌طور پیش‌فرض بارگیری می‌شود و نقشه را به‌عنوان شبکه‌ای از کاشی‌های تصویر شطرنجی مبتنی بر پیکسل بارگیری می‌کند، که توسط Google Maps Platform در سمت سرور تولید می‌شوند، سپس به برنامه وب شما ارائه می‌شوند. نقشه برداری از کاشی های مبتنی بر برداری تشکیل شده است که در زمان بارگذاری در سمت کلاینت با استفاده از WebGL ترسیم می شوند، یک فناوری وب که به مرورگر اجازه می دهد تا به GPU دستگاه کاربر برای ارائه گرافیک های دو بعدی و سه بعدی دسترسی داشته باشد. نوع نقشه برداری برای بهترین تجربه کاربری توصیه می شود، زیرا وفاداری بصری بهبود یافته و همچنین توانایی کنترل شیب و عنوان روی نقشه را فراهم می کند. درباره ویژگی های نقشه برداری بیشتر بدانید.

نوع رندر نقشه را با تعیین گزینه renderingType map یا با تنظیم گزینه در شناسه نقشه مرتبط تنظیم کنید. گزینه 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 map را روی true تنظیم کنید یا map.setTiltInteractionEnabled(true) را فراخوانی کنید.
  • برای فعال کردن پاننگ، گزینه headingInteractionEnabled map را روی true تنظیم کنید یا map.setHeadingInteractionEnabled(true) را فراخوانی کنید.

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

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

همچنین می توانید نوع رندر را با استفاده از شناسه نقشه مشخص کنید. برای ایجاد شناسه نقشه جدید، مراحل استفاده از استایل نقشه مبتنی بر ابر را دنبال کنید - شناسه نقشه دریافت کنید . مطمئن شوید که نوع Map را روی جاوا اسکریپت تنظیم کرده و یک گزینه ( Vector یا Raster ) را انتخاب کنید. گزینه Tilt and Rotation را علامت بزنید تا شیب و چرخش روی نقشه فعال شود. انجام این کار به شما این امکان را می دهد که به صورت برنامه ریزی شده این مقادیر را تنظیم کنید و همچنین به کاربران امکان می دهد شیب و سمت را مستقیماً روی نقشه تنظیم کنند. اگر استفاده از شیب یا عنوان بر برنامه شما تأثیر منفی می گذارد، شیب و چرخش را علامت نزنید تا کاربران نتوانند شیب و چرخش را تنظیم کنند.

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

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

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