הוצאה משימוש

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

איך הוצאה משימוש

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

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

הוצאה משימוש בגרסאות SDK

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

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

בקישורים הבאים אפשר לקבל הנחיות לניהול יחסי תלות של גרסאות: SDK SDK של Android ל-Android, SDK של מפות ל-iOS, SDK SDK של מקומות ל-Android ו-SDK SDK ל-iOS.

הוצאה משימוש פעילה

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

גבולות, מיקום ורדיוס בשירות Maps JavaScript API השלמה אוטומטית (הוצא משימוש החל ממאי 2023)

עבור שירות ההשלמה האוטומטית של מקומות ב-JavaScript של API למפות, אפשרויות הבקשה הבאות הוצאו משימוש החל ממאי 2023: גבולות, מיקום ורדיוס. במקומה יש להשתמש ב-locationBias וב-locationRestriction.

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

ספריית הקשר מקומי, Maps JavaScript API (הוצא משימוש החל מגרסה 3.51.2)

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

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

ספריית תאימות למקומות עבור SDK של Android ל-Android (החל מ-31 במרץ 2022)

כל הגרסאות של ספריית התאימות של מקומות ל-SDK ל-Android הוצאו משימוש ב-31 במרץ 2022. אנחנו מקפיאים את הפיתוח של ספריית התאימות של מקומות Google ל-Android SDK בגרסה 2.6.0 (הפירוט בהתאם ליחסי התלות כ-com.google.android.libraries.places:places-compat:2.6.0).

לא יתקבלו גרסאות חדשות של הספרייה הזו אחרי התאריך הזה. הדרך היחידה לגשת לתכונות ולתיקוני באגים ב-'SDK של מקומות Google ל-Android' מעל גרסה 2.6.0 תהיה להשתמש ב-'SDK של מקומות' ל-Android.

ספריית התאימות של מקומות הושקה בינואר 2019 כדי לעזור במעבר מ-SDK מדור קודם (זמין ב-Play Services) ל-SDK העצמאי של מקומות ל-Android.

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

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

שאילתות לא נתמכות בחיפוש מקומות ב-API של 'מקומות' ובספריית 'מקומות', API של מפות Google JavaScript (31 במרץ 2022 עד 31 במרץ 2023)

החל מ-31 במרץ 2022 הוצאנו משימוש את השאילתות של 'חיפוש מקומות' שאינן נתמכות עבור 'חיפוש טקסט', 'חיפוש בקרבת מקום' ו'איתור מקום' ב-'API של מקומות Google' וב'ספריית מקומות', וה-API של מפות Google הוצא משימוש INVALID_REQUEST.

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

חלק מהשילובים של פרמטרים שאינם נתמכים לא נדחו עד כה:

  • בקשות לחיפוש טקסט עם פרמטר query ריק או חסר, ללא פרמטר type נתמך.
  • בקשות חיפוש טקסט עם query=*.
  • בקשות חיפוש בקרבת מקום עם keyword=*.
  • בקשות חיפוש בקרבת מקום עם name=*.
  • אפשר למצוא בקשות למקומות באמצעות input=*.

את הבקשות הלא נתמכות אלה לחיפוש מקומות עליכם להחליף באחת מהאפשרויות הבאות:

  • בקשות חיפוש בקרבת מקום ללא הפרמטר keyword (או name) יכולות לשמש לאיתור מוסדות בקרבת מקום. מומלץ גם להשתמש בפרמטר type עם סוג נתמך אחד (ראו טבלה 1: סוגי מקומות). כך מתקבלת ההתאמה הקרובה ביותר להתנהגות הנוכחית של בקשות חיפוש טקסט עם פרמטר query ריק או חסר.

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

    • בקשות חיפוש טקסט עם query=*.
    • בקשות חיפוש בקרבת מקום עם keyword=*.
    • בקשות חיפוש בקרבת מקום עם name=*.
    • אפשר למצוא בקשות למקומות באמצעות input=*.

עדכון של מדיניות אבטחת התוכן (21 במרץ 2022 עד מאי 2023)

החל מגרסה 3.49, אין תמיכה באתרים שמשתמשים ב-Content Security Policy (CSP) שלא מצוין בהם הערך googleapis.com ב-Maps JavaScript API, והתמיכה בהם תהיה החל מגרסה 3.50. בגרסה האחרונה (v3.49) נוציא משימוש את הגרסה התומכת ברבעון 2 של 2023. לאחר מכן, ה-API של מפות Google ידחה את כל הבקשות בהתאם להנחיות CSP שלא מצוין בהן googleapis.com.

כדי להימנע מהפרעה לחוויית השימוש באתר, יש לציין את googleapis.com ב-CSP. כל הגרסאות הזמינות כרגע של JavaScript JavaScript API תומכות ב-CSP.

שירותי המשחקים של הפלטפורמה של מפות Google (18 באוקטובר 2021 – 31 בדצמבר 2022)

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

מזהי מקומות מיושנים (16 במרץ 2021 עד 30 במרץ 2022)

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

המודול 'מפות' בכתובת google.load (13 באוקטובר 2020 עד 13 באוקטובר 2021)

השירות שמספק את המודול "מפות" עבור google.load יוצא משימוש ב-13 באוקטובר 2020, ויושבת ב-13 באוקטובר 2021. הבקשות הבאות לטעינת המודול 'מפות' ב-google.load יובילו לשגיאה, ולא תטען מפה. למידע נוסף, עיינו במדריך להעברת נתונים.

ה-SDK של מקומות ל-iOS GMSPlaceField משתמש עכשיו במאקרו NS_OPTIONS (החל מגרסה 4.0.0)

החל מ-Places SDK ל-iOS גרסה 4.0.0, GMSPlaceField משתמש עכשיו במאקרו NS_OPTIONS במקום NS_ENUM כדי לשפר את התמיכה ב-Swift. מידע נוסף על העברה ל-GMSPlaceField בתור NS_OPTIONS.

כדי להמשיך להשתמש ב-GMSPlaceField בתור NS_ENUM, צריך לציין את v3.10.0 או את הקודם ביחסי תלות.

SDK של שיטות ל-iOS:

החל מ-v3.10.0, השיטה setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner הוצאה משימוש, ובגרסה v4.0.0 היא לא נתמכת יותר. במקום זאת כדאי להשתמש ב-locationBias, או ב-locationRestriction.

השיטה initWithBounds:filter הוצאה משימוש החל מ-v3.10.0 ואי אפשר להשתמש בה ב-v4.0.0 ואילך. במקום זאת, צריך להשתמש בשדה initWithFilter: ב-GMSAutocompleteFetcher.

הגרסה המקסימלית של התמיכה בשיטות האלו שהוצאו משימוש היא v3.10.0.

לפרטים על שיטות ההחלפה, יש לעיין בנספח 1.

GMSCoordinateBounds בהשלמה האוטומטית של מקומות (גרסה 3.9.0 - גרסה 4.0.0)

החל מ-v3.9.0, חלק מהנכסים או הפרמטרים שבהם נעשה שימוש ב-GMSCoordinateBounds ב-Places SDK for iOS השלמה אוטומטית הוצאו משימוש, וב-v4.0.0 הם לא נתמכים. גרסת התמיכה המקסימלית לנכסים/פרמטרים שהוצאו משימוש היא v3.10.0.

גבולות בGMSAutocompleteViewController

המאפיינים הבאים של GMSAutocompleteViewController הוצאו משימוש:

לפונקציות מקבילות, השתמשו ב-GMSAutocompleteViewController.autocompleteFilter, עם GMSAutocompleteFilter.locationBias או עם GMSAutocompleteFilter.locationRestriction. הגרסה המינימלית של Places SDK ל-iOS עם הנכסים החלופיים האלה היא 3.8.0.

גבולות בין findAutocompletePredictionsFromQuery לבין autocompleteQuery

לפונקציות מקבילות, השתמשו ב-findAutocompletePredictionsFromQuery:filter:sessionToken:callback עם GMSAutocompleteFilter.locationBias או ב-GMSAutocompleteFilter.locationRestriction. הגרסה המינימלית של Places SDK ל-iOS עם הנכסים החלופיים האלה היא v3.8.0.

לפרטים על שיטות ההחלפה, יש לעיין בנספח 1.

שדה מקומות GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

השדה/הנכס GMSPlace.openNowStatus של מקומות ב-SDK של iOS ל-iOS הוצא משימוש החל מ-v3.0.0, וב-v4.0.0 אין תמיכה בו. הגרסה המקסימלית של תמיכה בשדה בשדה שהוצא משימוש היא v3.10.0.

במקום זאת, צריך להשתמש בפונקציות GMSPlace.isOpen או GMSPlace.isOpenAtDate. הגרסה המינימלית של SDK SDK ל-iOS עם הפונקציות החלופיות האלה היא v3.3.0.

שדה המקומות: permanently_closed (הוצא משימוש ב-26 במאי 2020)

השדה 'מקומות' permanently_closed ב-'API של מקומות Google' ובספריית מקומות Google Maps API API הוצא משימוש, ואין להשתמש בו. במקום זאת, תוכלו להשתמש ב-business_status (Places API) או ב-business_status (ספריית מקומות) כדי לקבל את הסטטוס התפעולי של העסקים. הגרסה המינימלית של ספריית מקומות, API JavaScript ב-Maps עם business_status היא v3.40.

שדות במקומות open_now, utc_offset (הוצא משימוש ב-20 בנובמבר 2019)

החל מ-20 בנובמבר 2019, השדות open_now ו-utc_offset בספריית המקומות, API JavaScript של מפות Google הוצאו משימוש.

השדות האלה הוצאו משימוש רק בספריית המקומות, ב-Maps JavaScript API

  • השדה open_now הוחלף בשדה PlaceResult.opening_hours.isOpen() ב'פרטי המקום'. עבור חיפוש בקרבת מקום וחיפוש טקסט, משתמשים בפרמטר הבקשה openNow:true כדי לסנן מקומות פתוחים כרגע. אין מאפיין מקביל ב-Find Place. כדי לקבל את הערך הזה, עליכם להגיש בקשת פרטי מקום.
  • השדה utc_offset הוחלף בשדה PlaceResult.utc_offset_minutes ב'פרטי המקום'.

למידע נוסף, קראו את המאמר העברת שדות של מקומות.

Maps JavaScript API: google.maps.event.addDomListener() ו-google.maps.event.addDomListenerOnce() (הוצא משימוש ב-7 באפריל 2022)

הפונקציות [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) ו-[google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) ב-Maps JavaScript API הוצאו משימוש ואין להשתמש בהן. במקום זאת, כדאי להשתמש בשיטה addEventListener() הרגילה.

השיטות האלה ימשיכו לפעול ואין תוכנית להוציא אותן משימוש.

הוצאו משימוש

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

Maps JavaScript API v2 (19 במאי 2010 עד 26 במאי 2021)

גרסה 2 של Maps JavaScript API לא תהיה זמינה יותר החל מ-26 במאי 2021. כתוצאה מכך, מפות v2 של האתר שלכם יפסיקו לפעול ויחזירו שגיאות JavaScript. כדי להמשיך להשתמש במפות באתר, עליכם לעבור ל-Maps JavaScript API v3. מידע נוסף על שדרוג האפליקציה של JavaScript במפות Google מגרסה 2 לגרסה 3.

שדות 'מקומות': reference, id, alt_id, scope (3 בספטמבר 2019 עד 10 באוגוסט 2020)

החל מ-10 באוגוסט 2020, השדות id, alt_id ו-scope לא יהיו זמינים יותר. השדה reference של מקומות הוצא משימוש ולא צריך להשתמש בו.

  • שדה התגובה id הוחלף בשדה התגובה place_id.
  • שדה התשובה reference הוחלף בתגובת place_id, ואין להשתמש בו.
  • אין שווי ערך לשדות alt_id ו-scope, כי הם היו בשימוש רק בשירות הוספת המקומות שהושבת ביולי 2018.

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

מערכת ההפעלה iOS גרסה 10, ARMv7 ב-32 ביט, ב-SDK של מפות Google ל-iOS 5.0

החל מ-Maps SDK ל-iOS בגרסה 5.0, אין יותר תמיכה ב-iOS 10 ובארכיטקטורת ARMv7 ב-32 ביט.

SDK של מקומות ל-iOS

בעקבות ההשקה של Places SDK ל-iOS 5.0, אפליקציית GMSCoordinateBounds הוצאה משימוש והוחלפה בגרסה GMSPlacesViewportInfo.

שכבת Fusion Tables (ניסיוני) (3 בדצמבר 2018 עד 3 בדצמבר 2019)

שכבת ה-Fusion Tables ב-Maps JavaScript API הושבתה ב-3 בדצמבר 2019, והיא לא זמינה יותר החל מגרסה 3.38 (הגרסה 3.37 היא הגרסה האחרונה שתומכת בטבלאות Fusion). מידע נוסף

ערכות SDK של מקומות ל-Android ו-iOS (29 בינואר 2019 עד 29 ביולי 2019)

החל מ-29 בינואר 2019, ערכות ה-SDK המשודרגות של מקומות ל-Android ול-iOS החליפו את הגרסאות הקיימות של ערכות ה-SDK של מקומות Google. ב-29 בינואר 2019 הוצאנו משימוש את הגרסאות הנוכחיות של מקומות ה-SDK ל-iOS, SDK SDK ל-Android ובוחר המקומות.

הוספת מקום ומחיקת מיקום (30 ביוני 2017 עד 30 ביוני 2018)

החל מ-30 ביוני 2018, התכונות 'הוספת מקום' ו'מחיקת מקום' הושבתו, והן לא זמינות יותר.

נספח 1: סיכום של ה-SDK של מקומות Google עבור החלפות API שהוצאו משימוש ב-iOS

בטבלה הבאה מוצגת שיטת ההחלפה המתאימה לכל שיטה או נכס שהוצאו משימוש.

שיטה/נכס שהוצאו משימוש שימוש במקומם
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(ב-GMSAutocompleteViewController)		 locationRestriction וגם locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(ב-GMSAutocompleteResultsViewController)		 locationRestriction וגם locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(ב-GMSAutocompleteTableDataSource)		 locationRestriction וגם locationBias
initWithBounds:filter
(ב-GMSAutocompleteFetcher)		 initWithFilter:
autocompleteBounds ו-autocompleteBoundsMode
(ב-GMSAutocompleteViewController)		 GMSAutocompleteViewController.autocompleteFilter עם locationBias או עם locationRestriction.
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback וגם autocompleteQuery:bounds:boundsMode:filter:callback
(ב-GMSPlacesClient)		 findAutocompletePredictionsFromQuery:filter:sessionToken:callback, עם locationBias או locationRestriction.

הגרסה המינימלית של Places SDK ל-iOS עם הנכסים החלופיים היא v3.8.0.