הוצאה משימוש

תרגום: אנושי

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

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

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

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

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

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

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

בקישורים הבאים אפשר לקרוא הנחיות לניהול יחסי תלות בין גרסאות בעזרת Maps SDK for Android, Maps SDK ל-iOS, Places SDK ל-Android ו-Places SDK עבור iOS.

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

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


google.maps.Marker ב-Maps JavaScript API (הוצא משימוש החל מפברואר 2024)

סמנים מתקדמים (google.maps.mark.AdvancedMarkerElement) טובים יותר מ-google.maps.MarkerElement כמעט בכל דרך: קלים לשימוש, בעלי ביצועים טובים יותר, נגישים יותר, עשירים יותר בתכונות, ויותר אפשרויות להתאמה אישית. הכלי google.maps.Marker ב-API JavaScript של מפות Google הוצא משימוש החל מה-3.56.

מה עליי לעשות? במקום זאת, השתמש ב-google.maps.marker.AdvancedMarkerElement. הגרסה המינימלית של Maps JavaScript API עם הכתובת google.maps.mark.AdvancedMarkerElement היא 3.53.2. בשלב זה, לא ניתן להפסיק את השימוש ב-google.maps.Marker, אבל אנחנו ממליצים להשתמש ב-google.maps.mark.AdvancedMarkerElement דרך google.maps.Marker. אמנם google.maps.Marker ימשיך לקבל תיקוני באגים ברגרסיות גדולות כלשהן, אבל באגים קיימים ב-google.maps.Marker לא יטופלו. תינתן הודעה של לפחות 12 חודשים לפני שהתמיכה תופסק.


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

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

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


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

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

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

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

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

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


עדכון של Content Security Policy (21 במרץ 2022 עד מאי 2023)

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

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


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

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


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

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


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

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


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

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

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


Places SDK לשיטות של iOS: setCompleteBoundsThroughDefaultEastCorner:NoneWestCorner, initWithBounds:filter (v3.10.0 – v4.0.0)

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

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

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

מידע על שיטות ההחלפה זמין בנספח 1.


GMSCoordinateBounds בהשלמה אוטומטית במקום (v3.9.0 - v4.0.0)

חלק מהמאפיינים או הפרמטרים שמשתמשים ב-GMSCoordinateBounds בשירות ההשלמה האוטומטית של מקומות Google ל-iOS הוצאו משימוש החל מ-v3.9.0, והם לא נתמכים בגרסה 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 (גרסה 3.0.0 - גרסה 4.0.0)

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

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


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

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


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

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

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

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

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


ה-API של JavaScript במפות: 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 (הוצא משימוש החל מגרסה 3.51.2)

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

אם אתם מעוניינים ליצור חוויה דמוית ספריית הקשר מקומית בעצמכם, מומלץ לנסות את הפתרון 'Neighbordot Discovery' ב-Quick Build או להשתמש ב-Places Library או ב-Maps JavaScript API. תוכלו להיעזר בדוגמאות קוד וב-codelabs לספריית המקומות.


SDK של מפות ל-iOS בגרסה 2.5 ומטה (ינואר 2022 עד ינואר 2023)

בינואר 2023 יצאנו משימוש ב-Maps SDK ל-iOS מגרסה 2.5 ומטה. בעקבות זאת, מערכת ההפעלה המינימלית שנתמכת על ידי Maps SDK ל-iOS ל-iOS 8 הושקה בסביבת הפיתוח המשולבת (IDE) המינימלית הנתמכת ל-Xcode 8.

מומלץ לציין ולהשתמש בגרסה האחרונה של ה-SDK של מפות Google ל-iOS.


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

גרסה 2 של Maps JavaScript API לא זמינה יותר החל מ-26 במאי 2021. כתוצאה מכך, המפות לגרסה 2 של האתר יפסיקו לפעול ויחזירו שגיאות JavaScript. על מנת להמשיך להשתמש במפות באתר שלכם, עברו ל-Maps JavaScript API v3. מידע נוסף על שדרוג אפליקציית Maps JavaScript API מגרסה 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 סיביות ב-Maps SDK ל-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 ב-JavaScript API של מפות Google הושבתה ב-3 בדצמבר 2019, והיא לא זמינה יותר החל מגרסה 3.38 (3.37 היא הגרסה האחרונה שתומכת בטבלאות Fusion). מידע נוסף


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

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


הוספת מקום ומחיקה של מקום (30 ביוני 2017 - 30 ביוני 2018)

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


שאילתות לא נתמכות של 'חיפוש מקום' ב-Places API ובספריית המקומות, Maps JavaScript API (31 במרץ 2022 - 31 במרץ 2023)

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

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

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

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

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

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

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

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

נספח 1: סיכום של Places SDK להחלפות 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.