ניהול גרסאות

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

ערוצי הפצה ומספרי גרסאות

באפליקציה אפשר לציין את ערוצי הפרסום או את מספרי הגרסאות:

  • הערוץ השבועי מצוין באמצעות v=weekly.
    הערוץ הזה מתעדכן פעם בשבוע והוא הערוץ העדכני ביותר.
  • הערוץ הרבעוני מצוין באמצעות v=quarterly.
    הערוץ הזה מתעדכן פעם ברבעון, והוא הערוץ הניתן לחיזוי ביותר.
  • ערוץ הבטא מצוין באמצעות v=beta.
    הערוץ הזה מבוסס על הערוץ weekly, והוא מתעדכן פעם בשבוע. היא כוללת שינויים נוספים לצורך בדיקה מוקדמת ומשוב.
  • ערוץ האלפא מצוין באמצעות v=alpha.
    הערוץ הזה מבוסס על הערוץ beta, והוא מתעדכן פעם בשבוע. הוא כולל ניסויים לקבלת משוב מלקוחות על אב טיפוס. הוא מיועד לצורכי פיתוח בלבד ואין להשתמש בו בסביבת הייצור.
  • מספר הגרסה מצוין באמצעות v=n.nn.
    אפשר לבחור באפשרויות v=3.59, ‏ v=3.58, ‏ v=3.57 או v=3.56.
    מספרי הגרסאות מתעדכנים פעם ברבעון (ראו עדכונים רבעוניים).

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

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

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

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

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

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

באמצע פברואר, הערוץ הרבעוני יתעדכן לגרסה 3.59. הגרסה החדשה תכלול תכונות חדשות, תסיר תכונות שהוצאו משימוש ו/או תכלול אי-תאימות לאחור מ-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.58,
  });
  </script>

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

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

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

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

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

v=weekly v=quarterly v=3.nn v=3.nn-1 Nov 2024 Feb 2025 May 2025 Aug 2025 v3.56 v3.57 v3.57 v3.58 v3.58 v3.58 v3.59 v3.59�� v3.59 v3.59 v3.60 v3.60 v3.60 v3.61 v3.61 v3.62

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

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

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

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

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

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

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

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

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

עדכון שבועי של הערוץ

הערוץ השבועי מפנה כרגע לגרסה 3.59.

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

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

עדכון רבעוני של הערוץ

הערוץ הרבעוני מפנה כרגע לגרסה 3.58.

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

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

עדכוני גרסאות

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

גרסה 3.60

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

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

גרסה 3.59

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

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

גרסה 3.58

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

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

גרסה 3.57

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

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

גרסה 3.56

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

תמיכה בגרסאות

בכל רבעון זמינות ארבע גרסאות. יש תמיכה בכל ארבע הגרסאות האלה.

בדיקות גרסאות

לניפוי באגים, משתמשים במאפיין google.maps.version כדי לקבל את הגרסה הנוכחית של ממשק ה-API של JavaScript במפות Google באפליקציה. דוגמת הקוד הבאה כותבת את גרסת ה-API למסוף הדפדפן. (מידע נוסף על מסוף הדפדפן זמין במדריך בדיקת שגיאות בדפדפן).

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

תיעוד לגרסאות ה-API

מדריך למפתחים מתאר תמיד את הגרסה השבועית.

בנוסף, יש מסמך עזרה נפרד לכל גרסה: