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