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