מתחילים

בחירת פלטפורמה: Android iOS JavaScript

כדי להגדיר סגנון מבוסס-נתונים לקבוצות נתונים, פועלים לפי השלבים הבאים.

קבלת מפתח API והפעלת ממשקי API

כדי להשתמש בסגנון מבוסס-נתונים לקבוצות נתונים, צריך פרויקט בענן ב-Google Cloud עם חשבון לחיוב, וגם להפעיל את Maps JavaScript API ואת Maps Datasets API. מידע נוסף זמין במאמר הגדרת פרויקט בענן ב-Google Cloud.

קבלת מפתח API

הפעלת 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. לשם כך, מוסיפים את רכיב הטעינה להפעלת API לקוד האפליקציה, כמו שמוצג כאן (משתמשים ב-v=beta בתג ה-API 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.
  }
});

השלבים הבאים