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

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

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

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

في الخلفية، تعتمد حزمة تطوير برامج الأماكن لأجهزة Android على خدمة Places API. قبل أن تتمكن من استخدام حزمة تطوير برامج الأماكن لأجهزة Android، يجب تفعيل خدمة واجهة برمجة تطبيقات الأماكن في مشروعك على Google Cloud.

يتحكم إصدار خدمة Places API الذي تفعِّله في إصدار حزمة تطوير البرامج (SDK) الذي يستخدمه تطبيقك:

  • Places API (جديد): لتفعيل ميزات Places SDK for Android (جديد) وجميع الميزات الجديدة الأخرى الموضحة في الميزات الرئيسية المضافة إلى حزمة SDK للأماكن لأجهزة Android (الجديدة).

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

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

ما هي حزمة تطوير البرامج (SDK) التي تختارها؟

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

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

  2. إذا كنت من مطوري Kotlin، يمكنك استخدام إحدى حزمتي SDK ولكن الميزات الجديدة في Places SDK for Android (جديد) لا تتوفر إلا في Java الإصدار 3.3.0.

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

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

    وليس عليك نقل البيانات عند الانتقال إلى حزمة تطوير البرامج (SDK) الجديدة. عليك فقط إجراء ما يلي:

    1. فعِّل Places API (جديد) على مفتاح واجهة برمجة التطبيقات المستخدَم في تطبيقك. إذا كنت تستخدم كلاً من حزمة Places SDK الحالية لنظام التشغيل Android وحزمة Places SDK على نظام Android (جديد)، ننصحك بإنشاء مفتاح واجهة برمجة تطبيقات منفصل لكل إصدار من إصدارات واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.
    2. في القسم dependencies من ملف build.gradle على مستوى الوحدة، عدِّل تبعية places وأضِف التبعية kotlin-bom:

        dependencies {
            implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
            implementation 'com.google.android.libraries.places:places:3.3.0'
        }

      لمزيد من المعلومات حول تبعية kotlin-bom، راجِع استخدام أحدث إصدار من kotlin-stdlib في التبعيات المتعدّدة.

    3. عليك تحديث تطبيقك الحالي لطلب طريقة Places.initializeWithNewPlacesApiEnabled() الجديدة لإعداد تطبيقك. لمزيد من المعلومات، يمكنك الاطّلاع على إعداد برنامج Places API.

    ستظل تطبيقاتك الحالية تعمل بدون تغيير، ولكن يمكنك الآن الاستفادة من جميع ميزات حزمة SDK الجديدة.

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

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

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

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

تحسين الأداء

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

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

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

تمت إضافة بيانات رد جديدة إلى "تفاصيل المكان" و"صور المكان".

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

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

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

تم تبسيط الأسعار باستخدام حزمة "حزمة تطوير البرامج للأماكن" لنظام التشغيل 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
إلى جانب هذه الأنواع الجديدة، نقلت حزمة تطوير البرامج للأماكن المخصّصة لنظام التشغيل Android (الجديدة) الأنواع التالية من الجدول "ب" من الجدول "أ". وهذا يعني أنّه يمكنك الآن استخدام الأنواع التالية كجزء من عملية بحث:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality