استخدِم هذا الدليل للتعرّف على الاختلافات الرئيسية بين إصدارات حزمة تطوير برامج الأماكن ونقل البيانات إلى حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة).
ميزات حزمة تطوير البرامج المتوفّرة في كل إصدار
يوضّح الجدول التالي إصدارات حزمة تطوير البرامج وواجهة برمجة التطبيقات المطلوبة لكل ميزة من ميزات حزمة تطوير البرامج:
| الميزة | إصدار Places API | طريقة الإعداد | الحد الأدنى لإصدار حزمة تطوير البرامج |
|---|---|---|---|
| الإكمال التلقائي (الجديد) | 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() (متوقّفة نهائيًا) |
نقل البيانات إلى واجهات برمجة التطبيقات الجديدة
لنقل البيانات إلى واجهات برمجة التطبيقات الجديدة، يُرجى الاطّلاع على أدلة نقل البيانات التالية:
- نقل البيانات إلى تفاصيل المكان (الجديدة)
- نقل البيانات إلى صور الأماكن (الجديدة)
- نقل البيانات إلى الإكمال التلقائي (الجديد)
التحسينات في حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة)
يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة).
تم التنفيذ على منصة Google Cloud العادية
تم تنفيذ حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) على البنية الأساسية للخدمة على Google Cloud. ويوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية. يوفّر هذا التصميم العادي مستوى من الاتساق بين حِزم تطوير البرامج، ما يحسّن كفاءة التطوير باستخدام حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة).
تحسين الأداء
توفّر حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) أداءً محسّنًا، ما يجعل من المفيد استبدال التطبيقات التي تستخدم حزمة تطوير البرامج الحالية.
الميزات الجديدة
تتضمّن حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) أحدث إصدارات جميع ميزات حزمة تطوير البرامج:
- الإكمال التلقائي (الجديد)
- تفاصيل المكان (الجديدة)
- البحث في الجوار (الجديد)
- صور الأماكن (الجديدة)
- البحث النصي (الجديد)
البحث النصي (الجديد)
تعرض ميزة "البحث النصي (الجديدة)" معلومات عن مجموعة من الأماكن استنادًا إلى سلسلة، مثل "بيتزا في نيويورك" أو "متاجر أحذية بالقرب من أوتاوا" أو "123 شارع مين". تردّ الخدمة بقائمة من الأماكن التي تطابق السلسلة النصية وأي تحيّز للموقع الجغرافي تم ضبطه.
تمت إضافة بيانات ردّ جديدة إلى "تفاصيل المكان (الجديدة)" و"صور الأماكن (الجديدة)"
تفاصيل المكان (الجديدة) تتضمّن الآن فئة مراجعة الجديدة في الردّ على عنصر
Place. تحتوي فئة المكان على طريقةgetReviews()الجديدة لدعم هذا الحقل. يمكنك طلبgetReviews()لعرض ما يصل إلى خمس مراجعات لمكان معيّن.صور الأماكن (الجديدة) تضيف
AuthorAttributionsإلى فئةPhotoMetadata.AuthorAttributionsيحتوي علىListمنAuthorAttributionعناصر.
تمت إضافة ردّ جديد على URI إلى "صور الأماكن (الجديدة)"
يمكنك الآن استخدام ميزة "صور الأماكن (الجديدة)" لعرض URI لصورة نقطية. في السابق، كان بإمكانك عرض الصورة النقطية فقط.
الأسعار المبسّطة
تم تبسيط الأسعار باستخدام حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) بحيث لا تدفع إلا مقابل البيانات التي تستخدمها. يتم تطبيق الأسعار المبسّطة باستخدام قوائم الحقول، التي تُعرف أيضًا باسم أقنعة الحقول.
باستخدام ميزتَي "تفاصيل المكان (الجديدة)" و"البحث النصي (الجديدة)"، يمكنك استخدام قوائم الحقول للتحكّم في قائمة الحقول التي سيتم عرضها في الردّ. بعد ذلك، لن يتم تحصيل رسوم منك إلا مقابل البيانات المطلوبة. إنّ استخدام قائمة الحقول هو ممارسة تصميم جيدة لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة ورسوم الفوترة غير الضرورية.
لمزيد من المعلومات حول الأسعار، يُرجى الاطّلاع على مقالة الاستخدام وال فوترة.
أنواع الأماكن الموسّعة
تتضمّن حزمة تطوير البرامج الجديدة أنواعًا جديدة من الأماكن، يتم عرضها كجزء من الردّ على ميزتَي "تفاصيل المكان (الجديدة)" و"البحث النصي (الجديدة)". يمكنك أيضًا استخدام هذه الأنواع الجديدة والأنواع الحالية في عملية بحث باستخدام ميزة "البحث النصي (الجديدة)". تم تضمين الأنواع الجديدة في الجدول أ.