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

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

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

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

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

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

بالإضافة إلى تحديد رقم إصدار حزمة SDK، عليك أيضًا اختيار قسم "الأماكن" خدمة واجهة برمجة التطبيقات التي تستدعيها حزمة SDK في Google Cloud Console: إما Places API أو Places API (جديدة). بالإضافة إلى رقم إصدار حزمة SDK، فإن خدمة واجهة برمجة التطبيقات التي تحديد إصدار الميزات المحددة المتوفرة في التطبيق مثل الإكمال التلقائي أو الإكمال التلقائي (جديد). يمكنك تحديد حزمة تطوير برامج (SDK) واحدة فقط رقم الإصدار، يمكنك تمكين كل من Places API و Places API (الجديدة) على مفتاح واجهة برمجة التطبيقات في الوقت نفسه، ثم اختيار الخدمة التي تطلب حزمة تطوير البرامج (SDK) من خلالها الطريقة التي تستخدمها لإعداد حزمة SDK في تطبيقك. ومع ذلك، في معظم الحالات، ستحتاج إلى تمكين واجهة برمجة تطبيقات الأماكن (جديدة) واستخدام الإصدارات (الجديدة) من ميزات حِزم 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، ثم ابدأ بـ Places API (الجديدة) وحزمة SDK الجديدة.
  • إذا كنت عميلاً حاليًا، يمكنك مواصلة استخدام حزمة تطوير البرامج (SDK) الحالية. مع ذلك، يمكن الاستفادة من تحسينات الأداء والميزة في حزمة تطوير برامج الأماكن لأجهزة Android (جديد)، فيجب عليك استخدام الإصدار الجديد SDK. ليس من الضروري إجراء عملية نقل عند الانتقال إلى حزمة تطوير البرامج (SDK) الجديدة، ما عليك سوى اتّباع الخطوات الواردة في مقالة اختيار إصدار حزمة تطوير البرامج (SDK) وواجهة برمجة التطبيقات (API) .
  • في حزمة تطوير برامج الأماكن لنظام التشغيل Android (جديد)، تتوفر الرموز المميزة للجلسة بدءًا من في الإصدار 3.5.0. لمزيد من المعلومات، يُرجى مراجعة الجلسة الرموز المميزة.
  • تتصل دائمًا المكالمات التي يتم إجراؤها باستخدام أدوات الإكمال التلقائي للأماكن بالمكان الإكمال التلقائي، وليس الإكمال التلقائي للأماكن (جديد) لا تتأثر استدعاءات الأداة إجراء التهيئة.
  • صور المكان (جديدة) فقط عنوان URI إلى صورة نقطية، بينما مكان تعرض "صور Google" صورة نقطية فقط. .
  • المكان الحالي هو متاح فقط في حزمة تطوير برامج الأماكن لأجهزة Android، وليس في حزمة تطوير برامج الأماكن لأجهزة Android (جديد).

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

يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى حزمة تطوير برامج الأماكن لنظام التشغيل Android (الإصدار الجديد).

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

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

تحسين الأداء

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

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

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

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

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

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

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

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

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

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

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

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality