اختيار إصدار واجهة برمجة التطبيقات

تتوافق واجهة Places API مع إصدارين من واجهة برمجة التطبيقات: Places API عبارة عن واجهات برمجة التطبيقات الحالية وPlaces API (جديدة)، وهي الإصدار التالي من واجهات برمجة التطبيقات.

مع إصدار واجهة Places API (الجديدة)، ستكون مهمتك الأولى هي تحديد مجموعة واجهات برمجة التطبيقات التي تريد استخدامها. هذا صحيح إذا كنت عميلاً جديدًا أو عميلاً حاليًا تستخدم واجهات برمجة التطبيقات من قبل. يمكنك استخدام هذا الدليل لفهم الاختلافات الرئيسية بين واجهتَي برمجة التطبيقات.

قائمة واجهات برمجة التطبيقات

يسرد الجدول التالي مجموعتَي واجهات برمجة التطبيقات. إذا كنت عميلاً حاليًا، استخدِم هذا الجدول لتحديد واجهة برمجة التطبيقات الجديدة التي تحل محل واجهة برمجة التطبيقات التي تستخدمها حاليًا.

واجهة برمجة تطبيقات الأماكن ‫Places API (جديدة) ملاحظة
العثور على مكان البحث النصي (جديد) لا يوجد إصدار جديد من "العثور على المكان". حلَّ البحث النصي (جديد) محله.
البحث عن قرب البحث عن الأجهزة القريبة (جديد) في جميع الطلبات التي تستخدم واجهة برمجة التطبيقات الحالية والتي تتضمّن طلب بحث نصيًا، يجب استخدام البحث النصي (جديد) لأنّ ميزة "البحث عن قرب" (جديد) لا تتيح إدخال النص.
البحث النصي البحث النصي (جديد)
تفاصيل المكان تفاصيل المكان (جديد)
صورة المكان صورة المكان (جديدة)
الإكمال التلقائي للأماكن الإكمال التلقائي (جديد) قيد المعاينة
الإكمال التلقائي لطلب البحث الإكمال التلقائي (جديد) الإمكانات المضافة إلى إصدار المعاينة من الإكمال التلقائي (جديد)

ويتحكم إصدار خدمة Places API الذي تفعِّله على مفتاح واجهة برمجة التطبيقات في واجهات برمجة التطبيقات التي يستخدمها تطبيقك:

  • Places API: لتفعيل واجهات برمجة التطبيقات الحالية في حال تفعيل واجهة برمجة التطبيقات Places API فقط للمشروع المرتبط بمفتاح واجهة برمجة التطبيقات المستخدَم لتطبيقك، لن يتمكّن تطبيقك من الوصول إلى واجهات برمجة التطبيقات الجديدة.

  • Places API (جديدة): يتم تفعيل جميع واجهات برمجة التطبيقات والميزات الجديدة الموضّحة في الميزات الرئيسية المضافة إلى Places SDK لنظام التشغيل iOS (جديدة). لن يتمكن تطبيقك من الوصول إلى واجهات برمجة التطبيقات الحالية.

  • كلاهما: يتيح تفعيل جميع الميزات وواجهات برمجة التطبيقات لكل من حزمة SDK للأماكن لنظام التشغيل iOS (جديد) و حزمة SDK للأماكن لنظام التشغيل iOS.

لمزيد من المعلومات حول اختيار خدمة Places API، يمكنك الاطّلاع على إعداد مشروعك على Google Cloud.

نقل البيانات إلى واجهات برمجة التطبيقات الجديدة

إذا كنت تستخدم واجهة برمجة تطبيقات حالية وتريد نقل البيانات إلى واجهة برمجة التطبيقات الجديدة، يمكنك الاطّلاع على أدلة نقل البيانات التالية لكل واجهة برمجة تطبيقات:

الميزات الأساسية التي تمت إضافتها إلى Places API (جديدة)

يتناول هذا القسم الميزات الأساسية التي تمت إضافتها إلى Places API (جديدة).

تم التنفيذ على منصة Google Cloud العادية

يتم تنفيذ Places API (جديدة) على البنية الأساسية للخدمة على Google Cloud. ويوفر هذا التنفيذ نظامًا أساسيًا أكثر أمانًا وموثوقية باستخدام خيارات أمان محسَّنة مثل OAuth. ويوفر تصميم واجهة برمجة التطبيقات القياسي هذا مستوى من الاتساق عبر واجهات برمجة التطبيقات التي تعمل على تحسين كفاءة التطوير باستخدام واجهة برمجة التطبيقات Places API (جديدة).

تحسين الأداء

توفر واجهة Places API (الجديدة) أداءً محسنًا، مما يجعل من المفيد استبدال التطبيقات التي تستخدم Places API الحالية.

الأسعار المبسّطة

تم تبسيط الأسعار باستخدام Places API (الجديدة) بحيث تدفع مقابل البيانات التي تستخدمها فقط. يتم تطبيق الأسعار المُبسَّطة باستخدام قناع الحقل.

باستخدام "تفاصيل المكان" (جديد) والبحث عن قرب (جديد) والبحث النصي (جديد)، يمكنك استخدام قناع الحقل للتحكم في قائمة الحقول المطلوب عرضها في الرد. وعندئذٍ يتم تحصيل رسوم منك مقابل البيانات المطلوبة فقط. يعد استخدام إخفاء الحقول ممارسة تصميم جيدة لضمان عدم طلب بيانات غير ضرورية، مما يساعد على تجنب وقت المعالجة غير الضروري ورسوم الفوترة.

بيانات استجابة متّسقة لمكان معيّن

باستخدام واجهات برمجة التطبيقات الحالية، عرضت واجهات برمجة التطبيقات "تفاصيل المكان" و"البحث عن قرب" و"البحث النصي" بيانات استجابة مختلفة لمكان معيّن. تعمل واجهة برمجة تطبيقات الأماكن (جديدة) على توحيد الرد بحيث تعرض كل واجهات برمجة التطبيقات هذه البيانات نفسها لمكان ما.

أنواع الأماكن الموسّعة

يمكن أن تحتوي استجابة واجهة برمجة التطبيقات الآن على النوع الأساسي للمكان. يمكن أن يكون لكل مكان قيمة نوع واحدة يتم تحديدها كنوع أساسي للمكان، كما هو موضح في الجدول أ.

بالإضافة إلى ذلك، تضيف واجهة برمجة التطبيقات الجديدة أنواع الأماكن الموضحة في الجدول أدناه. يمكنك استخدام هذه الأنواع الجديدة والأنواع الحالية في البحث باستخدام "البحث عن قرب" (جديد) والبحث النصي (جديد). ويتم إدراج الأنواع الجديدة كلها في الجدول أ.

النوع
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 (الجديدة) الأنواع التالية من الجدول "ب" من الجدول "أ". وهذا يعني أنّه يمكنك الآن استخدام الأنواع التالية كجزء من عملية بحث:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

بيانات الأماكن الديناميكية

تتيح واجهة Places API (الجديدة) بيانات الاستجابة الديناميكية، مثل مدى توفّر محطة شحن للمركبات الكهربائية أو أحدث أسعار الوقود لمحطة وقود. استخدِم حقول الاستجابة هذه لإنشاء تجارب مستخدم ديناميكية.

أي واجهة برمجة تطبيقات تختارها؟

قبل البدء بتطوير التطبيق، عليك اختيار واجهة برمجة التطبيقات:

  1. إذا كنت عميلاً جديدًا، بدأت للتو باستخدام واجهة برمجة تطبيقات الأماكن، ثم ابدأ باستخدام واجهات برمجة التطبيقات الجديدة.

  2. إذا كنت عميلاً جديدًا ولم يكن هناك بديل حتى الآن لواجهة برمجة تطبيقات حالية، مثل الإكمال التلقائي لمكان أو الإكمال التلقائي لطلب البحث، فيمكنك استخدام مزيج من واجهات برمجة التطبيقات الجديدة والحالية.

  3. إذا كنت عميلاً حاليًا، يمكنك مواصلة استخدام واجهات برمجة التطبيقات الحالية. وللاستفادة من تحسينات الأداء وتحسينات ميزات واجهة Places API (الجديدة)، يمكنك الانتقال إلى واجهات برمجة التطبيقات الجديدة.

    لمزيد من المعلومات حول نقل البيانات، يُرجى الاطّلاع على نظرة عامة على نقل البيانات.