ניהול גרסאות

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

ברוב האפליקציות, מומלץ להשתמש בערוץ השבועי. זו הגרסה הכי עדכנית, והיא כוללת את תיקוני הבאגים ושיפורי הביצועים האחרונים. אפשר לציין את הערוץ השבועי על ידי טעינת 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.62. הגרסה הזו מתעדכנת מדי שבוע עם תכונות חדשות, תיקוני באגים ושיפורי ביצועים.

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

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

יכול להיות שחלק מהאפליקציות ירוויחו מעדכונים פחות תכופים אבל גדולים יותר, כי זה יאפשר חיזוי טוב יותר. באפליקציות האלה צריך להשתמש בערוץ הרבעוני. כדאי להשתמש בגישה הזו אם רוצים שתיקוני באגים ושיפורי ביצועים יגיעו בזמן צפוי (ראו עדכונים רבעוניים). אפשר לציין את הערוץ הרבעוני על ידי טעינת 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.61. במהלך הרבעון, הגרסה הזו לא מקבלת תכונות חדשות, תיקוני באגים או שיפורי ביצועים. מעת לעת, אנחנו עשויים להוסיף לגרסה הזו תיקוני באגים שקשורים לאבטחה.

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

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

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

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

אפשר לציין את ערוץ הבטא על ידי טעינת ממשק 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: "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>

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

מציינים גרסה לפי מספר רק אם בודקים ומעדכנים את האפליקציה באופן קבוע. הסיבה לכך היא שגרסאות ממוספרות נמחקות בסופו של דבר, כי גרסאות חדשות נוצרות בכל רבעון. אפשר לציין את מספר הגרסה על ידי טעינה של 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: 3.61,
  });
  </script>

אפשר לציין כרגע v=3.62,‏ v=3.61,‏ v=3.60 או v=3.59.

• גרסה 3.62 מקבלת עדכונים שבועיים עם תכונות חדשות, תיקוני באגים ושיפורי ביצועים.
• גרסה 3.61 לא מקבלת עדכונים שבועיים.
• גרסה 3.60 לא מקבלת עדכונים שבועיים.
• גרסה 3.59 לא מקבלת עדכונים שבועיים.
• מעת לעת, אנחנו עשויים להוסיף תיקוני באגים שקשורים לאבטחה לכל גרסה.
• יכול להיות שנציג שינויים שלא תואמים לאחור כשניצור גרסה חדשה.

אחרי אמצע נובמבר, תוכלו לציין v=3.63, v=3.62, v=3.61 או v=3.60.

• גרסה 3.63 תקבל עדכונים שבועיים עם תכונות חדשות, תיקוני באגים ושיפורי ביצועים.
• גרסה 3.62 לא תקבל יותר עדכונים שבועיים.
• גרסה 3.61 לא תקבל יותר עדכונים שבועיים.
• גרסה 3.60 לא תקבל יותר עדכונים שבועיים.
• מעת לעת, אנחנו עשויים להוסיף תיקוני באגים שקשורים לאבטחה לכל גרסה.
• גרסה 3.59 לא תהיה זמינה יותר. כל ניסיון לטעון את הגרסה הזו יתעלם ממנה, ותקבלו את ערוץ ברירת המחדל במקום.

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

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

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

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

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

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

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

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

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

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