ניהול גרסאות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  <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.55
        &key=YOUR_API_KEY&callback=initMap">
</script>

בשלב הזה אפשר לציין v=3.56, v=3.55, v=3.54 או v=3.53.

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

אחרי אמצע מאי, אפשר יהיה לציין v=3.57, v=3.56, v=3.55 או v=3.54.

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

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

v3.53v3.54v3.54v3.55v3.55v3.55v3.56v3.56v3.56v3.56v3.57v3.57v3.57v3.58v3.58v3.59

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

עדכוני גרסה

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

גרסה 3.57

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

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

גרסה 3.56

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

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

גרסה 3.55

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

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

גרסה 3.54

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

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

גרסה 3.53

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

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

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

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

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

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

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