يتم تحديد حزمة Places SDK لميزات iOS المتاحة في تطبيقك من خلال رقم إصدار حزمة SDK (على سبيل المثال 9.0.0) الذي تحدّده في تبعيات الحزمة وواجهات برمجة التطبيقات المفعَّلة على مفتاح واجهة برمجة التطبيقات. يوضّح هذا الدليل الاختلافات بين الإصدارات وكيفية اختيار الإصدارات التي يتم تفعيلها في تطبيقك.
أرقام إصدارات حزمة تطوير البرامج (SDK)
إنّ رقم إصدار حزمة تطوير البرامج (SDK) الذي تحدّده في اعتماديات الحزمة يحدِّد ما إذا كان يمكن لتطبيقك الوصول إلى الميزات التي تمت إضافتها في إصدار معيّن. على سبيل المثال، لا تتوفّر ميزة "الإكمال التلقائي" (الجديدة) إلا في الإصدار 9.0.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK).
لمزيد من المعلومات حول التغييرات التي تم تقديمها في كل إصدار من إصدارات حزمة SDK، اطّلِع على ملاحظات إصدار حزمة تطوير البرامج (SDK) للأماكن لأجهزة iOS.
إصدارات واجهة برمجة تطبيقات الأماكن لحزمة تطوير برامج الأماكن لأجهزة iOS
بالإضافة إلى تحديد رقم إصدار حزمة SDK، عليك أيضًا اختيار خدمة Places API التي تستدعيها حزمة SDK في Google Cloud Console: إما Places API أو Places API (جديدة). بالإضافة إلى رقم إصدار حزمة SDK، تحدِّد خدمة واجهة برمجة التطبيقات التي تختارها إصدار ميزات معيَّنة متوفّرة في تطبيقك، مثل "الإكمال التلقائي" أو "الإكمال التلقائي" (جديد). على الرغم من أنه لا يمكنك تحديد سوى رقم إصدار واحد من حزمة SDK، يمكنك تفعيل كل من 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):
الميزة | تم تفعيل Places API على مفتاح واجهة برمجة التطبيقات | الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) |
---|---|---|
الإكمال التلقائي (جديد) | Places API (جديدة) | 9.0.0 |
تفاصيل المكان (جديد) | Places API (جديدة) | 9.0.0 |
البحث عن الأجهزة المجاورة (جديد) | Places API (جديدة) | 9.0.0 |
صور المكان (جديدة) | Places API (جديدة) | 9.0.0 |
البحث النصي (جديد) | Places API (جديدة) | 8.5.0 |
الإكمال التلقائي للأماكن | واجهة برمجة تطبيقات الأماكن | 3.0.0 |
المكان الحالي | واجهة برمجة تطبيقات الأماكن | 3.0.0 |
تفاصيل المكان | واجهة برمجة تطبيقات الأماكن | 3.0.0 |
صور المكان | واجهة برمجة تطبيقات الأماكن | 3.0.0 |
اعتبارات اختيار الإصدارات التي سيتم تفعيلها
- إذا كنت عميلاً جديدًا وبدأت للتو في استخدام Places SDK لنظام التشغيل iOS، فابدأ بـ Places API (الجديدة) وحزمة تطوير البرامج (SDK) الجديدة.
- إذا كنت عميلاً حاليًا، يمكنك مواصلة استخدام حزمة تطوير البرامج (SDK) الحالية. ومع ذلك، للاستفادة من تحسينات الأداء وتحسينات الميزات في حزمة تطوير برامج الأماكن لنظام التشغيل iOS (الجديدة)، يجب تفعيل واجهة برمجة تطبيقات الأماكن (جديدة) واستخدام حزمة تطوير البرامج (SDK) الجديدة. ليس من الضروري إجراء أي عملية نقل عند الانتقال إلى حزمة SDK الجديدة، ما عليك سوى اتّباع الخطوات الواردة في مقالة اختيار إصدار حزمة SDK وخدمات واجهة برمجة التطبيقات.
- لا تفعّل Places API (الجديدة) بعض الميزات الحالية، مثل Current
Place
و
GMSPlace.isOpen
وGMSPlaceisOpenAtDate
.
استخدام إصدار المعاينة من GooglePlacesSwift
الخطوات التالية مطلوبة لاستخدام GooglePlacesSwift:
- فعِّل Places API (جديد)
- أضف GooglePlacesSwiftSDK إلى الموارد التابعة لك.
- عليك إعداد برنامج "الأماكن" باستخدام
PlacesClient
.
لمزيد من المعلومات حول GooglePlacesSwift، يمكنك مراجعة المستندات المرجعية.
النقل إلى واجهات برمجة التطبيقات الجديدة
إذا كنت تستخدم واجهة برمجة تطبيقات حالية وتريد نقل البيانات إلى واجهة برمجة تطبيقات جديدة، يمكنك الاطّلاع على أدلة نقل البيانات التالية لكل واجهة برمجة تطبيقات:
- النقل إلى تفاصيل المكان (جديد)
- نقل البيانات إلى صورة المكان (ميزة جديدة)
- نقل البيانات إلى ميزة "الإكمال التلقائي" (ميزة جديدة)
تحسينات في حزمة تطوير برامج الأماكن لأجهزة iOS (جديدة)
يتناول هذا القسم الميزات الأساسية التي تمت إضافتها إلى حزمة تطوير برامج الأماكن لأجهزة iOS (جديد).
تم التنفيذ على منصة Google Cloud العادية
تم تنفيذ حزمة تطوير برامج الأماكن لنظام التشغيل iOS (جديد) في البنية الأساسية للخدمة على Google Cloud. وتوفّر عملية التنفيذ هذه منصة أكثر أمانًا وموثوقية. يوفّر هذا التصميم العادي مستوى من الاتساق عبر حِزم تطوير البرامج (SDK)، ما يحسّن كفاءة التطوير باستخدام Places SDK لنظام التشغيل iOS (جديد).
تحسين الأداء
تقدم حزمة تطوير برامج الأماكن لأجهزة iOS (الجديدة) أداءً محسنًا، مما يجعل من المجدي استبدال التطبيقات التي تستخدم SDK الحالي.
الميزات الجديدة
تشتمل حزمة تطوير برامج الأماكن لأجهزة iOS (الجديدة) على أحدث إصدارات جميع ميزات حزمة تطوير البرامج (SDK):
- الإكمال التلقائي (جديد)
- تفاصيل المكان (جديد)
- البحث عن الأجهزة المجاورة (جديد)
- صور المكان (جديدة)
- البحث النصي (جديد)
الأسعار المبسّطة
وقد تم تبسيط الأسعار من خلال حزمة Places 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 لواجهة برمجة تطبيقات الأماكن إلى الجدول أ لواجهة برمجة تطبيقات الأماكن (جديدة). وهذا يعني أنّه يمكنك الآن استخدام الأنواع التالية كجزء من عملية البحث:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality