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

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

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

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

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

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

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

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

  • Places API (الإصدار الجديد): تتيح جميع واجهات برمجة التطبيقات والميزات الجديدة الموضّحة في الميزات الرئيسية التي تمت إضافتها إلى حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل 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 لواجهة برمجة التطبيقات Places API إلى الجدول "أ" لواجهة برمجة التطبيقات Places API (الإصدار الجديد). وهذا يعني أنّه يمكنك الآن استخدام هذه الأنواع كجزء من بحث:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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

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

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

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

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

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

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

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