نظرة عامة على حزمة تطوير البرامج Places SDK for Android (الإصدار القديم)

استخدِم هذا الدليل للتعرّف على الاختلافات الرئيسية بين إصدارات Places SDK ونقل البيانات إلى Places SDK for Android (الإصدار الجديد).

ميزات حزمة تطوير البرامج (SDK) المتوفّرة في كل إصدار

يوضّح الجدول التالي إصدارات حزمة تطوير البرامج (SDK) وواجهة برمجة التطبيقات (API) المطلوبة لكل ميزة من ميزات حزمة تطوير البرامج (SDK):

الميزة إصدار Places API طريقة الإعداد الحد الأدنى لإصدار حزمة تطوير البرامج (SDK)
الإكمال التلقائي (جديد) ‫Places API (جديدة) initializeWithNewPlacesApiEnabled() 3.5.0
تفاصيل المكان (ميزة جديدة) ‫Places API (جديدة) initializeWithNewPlacesApiEnabled() 3.3.0
البحث في الجوار (جديد) ‫Places API (جديدة) initializeWithNewPlacesApiEnabled() 3.5.0
صور المكان (جديد) ‫Places API (جديدة) initializeWithNewPlacesApiEnabled() 3.4.0
البحث النصي (جديد) ‫Places API (جديدة) initializeWithNewPlacesApiEnabled() 3.3.0
الإكمال التلقائي للأماكن ‫Places API (الإصدار القديم) initialize() (متوقّف نهائيًا)
المكان الحالي ‫Places API (إصدار قديم) initialize() (متوقّف نهائيًا)
تفاصيل المكان ‫Places API (إصدار قديم) initialize() (متوقّف نهائيًا)
صور الأماكن ‫Places API (الإصدار القديم) initialize() (متوقّف نهائيًا)

نقل البيانات إلى واجهات برمجة التطبيقات الجديدة

لنقل البيانات إلى واجهات برمجة التطبيقات الجديدة، يُرجى الاطّلاع على أدلة نقل البيانات التالية:

تحسينات في حزمة تطوير البرامج Places SDK for Android (جديد)

يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى "حزمة تطوير برامج الأماكن لأجهزة Android" (الجديدة).

تم تنفيذه على منصة Google Cloud العادية

يتم تنفيذ "حزمة تطوير برامج الأماكن لأجهزة Android" (الإصدار الجديد) على البنية الأساسية للخدمة على Google Cloud. يؤدي هذا التنفيذ إلى توفير منصة أكثر أمانًا وموثوقية. يوفّر هذا التصميم الموحّد مستوى من الاتساق في جميع حِزم SDK، ما يحسّن كفاءة عملية التطوير باستخدام "حزمة تطوير البرامج (SDK) للأماكن في Android (الإصدار الجديد)".

تحسين الأداء

تقدّم حزمة تطوير البرامج (SDK) الجديدة الخاصة بخدمة "أماكن Google" لنظام التشغيل Android أداءً محسّنًا، ما يجعلها خيارًا أفضل من التطبيقات التي تستخدم حزمة تطوير البرامج الحالية.

الميزات الجديدة

تتضمّن حزمة Places SDK for Android (إصدار جديد) أحدث إصدارات جميع ميزات حزمة SDK:

البحث النصي (جديد)

تعرض خدمة البحث النصي (جديد) معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة، مثل "بيتزا في نيويورك" أو "محلات أحذية بالقرب من أوتاوا" أو "123 شارع مين". تستجيب الخدمة بقائمة من الأماكن التي تتطابق مع السلسلة النصية وأي تحيّز للموقع الجغرافي تم ضبطه.

إضافة بيانات استجابة جديدة إلى تفاصيل المكان (جديد) وصور الأماكن (جديد)

تمت إضافة استجابة URI جديدة إلى صور الأماكن (جديد)

يمكنك الآن استخدام صور الأماكن (جديد) لعرض معرّف URI لخريطة بتنسيق نقطي. في السابق، كان بإمكانك عرض الصورة النقطية فقط.

الأسعار المبسّطة

تم تبسيط الأسعار في "حزمة تطوير البرامج للأماكن" لنظام التشغيل Android (الإصدار الجديد) كي لا تدفع إلا مقابل البيانات التي تستخدمها. يتم تنفيذ التسعير المبسّط باستخدام قوائم الحقول، والمعروفة أيضًا باسم أقنعة الحقول.

باستخدام واجهتَي تفاصيل المكان (جديد) والبحث النصي (جديد)، يمكنك استخدام قوائم الحقول للتحكّم في قائمة الحقول التي سيتم عرضها في الردّ. بعد ذلك، يتم تحصيل الرسوم منك مقابل البيانات المطلوبة فقط. يُعدّ استخدام قائمة الحقول من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.

لمزيد من المعلومات حول الأسعار، اطّلِع على الاستخدام والفوترة.

أنواع الأماكن الموسّعة

تتضمّن حزمة SDK الجديدة أنواعًا جديدة من الأماكن يتم عرضها كجزء من استجابة تفاصيل المكان (جديد) والبحث النصي (جديد). يمكنك أيضًا استخدام هذه الأنواع الجديدة والأنواع الحالية في عملية بحث باستخدام ميزة "البحث النصي" (الجديدة). يتم تضمين الأنواع الجديدة في الجدول أ.