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