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

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

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

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

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

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

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

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

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

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

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

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

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

حزمة تطوير برامج الأماكن لأجهزة iOS (جديد) الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) حزمة تطوير برامج الأماكن لأجهزة iOS الحد الأدنى لإصدار حزمة تطوير البرامج (SDK)
تفاصيل المكان (ميزة جديدة) 9.0.0 تفاصيل المكان 3.0.0
صور الأماكن (ميزة جديدة) 9.0.0 صور الأماكن 3.0.0
البحث النصي (ميزة جديدة) 8.5.0
البحث عن الأماكن القريبة (ميزة جديدة) 9.0.0
الإكمال التلقائي (جديد) 9.0.0 الإكمال التلقائي 3.0.0
المكان الحالي 3.0.0

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

  • إذا كنت عميلًا جديدًا بدأت للتو استخدام حزمة تطوير البرامج (SDK) لأماكن على نظام التشغيل iOS، عليك البدء باستخدام واجهة برمجة التطبيقات Places API (الإصدار الجديد) وحزمة SDK الجديدة.
  • إذا كنت عميلًا حاليًا، يمكنك مواصلة استخدام حزمة تطوير البرامج (SDK) الحالية. ومع ذلك، للاستفادة من تحسينات الأداء والميزات في حزمة تطوير البرامج (SDK) لنظام التشغيل iOS (الإصدار الجديد) من Places، عليك تفعيل واجهة برمجة التطبيقات (SDK) (الإصدار الجديد) من Places واستخدام حزمة SDK الجديدة. لا يلزم نقل البيانات عند الانتقال إلى حزمة SDK الجديدة، ما عليك سوى اتّباع الخطوات الواردة في مقالة اختيار إصدار حزمة SDK وخدمات IDE.
  • لا تتيح ‫Places API (الإصدار الجديد) بعض الميزات الحالية، مثل المكان الحالي، GMSPlace.isOpen وGMSPlace.isOpenAtDate.

استخدام حزمة تطوير البرامج (SDK) لأماكن Swift لنظام التشغيل iOS (إصدار تجريبي)

يجب اتّباع الخطوات التالية لاستخدام حزمة تطوير البرامج (SDK) لأماكن Swift لأجهزة iOS (إصدار تجريبي):

  1. فعِّل Places API (جديدة).
  2. أضِف حزمة تطوير البرامج (SDK) لنظام التشغيل iOS (إصدار تجريبي) من Places Swift إلى التبعيات.
  3. اضبط إعدادات عميل "الأماكن" باستخدام PlacesClient.

للاطّلاع على مزيد من المعلومات عن حزمة تطوير البرامج (SDK) لنظام التشغيل iOS (إصدار تجريبي) من Places Swift، راجِع نظرة عامة أو دليل نقل البيانات.

نقل البيانات إلى واجهات برمجة التطبيقات الجديدة

إذا كنت تستخدم واجهة برمجة تطبيقات حالية وتريد نقل البيانات إلى واجهة برمجة التطبيقات الجديدة، يمكنك الاطّلاع على أدلة نقل البيانات التالية لكل واجهة برمجة تطبيقات:

تحسينات في حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل iOS (ميزة جديدة)

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

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

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

تحسين الأداء

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

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

تتضمّن حزمة SDK لنظام التشغيل iOS (الإصدار الجديد) أحدث إصدارات من جميع ميزات حزمة SDK:

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

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

باستخدام حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل iOS وميزة "بحث النص"، يمكنك استخدام قوائم الحقول للتحكّم في قائمة الحقول التي سيتم عرضها في الاستجابة. وبعد ذلك، يتم فقط تحصيل رسوم منك مقابل البيانات التي طلبتها. يُعدّ استخدام قائمة الحقول من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.

للحصول على معلومات تفصيلية عن أسعار كلتا حِزم 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