تدعم 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 (جديدة) بيانات الاستجابة الديناميكية، مثل مدى توفّر محطة شحن المركبات الكهربائية أو أحدث أسعار الوقود لمحطة وقود. استخدم حقول الاستجابة هذه لإنشاء تجارب مستخدم ديناميكية.
أي واجهة برمجة تطبيقات تختارها؟
قبل أن تتمكّن من البدء في تطوير التطبيقات، عليك اختيار واجهة برمجة التطبيقات الخاصة بك:
إذا كنت عميلاً جديدًا مبتدئًا في استخدام Places API، فابدأ بواجهات برمجة التطبيقات الجديدة.
إذا كنت عميلاً جديدًا ولم يتوفّر بديل بعد لواجهة برمجة تطبيقات حالية، مثل الإكمال التلقائي للأماكن أو الإكمال التلقائي لطلب البحث، يمكنك استخدام مجموعة من واجهات برمجة التطبيقات الجديدة والحالية.
إذا كنت عميلاً حاليًا، يمكنك مواصلة استخدام واجهات برمجة التطبيقات الحالية. ومع ذلك، للاستفادة من تحسينات الأداء وتحسينات الميزات في Places API (الجديدة)، يمكنك الانتقال إلى واجهات برمجة التطبيقات الجديدة.
لمزيد من المعلومات حول الترحيل، يُرجى الاطِّلاع على نظرة عامة على نقل البيانات.