تتوافق حزمة تطوير برامج الأماكن لنظام التشغيل iOS مع إصدارين من حزمة تطوير البرامج: حزمة SDK للأماكن لنظام التشغيل iOS هي حزمة SDK الحالية للأماكن لنظام التشغيل iOS (الجديدة) هي إصدار الجيل التالي من حزمة SDK.
مع إطلاق الإصدار 8.5.0 من حزمة تطوير البرامج للأماكن (SDK) في الأماكن، مهمتك الأولى هي تحديد حزمة SDK التي ستستخدمها. هذا صحيح إذا كنت عميلاً جديدًا أو عميلاً حاليًا تستخدم حزمة SDK بالفعل. يمكنك استخدام هذا الدليل لفهم الاختلافات الرئيسية بين حزمتَي تطوير البرامج (SDK).
كيفية اختيار إصدار حزمة تطوير البرامج (SDK)
تعتمد حزمة تطوير برامج الأماكن لنظام التشغيل iOS على خدمة واجهة برمجة تطبيقات الأماكن. قبل أن تتمكن من استخدام حزمة تطوير برامج الأماكن لنظام التشغيل iOS، يجب عليك تفعيل خدمة واجهة برمجة تطبيقات الأماكن في مشروعك على Google Cloud.
يتحكّم إصدار خدمة Places API الذي تفعِّله في إصدار حزمة تطوير البرامج (SDK) الذي يستخدمه تطبيقك:
Places API: لتفعيل حزمة تطوير البرامج للأماكن (SDK) الحالية لنظام التشغيل iOS في حال تفعيل واجهة برمجة التطبيقات Places API فقط للمشروع المرتبط بمفتاح واجهة برمجة التطبيقات المستخدَم في تطبيقك، لن يتمكّن تطبيقك من الوصول إلى الميزات الجديدة التي تمت إضافتها في الإصدار 8.5.0 من Places SDK for iOS والإصدارات الأحدث.
Places API (جديد): يُمكِّن Places SDK for iOS (جديد) بما في ذلك Text Search وجميع الميزات الجديدة الموضحة في الميزات الرئيسية التي تمت إضافتها إلى حزمة الأماكن لـ iOS (جديدة). لا يؤدي إلى تفعيل الميزات الحالية مثل "تفاصيل الأماكن" و"صور الأماكن" و"المكان الحالي" و"الإكمال التلقائي للأماكن".
كلاهما: يتيح تفعيل جميع الميزات لكل من حزمة SDK للأماكن لنظام التشغيل iOS (الجديدة) وحزمة SDK للأماكن لنظام التشغيل iOS.
لمزيد من المعلومات حول اختيار خدمة Places API، يمكنك الاطّلاع على إعداد مشروعك على Google Cloud.
ما هي حزمة تطوير البرامج (SDK) التي تختارها؟
للمساعدة في تحديد الإصدار الذي يجب اختياره:
إذا كنت عميلاً جديدًا، بدأت للتو باستخدام حزمة تطوير برامج الأماكن لأجهزة iOS، فابدأ بكل من واجهة برمجة تطبيقات الأماكن (جديدة) وواجهة برمجة تطبيقات الأماكن حتى تتمكن من الوصول إلى جميع الميزات.
إذا كنت عميلاً حاليًا، يمكنك مواصلة استخدام حزمة تطوير البرامج (SDK) الحالية. ومع ذلك، للاستفادة من تحسينات الأداء وتحسينات ميزات حزمة تطوير البرامج للأماكن المخصّصة لنظام التشغيل iOS (الجديدة)، يمكنك استخدام حزمة تطوير البرامج (SDK) الجديدة.
وليس عليك نقل البيانات عند الانتقال إلى حزمة تطوير البرامج (SDK) الجديدة. ما عليك سوى تفعيل حزمة SDK للأماكن لنظام التشغيل iOS (الجديدة) على مفتاح واجهة برمجة التطبيقات المستخدم في تطبيقك. وإذا كنت تستخدم كلاً من حزمة SDK الحالية للأماكن لنظام التشغيل iOS وحزمة SDK للأماكن لنظام التشغيل iOS (جديد)، يمكنك تفعيل كلا الإصدارين على مفتاح واجهة برمجة التطبيقات الخاص بك. لمزيد من المعلومات، يمكنك الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.
الميزات الرئيسية التي تمت إضافتها إلى حزمة تطوير برامج الأماكن لأجهزة iOS (جديدة)
يتناول هذا القسم الميزات الأساسية التي تمت إضافتها إلى حزمة تطوير برامج الأماكن لنظام التشغيل iOS (جديدة).
تم التنفيذ على منصة Google Cloud العادية
يتم تنفيذ Places SDK for iOS (جديد) على البنية الأساسية للخدمة على Google Cloud. يوفّر هذا التنفيذ نظامًا أساسيًا أكثر أمانًا وموثوقية. يوفّر هذا التصميم العادي مستوى من الاتساق على مستوى حِزم SDK التي تعمل على تحسين كفاءة التطوير باستخدام Places SDK for iOS (جديد).
تحسين الأداء
توفر حزمة تطوير البرامج (SDK) لميزة "الأماكن" لنظام التشغيل iOS (الجديدة) أداءً محسنًا، مما يجعل من المفيد استبدال التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) الحالية.
خدمة "البحث النصي" الجديدة
تعرض ميزة البحث النصي معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة، على سبيل المثال "فطائر في دبي" أو "متاجر أحذية بالقرب من أوتاوا" أو "123 الشارع الرئيسي". تستجيب الخدمة بقائمة من الأماكن التي تطابق السلسلة النصية وأي تحيز للموقع تم تعيينه.
الأسعار المبسّطة
تم تبسيط الأسعار باستخدام حزمة تطوير البرامج (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 |
مستشار | مهبط طائرات هليكوبتر | 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 |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality