شروع به کار

پلاتفرم را انتخاب کنید: Android iOS JavaScript

این مراحل را برای راه‌اندازی سبک‌بندی داده‌محور برای مجموعه‌داده‌ها دنبال کنید.

دریافت کلید میانای برنامه‌سازی کاربردی و فعال کردن میاناهای برنامه‌سازی کاربردی

قبل‌از استفاده از سبک‌بندی داده‌محور برای مجموعه‌داده‌ها، به موارد زیر نیاز دارید: پروژه Google Cloud با حساب صورت‌حساب، و هر دو Maps JavaScript API و Maps Datasets API فعال شده باشند. برای کسب اطلاعات بیشتر، راه‌اندازی پروژه Google Cloud را ببینید.

دریافت کلید میانای برنامه‌سازی کاربردی

فعال کردن Maps JavaScript API

فعال کردن Maps Datasets API

ایجاد شناسه نقشه

برای ایجاد شناسه نقشه جدید، مراحل موجود در سفارشی‌سازی ابری را دنبال کنید. «نوع نقشه» را روی جاوا اسکریپت تنظیم کنید و گزینه برداری را انتخاب کنید.

هنگام نمونه‌سازی نقشه، بااستفاده از ویژگی mapId شناسه نقشه را ارائه دهید . شناسه نقشه باید با سبک نقشه‌ای که با مجموعه داده مرتبط است مطابقت داشته باشد تا نمایش داده شود.

const position = new google.maps.LatLng(40.75, -74.05);
const map = new google.maps.Map(document.getElementById('map'), {
  zoom: 11,
  center: position,
  mapId: 'YOUR_MAP_ID',
});

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

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

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

کد مقداردهی اولیه نقشه را به‌روز کنید

برای استفاده از سبک‌بندی داده‌محور برای مجموعه‌های داده، ابتدا Maps JavaScript API را با افزودن بارگذار خودراه‌انداز درون‌خطی به کد برنامه‌تان بار کنید، همان‌طور که در اینجا نشان داده شده است (از v=beta در برچسب script میانای برنامه‌سازی کاربردی‌تان استفاده کنید):

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

بررسی قابلیت‌های نقشه (اختیاری)

سبک‌بندی داده‌محور برای مجموعه‌داده‌ها به شناسه نقشه نیاز دارد. اگر شناسه نقشه وجود نداشته باشد، یا شناسه نقشه نامعتبری ارسال شود، ویژگی‌های داده نمی‌توانند بار شوند. به‌عنوان یک مرحله عیب‌یابی، می‌توانید یک شنونده mapcapabilities_changed اضافه کنید تا در تغییرات قابلیت نقشه مشترک شوید. این نشان می‌دهد که آیا شرایط زیر برآورده شده است یا نه:

  • شناسه نقشه معتبری درحال استفاده است.
  • شناسه نقشه با نقشه بُرداری مرتبط است.

استفاده از «قابلیت‌های نقشه» اختیاری است و فقط برای اهداف آزمایشی و عیب‌یابی یا برای اهداف بازگشت زمان اجرا توصیه می‌شود.

// Optional: subscribe to map capability changes.
map.addListener('mapcapabilities_changed', () => {
  const mapCapabilities = map.getMapCapabilities();

  if (!mapCapabilities.isDataDrivenStylingAvailable) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
});

مراحل بعدی