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

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

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

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

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

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

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

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

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

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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

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

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

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

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

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

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

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