إنّ ميزات حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Places المتوفّرة في تطبيقك تُحدَّد باستخدام مجموعة من رقم إصدار حزمة SDK (مثل 3.5.0) الذي تحديده في إعدادات تطبيقك، وواجهات برمجة التطبيقات المفعّلة في مفتاح واجهة برمجة التطبيقات، وطريقة بدء تشغيل تطبيقك. يوضّح هذا الدليل الاختلافات بين الإصدارات وكيفية تحديد الإصدارات التي سيتم تفعيلها في تطبيقك.
أرقام إصدارات حزمة تطوير البرامج (SDK)
يحدِّد رقم إصدار حزمة تطوير البرامج (SDK) الذي تحدّده في ملف build.gradle على مستوى التطبيق ما إذا كان بإمكان تطبيقك الوصول إلى الميزات التي تمت إضافتها في إصدار معين. على سبيل المثال، لا تتوفّر ميزة "الإكمال التلقائي (جديد)" إلا في حزمة تطوير البرامج (SDK) الإصدار 3.5.0 أو الإصدارات الأحدث.
لمزيد من المعلومات عن التغييرات التي تمّ إدخالها في كل إصدار من حزمة SDK، يُرجى الاطّلاع على ملاحظات إصدار حزمة SDK لتطبيق "الأماكن" على Android.
إصدارات Places API لحزمة Places SDK لنظام التشغيل Android
بالإضافة إلى تحديد رقم إصدار حزمة SDK، عليك أيضًا اختيار خدمة واجهة برمجة التطبيقات في Places التي تستدعيها حزمة 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 (الإصدار الجديد) أو كلتاهما. لمزيد من المعلومات، اطّلِع على مقالة تفعيل IDE.
- في قيود مفاتيح واجهة برمجة التطبيقات، فعِّل 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() |
اعتبارات لاختيار الإصدارات التي سيتم تفعيلها
للمساعدة في تحديد النسخة التي تريد استخدامها، ننصحك بالأخذ في الاعتبار ما يلي:
- إذا كنت عميلًا جديدًا بدأت للتو استخدام حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" على Android، عليك البدء باستخدام Places API (الإصدار الجديد) وحزمة SDK الجديدة.
- إذا كنت عميلًا حاليًا، يمكنك مواصلة استخدام حزمة تطوير البرامج (SDK) الحالية. ومع ذلك، للاستفادة من تحسينات الأداء وتحسينات الميزات في حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android (الإصدار الجديد)، عليك استخدام حزمة تطوير البرامج (SDK) الجديدة. لا يلزم نقل البيانات عند الانتقال إلى حزمة SDK الجديدة، ما عليك سوى اتّباع الخطوات الواردة في مقالة اختيار إصدار حزمة SDK وخدمات واجهة برمجة التطبيقات.
- في حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android (الإصدار الجديد)، تتوفّر رموز الجلسات بدءًا من الإصدار 3.5.0. لمزيد من المعلومات، يُرجى الاطّلاع على معرّفات جلسة.
- إنّ طلبات البيانات التي يتم إجراؤها باستخدام التطبيقات المصغّرة "إكمال الأماكن تلقائيًا" تستدعي دائمًا إكمال الأماكن تلقائيًا، وليس إكمال الأماكن تلقائيًا (جديد)، ولا تتأثر طلبات البيانات المقدَّمة من التطبيقات المصغّرة بأسلوب الإعداد.
- لا تعرض Place Photos (الصور في الأماكن) (الإصدار الجديد) سوى عنوان URL لصورة ثنائية المقياس، في حين تعرض Place Photos صورة ثنائية المقياس فقط.
- لا يتوفّر الموقع الجغرافي الحالي إلا في حزمة تطوير البرامج (SDK) لنظام التشغيل Android، وليس في حزمة تطوير البرامج (SDK) لنظام التشغيل Android (الإصدار الجديد).
تحسينات في حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android (ميزة جديدة)
يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى حزمة Places SDK لنظام التشغيل Android (الإصدار الجديد).
تم تنفيذها على منصة Google Cloud العادية
يتم تنفيذ حزمة تطوير البرامج Places SDK لنظام التشغيل Android (الإصدار الجديد) على بنية dasarلخدمة على Google Cloud. يقدّم هذا التنفيذ منصة أكثر أمانًا وموثوقية. يقدّم هذا التصميم العادي مستوى من الاتساق في جميع حِزم تطوير البرامج (SDK) التي تحسِّن كفاءة التطوير باستخدام حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android (جديد).
تحسين الأداء
توفّر حزمة تطوير البرامج (SDK) لتطبيق Places على نظام التشغيل Android (الإصدار الجديد) أداءً محسّنًا، ما يجعله جديرًا باستبدال التطبيقات التي تستخدم حزمة SDK الحالية.
الميزات الجديدة
تتضمّن حزمة SDK لنظام التشغيل Android (الإصدار الجديد) أحدث إصدارات من كل ميزات حزمة SDK:
- الإكمال التلقائي (جديد)
- تفاصيل المكان (ميزة جديدة)
- البحث عن الأماكن القريبة (ميزة جديدة)
- صور الأماكن (ميزة جديدة)
- البحث النصي (ميزة جديدة)
خدمة "البحث عن النص" الجديدة
البحث النصي (جديد) يعرض معلومات عن مجموعة من الأماكن استنادًا إلى سلسلة، مثل "بيتزا في القاهرة" أو "متاجر أحذية بالقرب من الإسكندرية" أو "123 شارع الهرم". تستجيب الخدمة بقائمة بالأماكن التي تتطابق مع سلسلة النصوص وأي موقع جغرافي تم ضبطه.
تمت إضافة بيانات استجابة جديدة إلى "تفاصيل العناصر المعروضة" (ميزة جديدة) و"صور الأماكن" (ميزة جديدة).
يتضمّن تفاصيل المكان (جديد) الآن فئة المراجعة الجديدة في عنصر الاستجابة
Place. تحتوي فئة Place على طريقةgetReviews()الجديدة لتفعيل هذا الحقل. يمكنك الاتصال بالرقمgetReviews()لعرض ما يصل إلى خمس مراجعات لمكان معيّن.تضيف سمة صورة المكان (جديد) العنصر
AuthorAttributionsإلى فئةPhotoMetadata. يحتويAuthorAttributionsعلىListمنAuthorAttributionالعناصر.
تمت إضافة استجابة جديدة لعنوان URL إلى ميزة "صور الأماكن" (جديد)
يمكنك الآن استخدام صورة مكان (جديد) لعرض عنوان URL لصورة نقطية. في السابق، كان بإمكانك عرض الصورة المخطّطة نفسها فقط.
الأسعار المبسّطة
تم تبسيط الأسعار باستخدام حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Places (الإصدار الجديد) كي لا تدفع إلا مقابل البيانات التي تستخدمها. يتم تنفيذ الأسعار المبسّطة باستخدام قوائم الحقول، ويُشار إليها أيضًا باسم أقنعة الحقول.
باستخدام "تفاصيل الأماكن" و"بحث النص"، يمكنك استخدام قوائم الحقول للتحكّم في قائمة الحقول التي سيتم عرضها في الاستجابة. وبعد ذلك، يتم فقط تحصيل رسوم منك مقابل البيانات التي طلبتها. يُعدّ استخدام قائمة الحقول من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.
للحصول على معلومات تفصيلية عن أسعار كلتا حِزم 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 (الإصدار الجديد). وهذا يعني أنّه يمكنك الآن استخدام هذه الأنواع كجزء من عملية بحث:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality