הוצאה משימוש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

החל מגרסה 3.49, התמיכה באתרים שמשתמשים ב-Content Security Policy (CSP) שלא צוינה בהם googleapis.com ב- Maps JavaScript API, תופסק החל מגרסה 3.50. ברבעון השני של שנת 2023 תוצא משימוש הגרסה האחרונה לתמיכה, גרסה 3.49, ולאחר מכן יידחה כל הבקשות שמבוססות על הנחיות 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 ל-iOS: setcompleteBoundsUsage 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, והיא לא נתמכת בגרסה 4.0.0 ואילך. במקום זאת, צריך להשתמש ב-initWithFilter: ב-GMSAutocompleteFetcher.

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

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

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

יש כמה מאפיינים/פרמטרים המשתמשים ב-GMSCoordinateBounds ב- Places SDK לשירות ההשלמה האוטומטית ב-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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

צריך להחליף את הבקשות הלא נתמכות האלה ב-Place Search באחת מהבקשות הבאות:

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