ניהול גרסאות

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

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

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

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

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

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

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

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

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

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

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

הערוץ הזה מבוסס על ערוץ 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.64,
  });
  </script>

כרגע אפשר לציין v=3.65,‏ v=3.64,‏ v=3.63 או v=3.62.

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

אחרי אמצע אוגוסט, תוכלו לציין את האפשרויות הבאות: v=3.66, v=3.65, v=3.64 או v=3.63.

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

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

v=weekly v=quarterly v=3.nn v=3.nn-1 May 2026 Aug 2026 Nov 2026 Feb 2027 v3.62 v3.63 v3.63 v3.64 v3.64 v3.64 v3.65 v3.65 v3.65 v3.65 v3.66 v3.66 v3.66 v3.67 v3.67 v3.68

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

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

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

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

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

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

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

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

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

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

הערוץ השבועי מצביע כרגע על גרסה 3.65.

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

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

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

הערוץ הרבעוני מצביע כרגע על גרסה 3.64.

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

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

עדכוני גרסה

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

גרסה 3.66

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

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

גרסה 3.65

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

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

גרסה 3.64

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

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

גרסה 3.63

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

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

גרסה 3.62

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

תמיכה בגרסה

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

בדיקות גרסה

לצורך ניפוי באגים, משתמשים במאפיין google.maps.version כדי לקבל את הגרסה הנוכחית של Maps JavaScript API באפליקציה. בדוגמת הקוד הבאה אפשר לראות איך כותבים את גרסת ה-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

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

בנוסף, יש הפניה נפרדת לכל גרסה: