הוצאה משימוש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

החל מגרסה 3.49, התמיכה באתרים שמשתמשים ב-Content Security Policy (CSP) שלא מצוינת בכתובת googleapis.com ב-API של JavaScript במפות Google, תופסק התמיכה החל מגרסה 3.50. הגרסה הנתמכת האחרונה, v3.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.load יצא משימוש ב-13 באוקטובר 2020, ויושבת ב-13 באוקטובר 2021. בעקבות הבקשות הבאות לטעון את המודול 'מפות' ב-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 ל-methods של iOS: setSystemCompleteBoundsUsage NorthEastCorner:SouthWestCorner, 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.

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

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

GMSCoordinateBounds בהשלמה אוטומטית במקום (גרסה 3.9.0 - v4.0.0)

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

גבולות בGMSAutocompleteViewController

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

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

מגבלות בfindAutocompletePredictionsFromQuery ובautocompleteQuery

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

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

שדה מקומות GMSPlace.openNowStatus (גרסה 3.0.0 - v4.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)

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

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

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

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

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

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

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) ב-API של JavaScript במפות Google הוצאו משימוש ואסור להשתמש בהן. במקום זאת, צריך להשתמש בשיטה הרגילה של addEventListener().

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

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

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

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

בינואר 2023 נוציא משימוש את ה-SDK של מפות Google ל-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 סיביות ב-SDK של מפות Google ל-iOS 5.0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • בקשות של חיפוש בקרבת מקום ללא הפרמטר 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.