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