البدء

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

اتّبِع الخطوات التالية لإعداد ميزة "التصميم المستند إلى البيانات" لمجموعات البيانات.

الحصول على مفتاح واجهة برمجة تطبيقات وتفعيل واجهات برمجة التطبيقات

قبل استخدام ميزة "التصميم المستند إلى البيانات" لمجموعات البيانات، يجب أن يكون لديك: مشروع على Google Cloud يتضمّن حساب فوترة، مع تفعيل كلّ من Maps JavaScript API وMaps Datasets API. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.

الحصول على مفتاح واجهة برمجة التطبيقات

تفعيل Maps JavaScript API

تفعيل Maps Datasets API

إنشاء معرّف خريطة

لإنشاء معرّف خريطة جديد، اتّبِع الخطوات الواردة في التخصيص في السحابة الإلكترونية. اضبط نوع الخريطة على JavaScript، ثمّ حدِّد الخيار متّجه.

قدِّم معرّف خريطة باستخدام السمة 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',
});

إنشاء معرّف خريطة اتجاهية

إنشاء نمط خريطة جديد

لإنشاء نمط خريطة جديد، اتّبِع التعليمات الواردة في مقالة إنشاء أنماط الخرائط واستخدامها لإنشاء النمط، واربط النمط بمعرّف الخريطة الذي أنشأته للتو.

تعديل رمز إعداد الخريطة

لاستخدام ميزة "التصميم المستند إلى البيانات" لمجموعات البيانات، عليك أولاً تحميل "واجهة برمجة تطبيقات JavaScript لخرائط Google" من خلال إضافة عامل التحميل التمهيدي المضمّن إلى الرمز البرمجي للتطبيق، كما هو موضّح هنا (استخدِم 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 للاشتراك في تغييرات إمكانات الخريطة. سيشير هذا إلى ما إذا تم استيفاء الشروط التالية:

  • يتم استخدام معرّف خريطة صالح.
  • رقم تعريف الخريطة مرتبط بخريطة اتجاهية.

يُعدّ استخدام Map Capabilities اختياريًا، ويُنصح به فقط لأغراض الاختبار وتحديد المشاكل وحلّها، أو لأغراض الاحتياط أثناء التشغيل.

// 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.
  }
});

الخطوات التالية