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

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

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

التغييرات على كائن "مكان" في الاستجابة

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

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

حقل كائن المكان الحالي كائن مكان جديد Notes
مكوّن العنوان address_components addressComponents
عنوان تنسيق مصغر للمكان 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 الجديد لكل مكان كـ place.attributions
مصفوفة من الأماكن مصفوفة results لكائن Place الحالي مصفوفة places للعنصر Place الجديد
حالة الطلب status تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أي رسائل خطأ error_message تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة)
أيّ رسائل معلومات info_messages تمت إزالتها
الرمز المميز للصفحة next_page_token تمت إزالتها

التغييرات التي طرأت على الردّ في ميزة "البحث عن قرب"

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

حقل البحث عن قرب (حالي) بحث قريب (جديد) Notes
إحالات الأماكن html_attributions تم نقله إلى كائن Place الجديد لكل مكان باسم 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 والرسالة)