اختيار إصدار حزمة تطوير البرامج (SDK)

إنّ ميزات حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Places المتوفّرة في تطبيقك تُحدَّد حسب مجموعة من رقم إصدار حزمة SDK (مثل 3.5.0) الذي تحديده في إعدادات تطبيقك، وواجهات برمجة التطبيقات المفعَّلة في مفتاح واجهة برمجة التطبيقات، وطريقة بدء تشغيل تطبيقك. يوضّح هذا الدليل الاختلافات بين الإصدارات وكيفية اختيار الإصدارات المفعَّلة في تطبيقك.

أرقام إصدارات حزمة تطوير البرامج (SDK)

يحدّد رقم إصدار حزمة SDK الذي تحدّده في ملف build.gradle على مستوى التطبيق ما إذا كان بإمكان تطبيقك الوصول إلى الميزات التي تمت إضافتها في إصدار معين. على سبيل المثال، لا تتوفّر ميزة "الإكمال التلقائي (جديد)" إلا في الإصدار 3.5.0 من حزمة SDK أو الإصدارات الأحدث.

لمزيد من المعلومات عن التغييرات التي تمّ إدخالها في كل إصدار من حزمة SDK، يُرجى الاطّلاع على ملاحظات إصدار حزمة SDK لنظام التشغيل Android لتطبيق "الأماكن".

إصدارات Places API لحزمة تطوير البرامج (SDK) للأماكن لنظام Android

بالإضافة إلى تحديد رقم إصدار حزمة SDK، عليك أيضًا اختيار خدمة واجهة برمجة التطبيقات في Places التي تستدعيها حزمة SDK في Google Cloud Console: إما Places API أو Places API (الإصدار الجديد). بالإضافة إلى رقم إصدار حزمة SDK، تحدّد خدمة واجهة برمجة التطبيقات التي تختارها الإصدار المتاح من ميزات معيّنة في تطبيقك، مثل ميزة "الإكمال التلقائي" أو "الإكمال التلقائي (جديد)". على الرغم من أنّه يمكنك تحديد رقم إصدار واحد فقط من حزمة SDK، يمكنك تفعيل كلّ من Places API وPlaces API (الإصدار الجديد) في مفتاح واجهة برمجة التطبيقات في الوقت نفسه، ثم اختيار الخدمة التي تستدعيها حزمة SDK من خلال الطريقة التي تستخدمها لإعداد حزمة SDK في تطبيقك. ومع ذلك، في معظم الحالات، ستحتاج إلى تفعيل Places API (الإصدار الجديد) واستخدام الإصدارات (الجديدة) من ميزات حزمة SDK في تطبيقك.

اختيار إصدار حزمة تطوير البرامج (SDK) وخدمات واجهة برمجة التطبيقات

لاختيار ميزات حزمة SDK المتوفّرة في تطبيقك، اتّبِع الخطوات التالية:

  1. في مشروعك على Google Cloud، فعِّل واجهة برمجة التطبيقات Places API أو واجهة برمجة التطبيقات Places API (الإصدار الجديد) أو كلتاهما. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفعيل واجهات برمجة التطبيقات.
  2. في قيود مفتاح واجهة برمجة التطبيقات، فعِّل Places API أو Places API (الإصدار الجديد) أو كليهما. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تقييد مفاتيح واجهة برمجة التطبيقات.

  3. في ملف build.gradle على مستوى التطبيق، حدِّد رقم إصدار. لمزيد من المعلومات، يُرجى الاطّلاع على التثبيت.

  4. يمكنك بدء تشغيل تطبيقك من خلال استدعاء إحدى الطريقتَين التاليتَين: Places.initializeWithNewPlacesApiEnabled() أو Places.initialize().

لمزيد من المعلومات عن اختيار خدمة Places API، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.

ميزات حزمة تطوير البرامج (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()

اعتبارات لاختيار الإصدارات التي سيتم تفعيلها

للمساعدة في تحديد الإصدار الذي تريده، يُرجى مراعاة ما يلي:

  • إذا كنت عميلًا جديدًا بدأت للتو استخدام حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android، عليك البدء باستخدام Places API (الإصدار الجديد) وحزمة SDK الجديدة.
  • إذا كنت عميلًا حاليًا، يمكنك مواصلة استخدام حزمة SDK الحالية. ومع ذلك، للاستفادة من تحسينات الأداء وتحسينات الميزات في حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل Android (الإصدار الجديد)، عليك استخدام حزمة SDK الجديدة. لا يلزم نقل البيانات عند الانتقال إلى حزمة SDK الجديدة، ما عليك سوى اتّباع الخطوات الواردة في مقالة اختيار إصدار حزمة SDK وخدمات واجهة برمجة التطبيقات.
  • في حزمة تطوير برامج "الأماكن" لأجهزة Android (الإصدار الجديد)، تتوفّر الرموز المميّزة للجلسات اعتبارًا من الإصدار 3.5.0. لمزيد من المعلومات، يُرجى الاطّلاع على علامات الجلسة.
  • إنّ المكالمات التي يتم إجراؤها باستخدام التطبيقات المصغّرة للإكمال التلقائي للأماكن تُجري دائمًا مكالمة إلى إكمال الأماكن تلقائيًا، وليس إكمال الأماكن تلقائيًا (جديد)، ولا تتأثر المكالمات التي يتم إجراؤها باستخدام التطبيقات المصغّرة بطريقة البدء.
  • لا تعرض صور الأماكن (جديد) سوى معرّف URI لصورة ثنائية المقياس، في حين تعرض صور الأماكن صورة ثنائية المقياس فقط.
  • لا يتوفّر الموقع الجغرافي الحالي إلا في حزمة تطوير البرامج (SDK) لأماكن Android، وليس في حزمة تطوير البرامج (SDK) لأماكن Android (جديد).

تحسينات في حزمة تطوير برامج "الأماكن" لأجهزة 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 الجديدة أنواع الأماكن الموضّحة في الجدول التالي. يتم عرض هذه الأنواع كجزء من تفاصيل المكان و استجابة البحث النصي. يمكنك أيضًا استخدام هذه الأنواع الجديدة، والأنواع الحالية، في عملية بحث باستخدام ميزة "البحث النصي". يتم تضمين الأنواع الجديدة في الجدول أ.

النوع
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant مزرعة korean_restaurant sporting_goods_store
barber_shop مكان إقامة في مزرعة lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant marina sports_complex
brazilian_restaurant ferry_terminal سوق steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant خياط
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant موتيل thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
مستشار مهبط طائرات الهليكوبتر ملعب vegetarian_restaurant
convention_center hiking_area مرحلة ما قبل المدرسة vietnamese_restaurant
كوخ historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center نزل resort_hotel تاجر جملة
dental_clinic hotel rest_stop

بالإضافة إلى هذه الأنواع الجديدة، نقلت Places API (الإصدار الجديد) الأنواع التالية من الجدول 2 لواجهة برمجة التطبيقات Places API إلى الجدول "أ" لواجهة برمجة التطبيقات Places API (الإصدار الجديد). وهذا يعني أنّه يمكنك الآن استخدام هذه الأنواع كجزء من بحث:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality