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

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

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

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

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

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

بالإضافة إلى تحديد رقم إصدار حزمة SDK، يجب عليك أيضًا اختيار خدمة Places API (واجهة برمجة التطبيقات للأماكن) التي تستدعيها حزمة 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()

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

للمساعدة في تحديد الإصدار الذي يجب اختياره، ضع في اعتبارك ما يلي:

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

تحسينات في حزمة تطوير برامج الأماكن لأجهزة Android (جديدة)

يتناول هذا القسم الميزات الأساسية التي تمت إضافتها إلى حزمة "SDK للأماكن" على أجهزة Android (جديدة).

تم التنفيذ على منصة Google Cloud العادية

يتم تنفيذ حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ نظامًا أساسيًا أكثر أمانًا وموثوقية. يساهم هذا التصميم العادي في تحقيق مستوى من الاتساق على مستوى حِزم SDK التي تعمل على تحسين كفاءة التطوير باستخدام حزمة "SDK للأماكن" على Android (جديدة).

تحسين الأداء

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

الميزات الجديدة

تتضمن حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) أحدث الإصدارات من كل ميزات حزمة تطوير البرامج (SDK):

خدمة "البحث النصي" الجديدة

Text Search (جديد) تعرض معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة - على سبيل المثال "مطعم بيتزا في دبي" أو "متاجر أحذية بالقرب من أوتاوا" أو "123 الشارع الرئيسي". تستجيب الخدمة بقائمة من الأماكن التي تتطابق مع السلسلة النصية وأي تحيز للموقع تم تعيينه.

تمت إضافة بيانات استجابة جديدة إلى تفاصيل المكان (جديد) وصور المكان (جديدة)

  • تفاصيل المكان (جديد) يتضمن الآن فئة المراجعة الجديدة في كائن الاستجابة Place. تحتوي فئة Place على طريقة getReviews() الجديدة لإتاحة هذا الحقل. اتصل بالرقم getReviews() لعرض ما يصل إلى خمس مراجعات عن مكان معيّن.

  • صورة المكان (جديد) يضيف AuthorAttributions إلى الصف PhotoMetadata. يحتوي AuthorAttributions على List من AuthorAttribution كائنات.

تمت إضافة رد معرف موارد منتظم (URI) جديد إلى صور المكان (جديد)

يمكنك الآن استخدام Place Photo (وضع الصورة) (جديد) لعرض معرّف الموارد المنتظم (URI) إلى صورة نقطية. في السابق، كان بإمكانك إرجاع الصورة النقطية للصورة نفسها فقط.

الأسعار المبسّطة

تم تبسيط الأسعار باستخدام حزمة "حزمة تطوير البرامج للأماكن" لنظام التشغيل 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
مستشار مهبط طائرات هليكوبتر playground 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 إلى الجدول A في Places API (جديدة). هذا يعني أنه يمكنك الآن استخدام هذه الأنواع كجزء من البحث:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality