ניהול גרסאות

בחירת הערוץ השבועי

ברוב האפליקציות, מומלץ להשתמש בערוץ השבועי. זו הגרסה העדכנית ביותר, והיא כוללת את תיקוני הבאגים ושיפורי הביצועים האחרונים. כדי לציין את הערוץ השבועי, אפשר לטעון את Maps JavaScript API באמצעות תג הסקריפט הבא:

  <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",
    });
  </script>
  

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

באמצע נובמבר, הערוץ השבועי יתעדכן לגרסה 3.59. בשלב הזה, יכול להיות שתכונות שהוצאו משימוש יוסרו מהגרסה החדשה, ו/או שתהיה אי-תאימות לאחור.

בחירת הערוץ הרבעוני

יכול להיות שבאפליקציות מסוימות כדאי להשתמש בפחות עדכונים גדולים יותר, כי כך אפשר לחזות טוב יותר את העדכונים. באפליקציות האלה צריך להשתמש בערוץ הרבעוני. מומלץ להשתמש בגישה הזו אם אתם רוצים לקבל תיקוני באגים ושיפורי ביצועים בזמן צפוי (ראו עדכונים רבעוניים). כדי לציין את הערוץ הרבעוני, אפשר לטעון את Maps JavaScript API באמצעות תג הסקריפט הבא:

  <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: "quarterly",
  });
  </script>

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

באמצע נובמבר, הערוץ הרבעוני יעודכן לגרסה 3.58. הגרסה החדשה תכלול תכונות חדשות, תסיר תכונות שהוצאו משימוש ו/או תכלול אי-תאימות לאחור מ-3 החודשים האחרונים.

בחירת ערוץ הבטא

אתם יכולים להשתמש בערוץ הבטא כדי לנסות תכונות ושינויים חדשים בגרסת הבטא. התכונות בגרסת הבטא מושלמות מבחינה פונקציונלית, אבל יכול להיות שעדיין יש בהן בעיות חריגות (אפשר להשתמש בכלי למעקב אחר בעיות כדי לדווח על בעיות ולשלוח משוב). ערוץ הבטא לא מכוסה בהסכם רמת שירות או במדיניות הוצאה משימוש, וייתכן שחלק מהשינויים לא יהיו תואמים לאחור לגרסאות קודמות.

הערוץ הזה מבוסס על הערוץ weekly, והוא מתעדכן פעם בשבוע.

כדי לציין את ערוץ הבטא, אפשר לטעון את Maps JavaScript API באמצעות תג הסקריפט הבא:

  <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: "beta",
  });
  </script>

בחירת ערוץ האלפא

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

הערוץ הזה מבוסס על הערוץ beta, והוא מתעדכן פעם בשבוע.

כדי לציין את ערוץ האלפא, אפשר לטעון את Maps JavaScript API באמצעות תג הסקריפט הבא:

  <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: "alpha",
  });
  </script>

בחירת מספר גרסה

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

  <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: 3.57,
  });
  </script>

בשלב הזה אפשר לציין את הערכים v=3.58,‏ v=3.57,‏ v=3.56 או v=3.55.

• גרסה 3.58 מקבלת עדכונים שבועיים עם תכונות חדשות, תיקוני באגים ושיפורי ביצועים.
• בגרסה 3.57 לא מתקבלים עדכונים שבועיים.
• בגרסה 3.56 לא מתקבלים עדכונים שבועיים.
• בגרסה 3.55 לא מתקבלים עדכונים שבועיים.
• מעת לעת אנחנו עשויים להוסיף תיקוני באגים באבטחה לכל גרסה.
• יכול להיות שנוסיף שינויים שלא יהיו תואמים לגרסאות קודמות כשיוצרים גרסה חדשה.

אחרי אמצע נובמבר, תוכלו לציין את הערכים v=3.59,‏ v=3.58,‏ v=3.57 או v=3.56.

• לגרסה 3.59 יישלחו עדכונים שבועיים עם תכונות חדשות, תיקוני באגים ושיפורי ביצועים.
• לא יישלחו יותר עדכונים שבועיים לגרסה 3.58.
• לא יישלחו יותר עדכונים שבועיים לגרסה 3.57.
• לא יישלחו יותר עדכונים שבועיים לגרסה 3.56.
• מעת לעת אנחנו עשויים להוסיף תיקוני באגים באבטחה לכל גרסה.
• הגרסה 3.55 לא תהיה זמינה יותר. המערכת תתעלם מכל ניסיון לטעון את הגרסה הזו, ובמקום זאת יוצג ערוץ ברירת המחדל שלכם.

בתרשים הבא מוצגות הגרסאות שיהיו זמינות בכל ערוץ במהלך השנה הבאה.

עדכון השפיע על האפליקציה שלי

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

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

1. פותחים את המסוף בכלים למפתחים בדפדפן, ומעיינים בערך של google.maps.version.
2. מעדכנים את תג הסקריפט שמטעין את ה-API, ומבקשים מספר גרסה ישן יותר.
   לדוגמה, אם הערך של google.maps.version הוא '3.58.2', צריך להשתמש ב-v=3.57 בתג הסקריפט.
   הפתרון הזמני הזה יפעל לזמן מוגבל בלבד.

אחרי שתטמיעו את הפתרון הזמני, יהיה לכם זמן (בדרך כלל 3 עד 6 חודשים) לעדכן את האפליקציה כך שלא תשתמש יותר בתכונות שלא מתועדות או בתכונות שהוצאו משימוש, ותתחשב בבאגים או בתיקוני באגים.

לאחר מכן, צריך לחזור לתג הסקריפט המקורי כדי לטעון את ה-API.

אפשר גם ליצור בקשת תמיכה או לדווח על בעיה.

עדכונים רבעוניים

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