تعرض هذه الصفحة جميع منتجات "منصة خرائط Google" وميزاتها التي لا تزال في فترة الإيقاف النهائي. وهذا يشمل المنتجات ضمن "الخرائط" و"المسارات" و"الأماكن".
آلية عمل الإيقاف النهائي
تبدأ فترة الإيقاف النهائي لمنتج أو ميزة أو إصدار من تاريخ الإعلان عن الإيقاف النهائي. سيظل المنتج أو الميزة أو الإصدار متوفرًا طوال فترة الإيقاف (عادةً 12 شهرًا). بعد انقضاء فترة الإيقاف النهائي، من المتوقع أن يتم إيقاف المنتج أو الميزة أو الإصدار ولن تكون متاحة مرة أخرى.
يتلقى مالكو المشروعات الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية حول التغييرات التي تؤثر على كل مشروع من مشروعاتهم. يمكنك الاطّلاع على آخر المعلومات حول التحديثات الرئيسية وعمليات الإيقاف النهائي والتغييرات الأخرى.
إيقاف الإصدار في إصدارات حزمة تطوير البرامج (SDK)
في حِزم تطوير البرامج (SDK) و"خرائط JavaScript API"، يرتبط الإيقاف النهائي للميزات بمدى توفّر الإصدار. تشير الإصدارات الرئيسية الجديدة إلى حدوث تغييرات قد تؤدي إلى أعطال، بما في ذلك الإيقاف النهائي للميزات وملاحظات الإصدار، وتشير إلى الحد الأقصى للإصدار المتوافق مع كل ميزة تم إيقافها. يمكنك مواصلة استخدام الميزة التي تم إيقافها نهائيًا ما دام الحد الأقصى المتاح من إصدار حزمة تطوير البرامج (SDK) متوافقًا. للترقية إلى الإصدار الرئيسي التالي من حزمة SDK، يجب إزالة استخدام الميزة المتوقّفة نهائيًا من الرمز أو الانتقال إلى بديلها.
تعرَّف على المزيد من المعلومات عن مدى توفّر إصدار واجهة برمجة تطبيقات JavaScript للخرائط، الذي يتبع جدولاً ربعيًا للإصدار والإيقاف.
اطّلع على إرشادات حول إدارة العناصر الاعتمادية للإصدارات من خلال حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android وحزمة تطوير برامج "خرائط Google" لنظام التشغيل iOS وحزمة تطوير برامج الأماكن لنظام التشغيل Android وحزمة تطوير برامج الأماكن لأجهزة iOS.
عمليات الإيقاف النهائي النشطة
يعرض هذا القسم جميع المنتجات والميزات التي لا تزال حاليًا في فترة الإيقاف النهائي.
الحدود الجغرافية والموقع الجغرافي والنطاق الجغرافي في "خدمة الإكمال التلقائي لأماكن" لواجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (تم إيقافها اعتبارًا من أيار/مايو 2023)
بالنسبة إلى "خدمة الإكمال التلقائي" الخاصة بـ "المكان" في واجهة برمجة التطبيقات JavaScript JavaScript، سيتم إيقاف خيارات الطلب التالية نهائيًا اعتبارًا من أيار (مايو) 2023: الحدود والموقع الجغرافي والنطاق الجغرافي. يُرجى استخدام locationBias وlocationRestriction بدلاً من ذلك.
سيستمر عمل الميزة، وسيتم إرسال إشعار قبل 12 شهرًا من إيقاف الدعم.
مكتبة السياق المحلية، وواجهة برمجة تطبيقات JavaScript للخرائط (تم إيقاف العمل بها بدءًا من الإصدار 3.51.2)
نظرًا للاعتماد المحدود لهذه الميزة التجريبية، تم إيقاف مكتبة السياقات المحلية نهائيًا بدءًا من الإصدار 3.51.2. سيتم إيقاف "مكتبة السياقات المحلية" في كانون الثاني (يناير) 2024. وحتى ذلك الحين، سيتم تقديم إصلاحات للأخطاء والحوادث الرئيسية.
إذا كنت مهتمًا بإنشاء تجربة شبيهة بمكتبة السياقات المحلية بنفسك، نقترح عليك الاطّلاع على حل "استكشاف المناطق المجاورة" في Quick Builder أو استخدام مكتبة الأماكن أو واجهة برمجة تطبيقات JavaScript للخرائط. يمكنك الاستفادة من نماذج التعليمات البرمجية والدروس التطبيقية حول الترميز لمكتبة الأماكن.
مكتبة توافق الأماكن مع حزمة تطوير البرامج (SDK) الخاصة بالأماكن على أجهزة Android (اعتبارًا من 31 آذار (مارس) 2022)
اعتبارًا من 31 آذار (مارس) 2022، تم إيقاف جميع إصدارات مكتبة توافق "الأماكن" في حزمة تطوير البرامج (SDK) الخاصة بالأماكن على أجهزة Android. نحن بصدد إيقاف تطوير مكتبة توافق الأماكن
على الإصدار 2.6.0 من "حزمة SDK للأماكن" لنظام التشغيل Android (المحددة في
الملحقات مثل com.google.android.libraries.places:places-compat:2.6.0
).
لن يتم إصدار أي إصدارات جديدة من هذه المكتبة بعد هذا التاريخ. الطريقة الوحيدة للوصول إلى الميزات وإصلاحات الأخطاء في حزمة SDK للأماكن لنظام التشغيل Android أعلى الإصدار 2.6.0 هي استخدام حزمة تطوير برامج الأماكن لنظام التشغيل Android.
تم إطلاق مكتبة توافق الأماكن في كانون الثاني (يناير) 2019 لتسهيل النقل من حزمة SDK القديمة (المتاحة في خدمات Play) إلى حزمة SDK المستقلة للأماكن لنظام التشغيل Android.
اتبع دليل النقل لاستخدام حزمة تطوير برامج الأماكن لنظام التشغيل Android مباشرةً. تختلف بعض رموز الحالة وأسماء الطرق وأسماء صفوف الإكمال التلقائي بين مكتبة التوافق في "الأماكن" وحزمة تطوير برامج الأماكن لنظام التشغيل Android. راجع وثائق الإصدارات لتحديد التبعيات والحفاظ عليها في إصدارات حزمة SDK للأماكن لنظام التشغيل Android.
ليست هناك خطة لإيقاف مكتبة التوافق مع "الأماكن" في الوقت الحالي. ومع ذلك، إذا اخترت مواصلة استخدام الإصدارات المتاحة من مكتبة التوافق مع "الأماكن"، فلاحظ القيود المفروضة على دعم الإصدارات القديمة من SDK.
طلبات البحث عن الأماكن غير المتوافقة في واجهة برمجة تطبيقات الأماكن ومكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط (31 آذار (مارس) 2022 حتى 31 آذار (مارس) 2023)
إنّ طلبات البحث عن الأماكن غير المتوافقة مع "البحث النصي" و"البحث عن الأماكن" و"العثور على المكان"
في واجهة برمجة تطبيقات الأماكن ومكتبة الأماكن، تم إيقاف واجهة برمجة تطبيقات JavaScript لتطبيق "خرائط Google"
اعتبارًا من 31 آذار (مارس) 2022، وسيتلقّى INVALID_REQUEST
ردودًا على الخطأ بدءًا من 31 آذار (مارس) 2023.
تتيح Places API وPlaces Library (مكتبة الأماكن) و"خرائط JavaScript API" ثلاث طرق للعثور على الأماكن: Text Search والبحث عن الأماكن المجاورة وFind المكان. وتقبل كل طريقة الطلبات التي تشتمل على مجموعات مسموح بها من المعلَمات، وترفض معظم الطلبات التي تتضمن مجموعات من المعلَمات غير المتاحة.
لم يتم رفض بعض مجموعات المعلمات غير المتوافقة بشكل صحيح حتى الآن:
- هي طلبات "البحث النصي" التي تتضمن معلَمة
query
فارغة أو غير متوفّرة وبدون مَعلمةtype
متوافقة. - طلبات البحث النصي باستخدام
query=*
. - طلبات البحث عن قرب مع
keyword=*
- طلبات البحث عن قرب مع
name=*
- العثور على طلبات الأماكن باستخدام
input=*
.
يجب استبدال طلبات "البحث عن الأماكن" غير المتوافقة هذه بإحدى ما يلي:
يمكن استخدام طلبات البحث عن قرب بدون المعلمة
keyword
(أوname
) للعثور على المؤسسات القريبة. ننصحك أيضًا باستخدام المَعلمةtype
مع نوع واحد متوافق (راجِع الجدول 1: أنواع الأماكن). يوفّر ذلك أقرب مطابقة للسلوك الحالي لطلبات "البحث النصي" التي تتضمن معلَمةquery
فارغة أو ناقصة.يمكن استخدام طلبات Geocode API التي تتضمّن المعلَمة
latlng
للعثور على أقرب العناوين. ويوفّر ذلك أقرب ما يكون إلى السلوك الحالي لـ:- طلبات البحث النصي باستخدام
query=*
. - طلبات البحث عن قرب مع
keyword=*
- طلبات البحث عن قرب مع
name=*
- العثور على طلبات الأماكن باستخدام
input=*
.
- طلبات البحث النصي باستخدام
تعديل على سياسة أمان المحتوى (21 آذار (مارس) 2022 - مايو 2023)
بالنسبة إلى المواقع الإلكترونية التي تستخدم سياسة أمان المحتوى (CSP) والتي لا تحدِّد googleapis.com في واجهة برمجة تطبيقات JavaScript للخرائط تم إيقافه نهائيًا اعتبارًا من الإصدار 3.49، ولن يكون متاحًا بدءًا من الإصدار 3.50. وسيتم إيقاف الإصدار الأخير الداعم، وهو الإصدار 3.49، في الربع الثاني من عام 2023، وبعد ذلك سترفض واجهة برمجة تطبيقات JavaScript لتطبيق "خرائط Google" جميع الطلبات التي تستخدم توجيهات 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، ستتوقف جميع واجهات برمجة التطبيقات في "منصة خرائط Google" عن قبول بعض أرقام تعريف الأماكن القديمة.
اعتبارًا من 30 آذار (مارس) 2022، سيتم رفض أي طلبات يتم تقديمها باستخدام معرّفات أماكن قديمة، وسيتم عرض رمز الخطأ INVALID_REQUEST
.
لتجنُّب تدهور تجربة المستخدم، يُرجى
إعادة تحميل جميع
أرقام تعريف الأماكن التي مرّ عليها أكثر من 12 شهرًا قبل 30 آذار (مارس) 2022.
وحدة "خرائط Google" في google.load (من 13 تشرين الأول (أكتوبر) 2020 إلى 13 تشرين الأول (أكتوبر) 2021)
تم إيقاف الخدمة التي توفّر وحدة "الخرائط" لخدمة google.load
اعتبارًا من 13 تشرين الأول (أكتوبر) 2020، وسيتم إيقافها
في 13 تشرين الأول (أكتوبر) 2021. وستؤدي الطلبات اللاحقة لتحميل وحدة "الخرائط" في google.load
إلى حدوث خطأ، ولن يتم تحميل أي خريطة. يُرجى الاطّلاع على
دليل نقل البيانات للحصول على
مزيد من المعلومات.
تستخدم حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS
GMSPlaceField
الآن وحدة الماكرو NS_OPTIONS
(اعتبارًا من الإصدار 4.0.0)
بدءًا من حزمة تطوير برامج الأماكن لنظام التشغيل iOS
الإصدار 4.0.0،
يستخدم GMSPlaceField
الآن وحدة الماكرو NS_OPTIONS
بدلاً من
NS_ENUM
للحصول على دعم أفضل لتطبيق Swift. يمكنك الاطّلاع على مزيد من المعلومات عن نقل البيانات إلى GMSPlaceField باسم NS_OPTIONS.
لمواصلة استخدام GMSPlaceField
كـ NS_ENUM
، يجب تحديد الإصدار 3.10.0 أو إصدار أقدم في العناصر التابعة لك.
حزمة تطوير برامج الأماكن لطرق نظام التشغيل iOS: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (الإصدار 3.10.0 - 4.0.0)
تم إيقاف طريقة المساعدة setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
نهائيًا اعتبارًا من الإصدار 3.10.0، وهي غير متاحة في الإصدار 4.0.0 والإصدارات الأحدث.
بدلاً من ذلك، استخدِم locationBias
أو locationRestriction
.
تم إيقاف الطريقة initWithBounds:filter
نهائيًا اعتبارًا من الإصدار 3.10.0، وهي غير متاحة في الإصدار 4.0.0 والإصدارات الأحدث.
بدلاً من ذلك، يمكنك استخدام initWithFilter:
في GMSAutocompleteFetcher
.
أقصى إصدار متوافق مع هذه الطرق التي تم إيقافها هو v3.10.0.
للحصول على تفاصيل حول طرق الاستبدال، يُرجى الاطّلاع على الملحق 1.
GMSCoordinateBounds
في الإكمال التلقائي لمكان (الإصدار 3.9.0 - الإصدار 4.0.0)
تم إيقاف العديد من الخصائص/المعلَمات التي تستخدم GMSCoordinateBounds
في "حزمة تطوير البرامج (SDK) للأماكن الخاصة" بخدمة الإكمال التلقائي لنظام التشغيل iOS اعتبارًا من
الإصدار 3.9.0،
وهي غير متاحة في
الإصدار 4.0.0 والإصدارات الأحدث. الحد الأقصى للإصدار المتوافق مع الخصائص/المَعلمات التي تم إيقافها نهائيًا هو v3.10.0.
حدود بعملة GMSAutocompleteViewController
تم إيقاف سمات GMSAutocompleteViewController
التالية نهائيًا:
GMSAutocompleteViewController.autocompleteBounds
GMSAutocompleteViewController.autocompleteBoundsMode
للحصول على وظائف مكافئة، يمكنك استخدام GMSAutocompleteViewController.autocompleteFilter
مع GMSAutocompleteFilter.locationBias
أو GMSAutocompleteFilter.locationRestriction
.
الإصدار الأدنى من حزمة تطوير برامج الأماكن لنظام التشغيل iOS هو الإصدار 3.8.0.
حدود في findAutocompletePredictionsFromQuery
وautocompleteQuery
- المَعلمتان
bounds
وboundsMode
لما يلي:
للحصول على وظائف مكافئة، استخدِم findAutocompletePredictionsFromQuery:filter:sessionToken:callback
مع GMSAutocompleteFilter.locationBias
أو GMSAutocompleteFilter.locationRestriction
.
الإصدار الأدنى من حزمة تطوير برامج الأماكن لنظام التشغيل iOS هو الإصدار 3.8.0.
للحصول على تفاصيل حول طرق الاستبدال، يُرجى الاطّلاع على الملحق 1.
حقل الأماكن GMSPlace.openNowStatus
(الإصدار 3.0.0 - الإصدار 4.0.0)
تم إيقاف حقل/موقع الأماكن GMSPlace.openNowStatus
في حزمة تطوير البرامج للأماكن لنظام التشغيل iOS اعتبارًا من
الإصدار 3.0.0،
وهو غير متاح في
الإصدار 4.0.0
والإصدارات الأحدث.
الحد الأقصى للإصدار المتوافق مع الحقل الذي تم إيقافه هو v3.10.0.
بدلاً من ذلك، استخدِم الدالتَين GMSPlace.isOpen
أو
GMSPlace.isOpenAtDate
.
الإصدار الأدنى من حزمة تطوير برامج الأماكن لنظام التشغيل iOS هو الإصدار 3.3.0.
حقل الأماكن: permanently_closed
(تم إيقاف العمل به في 26 أيار (مايو) 2020)
حقل الأماكن permanently_closed
في واجهة برمجة تطبيقات الأماكن ومكتبة الأماكن
وواجهة برمجة تطبيقات JavaScript للخرائط تم إيقافه نهائيًا، ويجب عدم استخدامه.
بدلاً من ذلك، استخدِم
business_status
(واجهة برمجة تطبيقات الأماكن) أو
business_status
(مكتبة الأماكن)
للاطّلاع على الحالة التشغيلية للأنشطة التجارية. الحد الأدنى لإصدار
مكتبة الأماكن، وواجهة برمجة تطبيقات JavaScript للخرائط مع business_status
هو
الإصدار 3.40.
حقول الأماكن open_now
وutc_offset
(تم إيقاف العمل بها في 20 تشرين الثاني (نوفمبر) 2019)
تم إيقاف حقلَي "الأماكن" open_now
وutc_offset
في "مكتبة الأماكن" و"واجهة برمجة تطبيقات JavaScript للخرائط" نهائيًا اعتبارًا من 20 تشرين الثاني (نوفمبر) 2019، وبالتالي يجب عدم
استخدامهما.
يتم إيقاف هذه الحقول نهائيًا في "مكتبة الأماكن" وواجهة برمجة تطبيقات JavaScript للخرائط فقط.
- تم استبدال الحقل
open_now
بحقلPlaceResult.opening_hours.isOpen()
في "تفاصيل المكان". بالنسبة إلى البحث عن الأماكن القريبة والبحث النصي، يمكنك استخدام معلمة الطلبopenNow:true
لتصفية الأماكن المفتوحة حاليًا. لا يتم توفير مكافئ لـ "البحث عن المكان". للحصول على هذه القيمة، يجب عليك الآن تقديم طلب تفاصيل المكان. - تم استبدال الحقل
utc_offset
بحقلPlaceResult.utc_offset_minutes
في "تفاصيل المكان".
راجع نقل حقول الأماكن لمعرفة المزيد.
واجهة برمجة التطبيقات JavaScript 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)
في واجهة برمجة تطبيقات JavaScript للخرائط نهائيًا، وبالتالي يجب عدم استخدامهما. بدلاً من ذلك، استخدِم الطريقة العادية addEvent Listener().
تجدر الإشارة إلى أنّ هاتَين الطريقتَين سيواصلتان العمل ولا توجد خطة لإيقافهما.
عمليات الإيقاف النهائي المكتملة
يعرض هذا القسم كل المنتجات والميزات التي تم إيقافها نهائيًا. لم تعد هذه المنتجات والميزات متوفّرة.
الإصدار الثاني من واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (من 19 أيار (مايو) 2010 إلى 26 أيار (مايو) 2021)
لم يعُد الإصدار 2 من Maps JavaScript API متاحًا اعتبارًا من 26 أيار (مايو) 2021. ونتيجةً لذلك، ستتوقف خرائط الإصدار 2 على موقعك الإلكتروني عن العمل وتعرض أخطاء JavaScript. لمواصلة استخدام الخرائط على موقعك الإلكتروني، عليك الانتقال إلى إصدار Maps JavaScript API v3. مزيد من المعلومات حول ترقية تطبيق JavaScript JavaScript API من الإصدار 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.
راجع نقل حقل المكان للحصول على التفاصيل.
الإصدار 10 من نظام التشغيل iOS، بنية ARMv7 32 بت في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS 5.0
اعتبارًا من الإصدار 5.0 من حزمة "خرائط Google" لنظام التشغيل iOS، لن يصبح نظام التشغيل iOS 10 وبنية ARMv7 32 بت متوافقًا.
حزمة تطوير برامج الأماكن لأجهزة iOS
مع إطلاق
حزمة تطوير برامج الأماكن لنظام التشغيل iOS 5.0،
تم إيقاف تطبيق GMSCoordinateBounds
واستبداله بـ GMSPlacesViewportInfo
.
طبقة Fusion Tables (تجريبية) (3 كانون الأول (ديسمبر) 2018 - 3 كانون الأول (ديسمبر) 2019)
تم إيقاف طبقة Fusion Tables في واجهة برمجة تطبيقات JavaScript للخرائط في 3 كانون الأول (ديسمبر) 2019، ولم تعد متاحة اعتبارًا من الإصدار 3.38 (3.37 هو الإصدار الأخير المتوافق مع الجداول المختلطة). مزيد من المعلومات
حزم تطوير برامج الأماكن لأجهزة Android وiOS (29 كانون الثاني (يناير) 2019 - 29 تموز (يوليو) 2019)
اعتبارًا من 29 كانون الثاني (يناير) 2019، استبدلت حزم SDK التي تمت ترقيتها بحزمة تطوير برامج الأماكن لأجهزة Android وiOS الإصدارات الحالية من حزم SDK للأماكن. تجدر الإشارة إلى أنّه قد تمّ إيقاف الإصدارات الحالية من حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل iOS وحزمة تطوير برامج الأماكن لأجهزة Android وأداة اختيار المكان اعتبارًا من 29 كانون الثاني (يناير) 2019، وتم إيقاف هذه الإصدارات في 29 تموز (يوليو) 2019.
- التحديث إلى أحدث إصدار من حزمة تطوير برامج الأماكن لنظام التشغيل iOS.
- التحديث إلى أحدث إصدار من حزمة تطوير برامج الأماكن لنظام التشغيل Android.
- لم تعُد "أداة اختيار المكان" متاحة اعتبارًا من 29 تموز (يوليو) 2019.
إضافة مكان وحذف المكان (30 يونيو 2017 - 30 يونيو 2018)
اعتبارًا من 30 حزيران (يونيو) 2018، تم إيقاف ميزتَي "إضافة مكان" و"حذف المكان"، ولم تعدا متاحتَين.
الملحق 1: ملخص لحزمة تطوير برامج الأماكن (SDK) لعمليات الاستبدال من واجهة برمجة التطبيقات المتوقّفة في نظام التشغيل iOS
يوضح الجدول التالي طريقة الاستبدال المطلوب استخدامها لكل طريقة أو خاصية تم إيقافها.
الإصدار الأدنى من حزمة تطوير برامج الأماكن لنظام التشغيل iOS هو الإصدار 3.8.0.