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