ניהול גרסאות

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

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

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

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

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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

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

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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

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

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

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </script>

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.57
        &key=YOUR_API_KEY&callback=initMap">
</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 כבר לא תהיה זמינה. כל ניסיון לטעון את הגרסה הזו המערכת תתעלם ממנו, ותתקבל במקום זאת את ערוץ ברירת המחדל שלכם.

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

v=weekly v=ברבעון v=3.nn v=3.nn-1 אוגוסט 2024 נובמבר 2024 פברואר 2025 מאי 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

עדכון השפיע על הבקשה שלי

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

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

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

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

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

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

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

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

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

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

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

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

עדכון ערוץ רבעוני

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

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

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

עדכוני גרסה

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

גרסה 3.59

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

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

גרסה 3.58

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

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

גרסה 3.57

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

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

גרסה 3.56

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

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

גרסה 3.55

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

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

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

בדיקות גרסה

לניפוי באגים, צריך להשתמש בנכס 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

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

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