ניהול גרסאות

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

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

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

  • הערוץ השבועי מצוין באמצעות v=weekly.
    הערוץ הזה מתעדכן פעם בשבוע, והוא הערוץ הכי עדכני.
  • הערוץ הרבעוני מצוין באמצעות v=quarterly.
    הערוץ הזה מתעדכן פעם ברבעון, והוא הכי צפוי.
  • ערוץ הבטא מצוין באמצעות v=beta.
    הערוץ הזה מבוסס על הערוץ weekly, והוא מתעדכן פעם בשבוע. היא כוללת שינויים נוספים לבדיקה מוקדמת ולקבלת משוב.
  • ערוץ האלפא מצוין באמצעות v=alpha.
    הערוץ הזה מבוסס על הערוץ beta, והוא מתעדכן פעם בשבוע. הוא כולל ניסויים לקבלת משוב מלקוחות על אבות טיפוס. הוא מיועד למטרות פיתוח בלבד, ואין להשתמש בו בייצור.
  • מספר הגרסה מצוין באמצעות v=n.nn.
    אפשר לבחור באחת מהאפשרויות הבאות: v=3.66, ‏ v=3.65, ‏ v=3.64 או v=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: "weekly",
    });
  </script>

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

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

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

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

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

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

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

הערוץ הזה מבוסס על הערוץ 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>

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

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

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

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

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

מאמצע נובמבר, תוכלו לציין את הערכים v=3.67,‏ v=3.66,‏ v=3.65 או v=3.64.

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

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

v=weekly v=quarterly v=3.nn v=3.nn-1 אוגוסט 2026 נובמבר 2026 פברואר 2027 מאי 2027 v3.63 v3.64 v3.64 v3.65 v3.65 v3.65 v3.66 v3.66 v3.66 v3.66 v3.67 v3.67 v3.67 v3.68 v3.68 v3.69

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

גרסה 3.67

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

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

גרסה 3.66

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

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

גרסה 3.65

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

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

גרסה 3.64

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

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

גרסה 3.63

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

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

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

בדיקות גרסה

כדי לנפות באגים, משתמשים במאפיין 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

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

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