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