البدء

اختيار النظام الأساسي: 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',
});

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

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

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

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

لاستخدام التنسيق المستند إلى البيانات لمجموعات البيانات، عليك أولاً تحميل 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.
  }
});

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