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