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