تحقیرها

این صفحه همه محصولات و ویژگی‌های پلتفرم نقشه‌های Google را فهرست می‌کند که در حال حاضر در دوره منسوخ شدن هستند. این شامل محصولات زیر Maps، Routes و Places می‌شود.

نحوه عملکرد انحراف

دوره منسوخ برای یک محصول، ویژگی یا نسخه از تاریخ اعلام انصراف شروع می شود. محصول، ویژگی یا نسخه در طول دوره منسوخ شدن (معمولاً 12 ماه) در دسترس خواهد بود. پس از سپری شدن دوره منسوخ شدن، انتظار می رود محصول، ویژگی یا نسخه از رده خارج شود و دیگر در دسترس نخواهد بود.

صاحبان پروژه با آدرس‌های ایمیل نظارت شده، اعلان‌های فعالانه‌ای در مورد تغییراتی که بر هر یک از پروژه‌هایشان تأثیر می‌گذارد، دریافت می‌کنند. از به‌روزرسانی‌های اصلی، منسوخ شدن‌ها و سایر تغییرات مطلع باشید .

منسوخ شدن در نسخه های SDK

در SDK و Maps JavaScript API، حذف ویژگی‌ها با در دسترس بودن نسخه مرتبط است. نسخه‌های اصلی جدید تغییرات قطعی از جمله حذف ویژگی‌ها را اعلام می‌کنند و یادداشت‌های انتشار حداکثر نسخه پشتیبانی از هر ویژگی منسوخ شده را نشان می‌دهند. تا زمانی که حداکثر نسخه SDK پشتیبانی کننده آن موجود است، می توانید به استفاده از ویژگی منسوخ شده ادامه دهید. برای ارتقاء به نسخه اصلی بعدی SDK، باید استفاده از ویژگی منسوخ شده را از کد خود حذف کنید یا به جایگزین آن مهاجرت کنید.

درباره در دسترس بودن نسخه Maps JavaScript API بیشتر بیاموزید، که طبق برنامه زمانبندی انتشار و از کار انداختن سه ماهه است.

به راهنمای مدیریت وابستگی‌های نسخه با Maps SDK برای Android ، Maps SDK برای iOS ، Places SDK برای Android و Places SDK برای iOS مراجعه کنید.

محرومیت های فعال

این بخش تمام محصولات و ویژگی هایی را که در حال حاضر در دوره منسوخ شدن هستند فهرست می کند.

محدوده، مکان و شعاع در سرویس تکمیل خودکار مکان Maps JavaScript API (منسوخ شده از مه 2023)

برای سرویس تکمیل خودکار مکان در Maps JavaScript API، گزینه‌های درخواست زیر از می 2023 منسوخ شده‌اند: محدوده، مکان، و شعاع. لطفاً به جای آن از locationBias و LocationRestriction استفاده کنید.

این ویژگی به کار خود ادامه خواهد داد و 12 ماه قبل از قطع پشتیبانی اطلاع رسانی خواهد شد.

کتابخانه زمینه محلی، Maps JavaScript API (منسوخ شده از نسخه 3.51.2)

به دلیل پذیرش محدود این ویژگی بتا، کتابخانه زمینه محلی از نسخه 3.51.2 منسوخ شده است. Local Context Library در ژانویه 2024 متوقف خواهد شد. تا آن زمان، رفع اشکالات و حوادث عمده ارائه خواهد شد.

اگر علاقه مند به ساختن تجربه‌ای شبیه به کتابخانه زمینه محلی هستید، پیشنهاد می‌کنیم راه‌حل «کشف محله» را در Quick Builder بررسی کنید یا از کتابخانه مکان‌ها ، Maps JavaScript API استفاده کنید. نمونه‌های کد و کدهای کتابخانه مکان‌ها می‌توانند به شما کمک کنند.

کتابخانه سازگاری Places برای Places SDK برای Android (از 31 مارس 2022)

همه نسخه‌های کتابخانه سازگاری Places برای Places SDK برای Android از 31 مارس 2022 منسوخ شده‌اند. ما در حال توقف توسعه کتابخانه سازگاری 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 خواهد بود.

کتابخانه سازگاری Places در ژانویه 2019 معرفی شد تا انتقال از SDK قدیمی (موجود در خدمات Play) به مکان‌های SDK مستقل برای Android را تسهیل کند.

برای استفاده مستقیم از Places SDK برای Android ، راهنمای مهاجرت را دنبال کنید. برخی از کدهای وضعیت، نام روش‌ها و نام‌های کلاس تکمیل خودکار بین کتابخانه سازگاری Places و Places SDK برای Android متفاوت است. برای تعیین و حفظ وابستگی‌ها به نسخه‌های Places SDK برای Android، به مستندات نسخه‌ها مراجعه کنید.

در حال حاضر برنامه ای برای از کار انداختن کتابخانه سازگاری Places وجود ندارد. با این حال، اگر تصمیم به ادامه استفاده از نسخه‌های موجود کتابخانه سازگاری Places دارید، به محدودیت‌های پشتیبانی از نسخه‌های قدیمی یک SDK توجه کنید.

به‌روزرسانی خط‌مشی امنیت محتوا (21 مارس 2022 - مه 2023)

پشتیبانی از وب‌سایت‌هایی که از خط‌مشی امنیت محتوا (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 Maps (18 اکتبر 2021 - 31 دسامبر 2022)

خدمات بازی پلتفرم Google Maps از 18 اکتبر 2021 منسوخ شده است و در 31 دسامبر 2022 از کار افتاده است. در طول دوره منسوخ شدن، Google به ارائه پشتیبانی و رفع اشکالات و قطعی های عمده ادامه خواهد داد. برای دریافت منابعی که به شما در برنامه ریزی مراحل بعدی پروژه هایتان کمک می کند، به راهنمای انتقال خدمات بازی مراجعه کنید.

شناسه‌های مکان منسوخ شده (16 مارس 2021 - 30 مارس 2022)

در 30 مارس 2022، همه APIهای پلتفرم Google Maps پذیرش برخی از شناسه‌های مکان منسوخ را متوقف خواهند کرد. از 30 مارس 2022، هر درخواستی که با استفاده از شناسه‌های مکان منسوخ شده باشد رد می‌شود و کد خطا INVALID_REQUEST برمی‌گرداند. برای جلوگیری از تخریب تجربه کاربر، لطفاً همه شناسه‌های مکان‌هایی را که بیش از ۱۲ ماه قبل از ۳۰ مارس ۲۰۲۲ قدیمی‌تر هستند، بازخوانی کنید .

ماژول Maps در google.load (13 اکتبر 2020 - 13 اکتبر 2021)

سرویسی که ماژول "Maps" را برای google.load ارائه می دهد، از 13 اکتبر 2020 منسوخ شده است و در 13 اکتبر 2021 خاموش خواهد شد. درخواست های بعدی برای بارگیری ماژول "Maps" در google.load منجر به یک خطا، و هیچ نقشه ای بارگیری نمی شود. برای اطلاعات بیشتر به راهنمای مهاجرت مراجعه کنید.

Places 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 ، نسخه 3.10.0 یا نسخه قبلی را در وابستگی های خود مشخص کنید.

مکان‌های SDK برای روش‌های iOS: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner، initWithBounds:filter (v3.10.0 - v4.0.0)

روش setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner از نسخه 3.10.0 منسوخ شده است و در نسخه 4.0.0 و بالاتر پشتیبانی نمی شود. در عوض، از locationBias یا locationRestriction استفاده کنید.

روش initWithBounds:filter از نسخه 3.10.0 منسوخ شده است و در نسخه 4.0.0 و بالاتر پشتیبانی نمی شود. در عوض، از initWithFilter: در GMSAutocompleteFetcher استفاده کنید.

حداکثر نسخه پشتیبانی برای این روش های منسوخ شده نسخه 3.10.0 است.

برای جزئیات بیشتر در مورد روش های جایگزینی، به پیوست 1 مراجعه کنید.

GMSCoordinateBounds در مکان تکمیل خودکار (نسخه 3.9.0 - نسخه 4.0.0)

چندین ویژگی/پارامتر با استفاده از GMSCoordinateBounds در Places SDK برای سرویس تکمیل خودکار iOS، از نسخه 3.9.0 منسوخ شده اند و در نسخه 4.0.0 و بالاتر پشتیبانی نمی شوند. حداکثر نسخه پشتیبانی برای خواص/پارامترهای منسوخ شده نسخه 3.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 با این ویژگی های جایگزین نسخه 3.8.0 است.

برای جزئیات بیشتر در مورد روش های جایگزینی، به پیوست 1 مراجعه کنید.

فیلد مکان‌ها GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

فیلد/ویژگی Places GMSPlace.openNowStatus در Places SDK برای iOS از نسخه 3.0.0 منسوخ شده است و در نسخه 4.0.0 و بالاتر پشتیبانی نمی شود. حداکثر نسخه پشتیبانی برای فیلد منسوخ شده نسخه 3.10.0 است.

در عوض، از توابع GMSPlace.isOpen یا GMSPlace.isOpenAtDate استفاده کنید. حداقل نسخه Places SDK برای iOS با این توابع جایگزین نسخه 3.3.0 است.

فیلد مکان‌ها: permanently_closed (منسوخ شده در 26 مه 2020)

فیلد Places permanently_closed در Places API و Places Library، Maps JavaScript API منسوخ شده است و نباید استفاده شود. در عوض، از business_status (Places API) یا business_status (Places Library) برای دریافت وضعیت عملیاتی کسب و کارها استفاده کنید. حداقل نسخه Places Library، Maps JavaScript API با business_status نسخه 3.40 است.

فیلدهای Places open_now , utc_offset (منسوخ شده در 20 نوامبر 2019)

فیلدهای Places open_now و utc_offset در Places Library، Maps JavaScript API از 20 نوامبر 2019 منسوخ شده اند و نباید استفاده شوند.

این فیلدها فقط در کتابخانه مکان‌ها، 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 منسوخ شده است و نباید استفاده شود. در عوض، از متد استاندارد ()adEventListener استفاده کنید.

این روش ها به کار خود ادامه خواهند داد و هیچ برنامه ای برای از کار انداختن آنها وجود ندارد.

منسوخ شدن های تکمیل شده

این بخش تمام محصولات و ویژگی هایی را که از رده خارج شده اند فهرست می کند. این محصولات و ویژگی ها دیگر در دسترس نیستند.

Maps SDK برای iOS نسخه 2.5 و پایین‌تر (ژانویه 2022 - ژانویه 2023)

Maps SDK برای iOS نسخه 2.5 و نسخه‌های پایین‌تر در ژانویه 2023 از کار افتاد که حداقل سیستم عامل پشتیبانی شده توسط Maps SDK برای iOS را به iOS 8 و حداقل IDE پشتیبانی شده را به Xcode 8 افزایش داد.

ما شما را تشویق می‌کنیم که آخرین نسخه Maps SDK برای iOS را مشخص کرده و از آن استفاده کنید.

Maps JavaScript API v2 (19 مه 2010 - 26 مه 2021)

نسخه 2 از Maps JavaScript API از 26 مه 2021 دیگر در دسترس نیست. در نتیجه، نقشه های v2 سایت شما کار نمی کنند و خطاهای جاوا اسکریپت را برمی گرداند. برای ادامه استفاده از نقشه‌ها در سایت خود، به Maps JavaScript API نسخه 3 بروید. درباره ارتقای برنامه Maps JavaScript API از نسخه ۲ به نسخه ۳ بیشتر بدانید.

فیلدهای مکان: reference ، id ، alt_id ، scope (3 سپتامبر 2019 - 10 اوت 2020)

فیلدهای Places id ، alt_id و scope از 10 اوت 2020 دیگر در دسترس نیستند. reference فیلد Places منسوخ شده است و نباید استفاده شود.

  • فیلد پاسخ id با قسمت پاسخ place_id جایگزین شده است.
  • فیلد پاسخ reference با پاسخ place_id جایگزین شده است و نباید استفاده شود.
  • فیلدهای alt_id و scope معادلی ندارند، زیرا فقط برای سرویس Place Add که در ژوئیه 2018 غیرفعال شد، استفاده می‌شوند.

برای جزئیات بیشتر به مهاجرت فیلد مکان مراجعه کنید.

iOS نسخه 10، معماری 32 بیتی ARMv7 در Maps SDK برای iOS 5.0

از Maps SDK برای iOS نسخه 5.0 ، iOS 10 و معماری 32 بیتی ARMv7 دیگر پشتیبانی نمی‌شوند.

مکان‌های SDK برای iOS

با انتشار Places SDK برای iOS 5.0 ، GMSCoordinateBounds از رده خارج شد و با GMSPlacesViewportInfo جایگزین شد.

لایه جداول فیوژن (تجربی) (3 دسامبر 2018 - 3 دسامبر 2019)

لایه Fusion Tables در Maps JavaScript API در 3 دسامبر 2019 خاموش شد و از نسخه 3.38 دیگر در دسترس نیست (3.37 آخرین نسخه ای است که از جداول ترکیبی پشتیبانی می کند). بیشتر بدانید .

مکان‌های SDK برای Android و iOS (29 ژانویه 2019 - 29 ژوئیه 2019)

از 29 ژانویه 2019، کیت توسعه‌های توسعه‌یافته Places برای Android و iOS جایگزین نسخه‌های موجود کیت‌های توسعه نرم‌افزار Places شدند. نسخه‌های فعلی Places SDK برای iOS، Places SDK برای Android، و Place Picker از ۲۹ ژانویه ۲۰۱۹ منسوخ شدند و در ۲۹ ژوئیه ۲۰۱۹ خاموش شدند.

افزودن مکان و حذف مکان (30 ژوئن 2017 - 30 ژوئن 2018)

از 30 ژوئن 2018، ویژگی‌های Place Add و Place Delete غیرفعال شده‌اند و دیگر در دسترس نیستند.

جستارهای جستجوی مکان پشتیبانی نشده در Places API و Places Library، Maps JavaScript API (31 مارس 2022 - 31 مارس 2023)

عبارت‌های جستجوی مکان پشتیبانی‌نشده برای جستجوی متن، جستجوی نزدیک، و یافتن مکان در API مکان‌ها و کتابخانه مکان‌ها، Maps JavaScript API از 31 مارس 2022 منسوخ شده‌اند و از 31 مارس 2023 پاسخ‌های خطای INVALID_REQUEST را دریافت خواهند کرد.

Places API و Places Library، Maps JavaScript API از سه روش برای یافتن مکان‌ها پشتیبانی می‌کند: جستجوی متن ، جستجوی نزدیک ، و یافتن مکان . هر روش درخواست هایی را با ترکیبی از پارامترهای پشتیبانی شده می پذیرد و اکثر درخواست ها را با ترکیبی از پارامترهایی که پشتیبانی نمی شوند رد می کند.

چند ترکیب از پارامترهای پشتیبانی نشده تا به امروز به درستی رد نشده اند:

  • درخواست‌های جستجوی متن با پارامتر query خالی یا گمشده و بدون پارامتر type پشتیبانی‌شده.
  • درخواست های جستجوی متن با query=* .
  • درخواست‌های جستجوی نزدیک با keyword=* .
  • درخواست‌های جستجوی نزدیک با name=* .
  • درخواست های مکان را با input=* پیدا کنید.

این درخواست‌های جستجوی مکان پشتیبانی‌نشده باید با یکی از موارد زیر جایگزین شوند:

  • از درخواست‌های جستجوی نزدیک بدون پارامتر keyword (یا name ) می‌توان برای یافتن مؤسسات نزدیک استفاده کرد. توصیه می شود از پارامتر type با یک نوع پشتیبانی شده نیز استفاده کنید ( جدول 1: انواع مکان را ببینید). این نزدیک‌ترین تطابق را با رفتار فعلی درخواست‌های جستجوی متن با یک پارامتر query جو خالی یا گمشده فراهم می‌کند.

  • درخواست‌های API کدگذاری جغرافیایی با پارامتر latlng می‌توانند برای یافتن نزدیک‌ترین آدرس‌ها استفاده شوند. این نزدیکترین تطابق را با رفتار فعلی فراهم می کند:

    • درخواست های جستجوی متن با query=* .
    • درخواست‌های جستجوی نزدیک با keyword=* .
    • درخواست‌های جستجوی نزدیک با name=* .
    • درخواست های مکان را با input=* پیدا کنید.

پیوست 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 .

حداقل نسخه Places SDK برای iOS با ویژگی های جایگزین نسخه 3.8.0 است.