تتيح Places API إصدارَين من واجهة برمجة التطبيقات: Places API هي واجهات برمجة التطبيقات الحالية وPlaces API (الإصدار الجديد) هي الجيل التالي من واجهات برمجة التطبيقات.
مع إصدار Places API (الإصدار الجديد)، تكون مهمتك الأولى هي تحديد مجموعة واجهات برمجة التطبيقات التي تريد استخدامها. وينطبق ذلك إذا كنت عميلًا جديدًا أو عميلًا حاليًا يستخدم واجهات برمجة التطبيقات. يمكنك استخدام هذا الدليل لفهم الاختلافات الرئيسية بين أداتَي واجهة برمجة التطبيقات.
قائمة واجهات برمجة التطبيقات
يسرد الجدول التالي كلتا مجموعتَي واجهات برمجة التطبيقات. إذا كنت عميلًا حاليًا، استخدِم هذا الجدول لتحديد واجهة برمجة التطبيقات الجديدة التي تحلّ محل واجهة برمجة التطبيقات التي تستخدمها.
| واجهة برمجة تطبيقات الأماكن | Places API (جديدة) | ملاحظة |
|---|---|---|
| العثور على مكان | البحث النصي (ميزة جديدة) | لا يتوفّر إصدار جديد من ميزة "العثور على مكان". تم استبداله بميزة "البحث عن نص" (جديد). |
| بحث في الجوار | البحث عن الأماكن القريبة (ميزة جديدة) | يجب أن تستخدم جميع الطلبات التي تستخدم واجهة برمجة التطبيقات الحالية والتي تتضمّن طلب بحث نصي البحث النصي (جديد) لأنّ ميزة "البحث عن الأجهزة المجاورة (جديد)" لا تتيح إدخال نص. |
| البحث عن النصوص | البحث النصي (ميزة جديدة) | |
| تفاصيل المكان | تفاصيل المكان (ميزة جديدة) | |
| صور الأماكن | صور الأماكن (ميزة جديدة) | |
| الإكمال التلقائي للأماكن | الإكمال التلقائي (جديد) | |
| الإكمال التلقائي لطلبات البحث | الإكمال التلقائي (جديد) | الإمكانات التي تمت إضافتها إلى ميزة "الإكمال التلقائي" (جديد) |
إنّ إصدار خدمة Places API الذي تفعّله في مفتاح واجهة برمجة التطبيقات يتحكّم في واجهات برمجة التطبيقات التي يستخدمها تطبيقك:
Places API: تفعِّل واجهات برمجة التطبيقات الحالية. إذا تم تفعيل واجهة برمجة التطبيقات Places API فقط للمشروع المرتبط بمفتاح واجهة برمجة التطبيقات المستخدَم في تطبيقك، لن يتمكّن تطبيقك من الوصول إلى واجهات برمجة التطبيقات الجديدة.
Places API (جديد): تتيح جميع واجهات برمجة التطبيقات الجديدة والميزات описанة في الميزات الرئيسية التي تمت إضافتها إلى حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Places (جديد). لن يتمكّن تطبيقك من الوصول إلى واجهات برمجة التطبيقات الحالية.
كلاهما: تفعِّل كل الميزات وواجهات برمجة التطبيقات لكل من حزمة تطوير البرامج (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 (الإصدار الجديد) كي لا تدفع إلا مقابل البيانات التي تستخدمها. يتم تنفيذ التسعير المبسّط باستخدام قناع حقل.
باستخدام طلبات البحث "تفاصيل الأماكن" (جديد) و"البحث في الأماكن القريبة" (جديد) و"البحث النصي" (جديد)، يمكنك استخدام قناع الحقل للتحكّم في قائمة الحقول التي سيتم عرضها في الاستجابة. وبعد ذلك، يتم فقط تحصيل رسوم منك مقابل البيانات التي طلبتها. يُعدّ استخدام حجب الحقول من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.
بيانات استجابة متسقة لمكان معيّن
باستخدام واجهات برمجة التطبيقات الحالية، كانت واجهات برمجة التطبيقات الخاصة بـ "تفاصيل المكان" و"بحث عن الأماكن القريبة" و"بحث نصي" تعرِض بيانات استجابة مختلفة لمكان معيّن. تعمل 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 (الإصدار الجديد). وهذا يعني أنّه يمكنك الآن استخدام هذه الأنواع كجزء من عملية بحث:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
بيانات الأماكن الديناميكية
تتيح Places API (الإصدار الجديد) بيانات الردود الديناميكية، مثل مدى توفّر محطة شحن للمركبات الكهربائية أو أحدث أسعار الوقود لمحطة وقود. استخدِم حقول الردود هذه لتوفير تجارب ديناميكية للمستخدمين.
ما هي واجهة برمجة التطبيقات التي تختارها؟
قبل أن تتمكّن من بدء تطوير التطبيق، عليك اختيار واجهة برمجة التطبيقات:
إذا كنت عميلًا جديدًا بدأت للتو في استخدام Places API، عليك البدء باستخدام واجهات برمجة التطبيقات الجديدة.
إذا كنت عميلًا جديدًا ولم يتوفّر بعد بديل لواجهة برمجة التطبيقات الحالية، مثل "الإكمال التلقائي للأماكن" أو "الإكمال التلقائي للطلبات"، يمكنك استخدام مجموعة من واجهات برمجة التطبيقات الجديدة والحالية.
إذا كنت عميلًا حاليًا، يمكنك مواصلة استخدام واجهة برمجة التطبيقات الحالية. ومع ذلك، للاستفادة من تحسينات الأداء و تحسينات الميزات في Places API (الإصدار الجديد)، يمكنك نقل البيانات إلى واجهات برمجة التطبيقات الجديدة.
لمزيد من المعلومات عن نقل البيانات، يُرجى الاطّلاع على نظرة عامة على نقل البيانات.