סקירה כללית

תכונות שמבוססות על WebGL עבור Maps JavaScript API מאפשרות לכם לשלוט בהטיה ובסיבוב, להוסיף אובייקטים תלת-ממדיים ישירות למפה ועוד. התכונות הבאות כלולות:

  • שכבת על מבוססת-WebGL מאפשרת להוסיף למפות גרפיקה דו-ממדית ותלת-ממדית בהתאמה אישית ותוכן מונפש.
  • הטיה וכיוון אפשר עכשיו לשנות באופן פרוגרמטי, וגם באמצעות מחוות של העכבר והמקלדת.
  • ‫map.moveCamera() מאפשר לשנות כמה מאפיינים של המצלמה בו-זמנית.
  • ‫Zoom תומך עכשיו בערכים חלקיים.

שנתחיל?

כדי להשתמש בתכונות החדשות של WebGL, צריך להשתמש במפת וקטור. בקטע הזה נסביר איך עושים את זה.

ציון האפשרות renderingType

אפשר להשתמש באפשרות renderingType כדי לציין את סוג העיבוד של המפה (רסטר או וקטור) בלי להשתמש במזהה מפה:

  1. טוענים את ספריית RenderingType. אפשר לעשות זאת כשמטעינים את ספריית Maps:

    const { Map, RenderingType } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;

  2. כשמאתחלים את המפה, משתמשים באפשרות renderingType כדי לציין את RenderingType.VECTOR או את RenderingType.RASTER:

    map = new Map(
  document.getElementById('map') as HTMLElement,
  {
    zoom: 4,
    center: position,
    renderingType: RenderingType.VECTOR,
  }
);

האפשרות renderingType מבטלת את ההגדרות של סוג העיבוד שנקבעו באמצעות הגדרת מזהה מפה.

  • כדי להפעיל הטיה וסיבוב, מגדירים את האפשרות tiltInteractionEnabled map לערך true או קוראים ל-map.setTiltInteractionEnabled.
  • כדי להפעיל את ההזזה, מגדירים את אפשרות המפה headingInteractionEnabled ל-true או קוראים ל-map.setHeadingInteractionEnabled.

שימוש במזהה מפה כדי להגדיר את סוג העיבוד

אפשר גם לציין את סוג העיבוד באמצעות מזהה מפה. כדי ליצור מזהה מפה חדש, פועלים לפי השלבים במאמר שימוש בעיצוב מפות מבוסס-ענן – קבלת מזהה מפה. חשוב להגדיר את סוג המפה ל-JavaScript ולבחור באפשרות Vector. מסמנים את התיבה הטיה או סיבוב כדי להפעיל את ההטיה והסיבוב במפה. כך תוכלו לשנות את הערכים האלה באופן פרוגרמטי, וגם לאפשר למשתמשים לשנות את ההטיה והכיוון ישירות במפה. אם השימוש בהטיה או בכיוון ישפיע לרעה על האפליקציה, אל תסמנו את התיבות הטיה וסיבוב כדי שהמשתמשים לא יוכלו לשנות את ההטיה והסיבוב.

יצירת מזהה מפה וקטורית

לאחר מכן, מעדכנים את קוד ההפעלה של המפה עם מזהה המפה שיצרתם. אפשר למצוא את מזהי המפות בדף ניהול מפות. מזינים מזהה מפה כשמפעילים את המפה באמצעות המאפיין mapId, כמו שמוצג כאן:

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

שימוש ברכיב <gmp-map>

כשמשתמשים ברכיב <gmp-map>, שמאפשר להוסיף מפה לדף באמצעות HTML, מפות וקטוריות, הטיה וכיוון ביחס לצפון מופעלות כברירת מחדל. מידע נוסף

דוגמאות

הוספנו דוגמאות כדי להמחיש את התכונות האלה: