הוצאה משימוש

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

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

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

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

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

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

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

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

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

הוצאה משימוש

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


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

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

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


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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

כדי למנוע הפרעה לחוויית האתר, יש לציין את googleapis.com ב-CSP. כל הגרסאות של ה-API של JavaScript JavaScript שזמינות כרגע תומכות ב-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. הבקשות הבאות לטעינת המודול "מפות" ב-google.load יגרמו לשגיאה, ומפה לא תיטען. למידע נוסף, עיינו במדריך ההעברה.


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

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

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


SDK של מקומות לשיטות ל-iOS: setcompleteBoundsUsingצפוןEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)

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

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

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

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


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

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

גבולות בGMSAutocompleteViewController

הנכסים הבאים מסוג GMSAutocompleteViewController הוצאו משימוש:

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

גבולות בfindAutocompletePredictionsFromQuery ובautocompleteQuery

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

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


שדה במקומות GMSPlace.openNowStatus (גרסה 3.0.0 - 4.0.0)

השדה/נכס של 'מקומות'GMSPlace.openNowStatus ב-SDK של 'מקומות' ב-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 של 'מקומות' ובספריית 'מקומות', Maps JavaScript API הוצא משימוש ואין להשתמש בו. במקום זאת, אפשר להשתמש ב-business_status (Places API) או ב-business_status (ספריית מקומות, JavaScript API) כדי לקבל את הסטטוס התפעולי של עסקים. הגרסה המינימלית של ספריית מקומות, API JavaScript של מפות Google עם business_status היא v3.40.


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

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

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

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

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

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


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

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


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

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


נספח 1: סיכום ערכת ה-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.

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