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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تحسين الأداء

تتيح واجهة 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
مستشار مهبط لطائرات الهليكوبتر ملعب 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

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

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

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

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

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

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

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

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