نقل الاستجابة لواجهة برمجة تطبيقات الأماكن

تم تغيير تنسيق الاستجابة لواجهات برمجة التطبيقات الجديدة مثل تفاصيل المكان والبحث عن قرب والبحث النصي من تنسيق واجهات برمجة التطبيقات الحالية. ويكمن الاختلاف الرئيسي في تنسيق عنصر Place الذي تعرضه كل طريقة، كما هو موضّح في مقالة التغييرات على عنصر الاستجابة Place.

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

التغييرات التي طرأت على كائن "Place" (المكان)

يعرض هذا الجدول التغييرات التي أُجريت على الكائن الجديد Place في الاستجابة لكل من تفاصيل المكان (جديد) والبحث عن قرب (جديد) والبحث النصي (جديد) مقارنةً بالكائن Place الحالي .

يستخدم كائن الاستجابة الجديد حالة الجمل لأسماء الحقول ويحتوي على حقول جديدة ويعيد تسمية بعض الحقول الحالية.

الحقل عنصر مكان حالي كائن "مكان" جديد Notes
مكوّن العنوان address_components addressComponents
وضع عنوان تنسيق Microformat adr_address adrFormatAddress
حالة النشاط التجاري business_status businessStatus
ساعات العمل للأسبوع القادم current_opening_hours currentOpeningHours
الملخص التحريري editorial_summary editorialSummary
العنوان بالتنسيق formatted_address formattedAddress
رقم الهاتف الوطني formatted_phone_number nationalPhoneNumber
الموقع الجغرافي geometry.location location
إطار العرض geometry.viewport viewport
إحالات الأماكن html_attributions attributions حقل المستوى الأعلى للاستجابة في واجهات برمجة التطبيقات الحالية
عنوان URL للرمز icon تمّت إزالة الموضوع. استخدِم iconMaskBaseUri وiconBackgroundColor. راجِع رموز الأماكن للحصول على مزيد من المعلومات.
لون خلفية الرمز icon_background_color iconBackgroundColor
عنوان URL لقناع الرمز icon_mask_base_uri iconMaskBaseUri
رقم الهاتف الدولي international_phone_number internationalPhoneNumber
اسم المكان النصي name displayName يمكن الآن الوصول إلى اسم المكان النصي باستخدام displayName.text وlanguage باسم displayName.languageCode
ساعات العمل opening_hours regularOpeningHours
الصور photos photos تغيّر تنسيق photos في الكائن Place الجديد. لمزيد من المعلومات، راجِع التغيير إلى مراجع الصور.
معرّف المكان place_id id
رمز Plus Codes plus_code plusCode
مستوى السعر price_level priceLevel
Rating rating rating
المراجعات reviews reviews
ساعات العمل الثانوية للأسبوع القادم من اليوم، مع الاستثناءات وجميع البيانات الأخرى secondary_opening_hours currentSecondaryOpeningHours
أنواع الأماكن types types
عنوان URL للمكان في "خرائط Google" url googleMapsUri
عدد تقييمات المستخدمين user_ratings_total userRatingCount
معادلة التوقيت العالمي المنسَّق (UTC) utc_offset utcOffsetMinutes
صيغة قصيرة من العنوان تشمل اسم الشارع والبلدة vicinity shortFormattedAddress
الموقع الإلكتروني الخاص بالمكان website websiteUri
معلومات حول إمكانية دخول الكراسي المتحركة wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance الآن في accessibilityOptions.wheelchairAccessibleEntrance
سمات الأماكن takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
اسم المورد الحقل name في النموذج places/PLACE_ID في واجهة برمجة التطبيقات الحالية، احتوى الحقل name على اسم المكان كسلسلة نصية. وفي واجهة برمجة التطبيقات الجديدة، تتوفّر هذه المعلومات في displayName.
النوع الأساسي للمكان primaryTypeName New
وضع النوع الأساسي كسلسلة نصية primaryTypeDisplayName New
ساعات العمل الثانوية المنتظمة الأسبوعية، مع الاستثناءات وجميع البيانات الأخرى regularSecondaryOpeningHours New
خيارات الدفع التي يقبلها المكان paymentOptions New
خيارات مواقف السيارات parkingOptions New
قائمة بالوجهات الفرعية المرتبطة بالمكان subDestinations New
أحدث المعلومات حول خيارات الوقود في محطة وقود fuelOptions New
معلومات عن شحن المركبات الكهربائية لأحد الأماكن evChargeOptions New
سمات الأماكن outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports New

تغييرات استجابة البحث النصي

يعرض الجدول التالي التغييرات التي طرأت على حقول المستوى الأعلى في كائن الاستجابة للبحث النصي الحالي وكائن الاستجابة للبحث النصي (جديد). بالنسبة إلى واجهة برمجة التطبيقات الجديدة، إنّ مصفوفة places هي حقل المستوى الأعلى الوحيد في الاستجابة.

الحقل البحث النصي (الحالي) البحث النصي (جديد) Notes
إحالات الأماكن html_attributions تم نقل العنصر إلى العنصر المكان الجديد لكل مكان باعتباره place.attributions.
مجموعة الأماكن المصفوفة results للكائن Place الحالي المصفوفة places للكائن الجديد Place
حالة الطلب status تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أي رسائل خطأ error_message تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أي رسائل تتضمّن معلومات info_messages تمت إزالته
الرمز المميز للصفحة next_page_token تمت إزالته

التغييرات في استجابة "بحث عن قرب"

يعرض الجدول التالي التغييرات التي طرأت على حقول المستوى الأعلى لـ كائن الاستجابة في البحث عن الأجهزة المجاورة وكائن الاستجابة للبحث عن قرب (جديد). بالنسبة إلى واجهة برمجة التطبيقات الجديدة، إنّ مصفوفة places هي حقل المستوى الأعلى الوحيد في الردّ.

الحقل بحث قريب (حالي) البحث عن قرب (جديد) Notes
إحالات الأماكن html_attributions تم النقل إلى عنصر المكان الجديد لكل مكان باسم place.attributions.
مجموعة الأماكن المصفوفة results للكائن Place الحالي المصفوفة places للكائن الجديد Place
حالة الطلب status تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أي رسائل خطأ error_message تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أي رسائل تتضمّن معلومات info_messages تمت إزالته
الرمز المميز للصفحة next_page_token تمت إزالته

التغييرات على الردود على تفاصيل المكان

يعرض الجدول التالي التغييرات التي طرأت على حقول المستوى الأعلى لـ كائن الاستجابة لتفاصيل المكان الحالية وكائن الاستجابة لتفاصيل المكان (جديد). بالنسبة إلى واجهة برمجة التطبيقات الجديدة، إنّ مصفوفة places هي حقل المستوى الأعلى الوحيد في الردّ.

الحقل تفاصيل المكان (الحالية) تفاصيل المكان (جديد) Notes
إحالات الأماكن html_attributions تم النقل إلى كائن Place الجديد باسم attributions
تفاصيل المكان result التي تحتوي على العنصر Place الحالي الكائن Place الجديد
حالة الطلب status تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أي رسائل تتضمّن معلومات info_messages تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)