مرجع سريع لواجهة Places API (القديمة)

اعتبارًا من أكتوبر 2026، لن يعود بإمكانك تفعيل Places API (الإصدار القديم) لمشاريع Google Cloud الجديدة. وستظل المشاريع الحالية متاحة بالكامل. للاستفادة من الميزات الجديدة والأداء المحسّن، يمكنك نقل البيانات إلى Places API (الإصدار الجديد).

‫Places API (القديمة): حقائق رئيسية

  • المنتج: Places API (الإصدار القديم)
  • تُعرف أيضًا باسم: Places API (خدمة ويب قديمة)، وخدمة ويب Places API ‏(maps/api/place)
  • الفئة: الأماكن
  • المنصة: خدمة ويب (REST)
  • يتم تشغيله على: الخادم (رمز الخلفية)
  • مرحلة الإطلاق: GA
  • دورة الحياة: قديمة
  • تم استبدالها بـ: Places API (جديدة)
  • نظرة عامة: نظرة عامة على Places API (الإصدار القديم)

‫Places API (القديمة): حالات الاستخدام

استخدِم Places API (الإصدار القديم) في الحالات التالية:

  • إذا كنت تدير مشروعًا حاليًا تم فيه تفعيل Places API (الإصدار القديم) ويطلب نقاط نهاية maps.googleapis.com/maps/api/place.
  • يجب أن تكون لديك طلبات حالية من ميزات "العثور على مكان" أو "بحث في الجوار" أو "البحث النصي" أو "التفاصيل" أو "الصور" أو "الإكمال التلقائي" (الإصدار القديم) لمواصلة العمل أثناء نقل البيانات.

لا تستخدم Places API (الإصدار القديم) في الحالات التالية:

  • أنت على وشك بدء مشروع جديد على Google Cloud. اعتبارًا من أكتوبر 2026، لن يكون من الممكن تفعيل Places API (الإصدار القديم) للمشاريع الجديدة. استخدِم Places API (جديدة) بدلاً من ذلك.
  • تحتاج إلى ميزات جديدة أو مصادقة OAuth أو أقنعة حقول في ميزتَي "البحث في الجوار" و"البحث النصي" لكي تدفع فقط مقابل الحقول التي تطلبها. استخدِم Places API (جديدة) بدلاً من ذلك.
  • تحتاج إلى استخدام Find Place (Legacy) أو Query Autocomplete (Legacy) في الرمز البرمجي الجديد. ويحلّ محلّهما "البحث النصي (الجديد)" و"الإكمال التلقائي (الجديد)". استخدِم Places API (جديدة) بدلاً من ذلك.

‫Places API (القديمة): الإعداد

‫Places API (الإصدار القديم): الأخطاء الشائعة

  • المشكلة: إذا لم يتضمّن طلب تفاصيل المكان (قديم) المَعلمة fields أو لم يحدّد أي حقول، ستعرض واجهة برمجة التطبيقات جميع الحقول وتحصّل منك رسومًا مقابلها كلها. الحلّ: اضبط دائمًا المَعلمة fields أو انتقِل إلى تفاصيل المكان (جديد) باستخدام قناع حقل. يُرجى الاطّلاع على /maps/documentation/places/web-service/legacy/details.
  • المشكلة: لا تتيح ميزتا "البحث في الجوار (الإصدار القديم)" و"البحث النصي (الإصدار القديم)" تحديد الحقول المطلوب عرضها. وتعرض دائمًا مجموعة ثابتة من الحقول (مجموعة فرعية من حقول "تفاصيل المكان") وتفعّل رموز التخزين التعريفية لكلّ من "البيانات الأساسية" و"بيانات الاتصال" و"بيانات الأجواء". الحلّ: يمكنك نقل البيانات إلى بحث في الجوار (جديد) أو البحث النصي (جديد) باستخدام قناع حقل، أو استخدام العثور على مكان (قديم) مع المَعلمة fields لطلب الحقول التي تحتاج إليها فقط والدفع مقابلها. يُرجى الاطّلاع على /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku.
  • المشكلة: لا يمكن تخزين photo_reference مؤقتًا ويمكن أن تنتهي صلاحيته، وبالتالي تتوقف المراجع المخزَّنة عن العمل. الحلّ: احصل على photo_reference جديد من ردّ "تفاصيل المكان" أو "العثور على مكان" أو "بحث في الجوار" أو "البحث النصي" قبل طلب صورة. يُرجى الاطّلاع على /maps/documentation/places/web-service/legacy/photos.
  • المشكلة: الطلبات الموجَّهة إلى Places API (الإصدار القديم) من مشروع لم يتم تفعيلها فيه تعرض الرمز REQUEST_DENIED مع رسالة الخطأ "أنت تطلب واجهة برمجة تطبيقات قديمة لم يتم تفعيلها لمشروعك..." (LegacyApiNotActivatedMapError). اعتبارًا من أكتوبر 2026، لن يكون من الممكن تفعيل Places API (الإصدار القديم) للمشاريع الجديدة. الحلّ: استخدِم Places API (الإصدار الجديد) للمشاريع الجديدة وانقل التطبيقات الحالية. أثناء عملية نقل البيانات، يمكنك طلب تفعيل واجهة برمجة التطبيقات القديمة لفترة قصيرة من خلال نموذج استطلاع الآراء والتقييم في الصفحة القديمة. يُرجى الاطّلاع على /maps/legacy#LegacyApiNotActivatedMapError.

‫Places API (الإصدار القديم): الميزات القديمة والمتوقّفة نهائيًا

  • حقل الاستجابة permanently_closed: تم إيقافه نهائيًا منذ ‎26-05-2020. البديل: حقل business_status يُرجى الاطّلاع على دليل نقل البيانات.
  • حقل الاستجابة reference: تم إيقافه نهائيًا منذ 3 أيلول (سبتمبر) 2019. البديل: حقل place_id يُرجى الاطّلاع على دليل نقل البيانات.
  • مَعلمة طلب البحث في الجوار (الإصدار القديم) name: تم إيقافها نهائيًا. البديل: المَعلمة keyword يُرجى الاطّلاع على دليل نقل البيانات.