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

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

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

التغييرات على عنصر "الموقع الجغرافي" في الاستجابة

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

يستخدم عنصر الاستجابة الجديد أسلوب camel-casing لأسماء الحقول، ويحتوي على حقول جديدة، ويعيد تسمية بعض الحقول القديمة.

الحقل عنصر "الموقع الجغرافي" القديم عنصر مكان جديد ملاحظات
مكوّن العنوان 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
المراجعات reviews reviews
ساعات العمل الثانوية للأسبوع القادم اعتبارًا من اليوم، مع الاستثناءات وجميع البيانات الأخرى secondary_opening_hours currentSecondaryOpeningHours
أنواع الأماكن types types
عنوان URL للمكان على "خرائط Google" url googleMapsUri
عدد تقييمات المستخدمين user_ratings_total userRatingCount
فارق الوقت عن التوقيت العالمي المنسَّق 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 جديد
ضع النوع الأساسي كسلسلة نصية. primaryTypeDisplayName جديد
ساعات العمل الثانوية العادية الأسبوعية، مع الاستثناءات وجميع البيانات الأخرى regularSecondaryOpeningHours جديد
خيارات الدفع التي يقبلها المكان paymentOptions جديد
خيارات مواقف السيارات في المكان parkingOptions جديد
قائمة الوجهات الفرعية المرتبطة بالمكان subDestinations جديد
أحدث المعلومات حول خيارات الوقود في محطة وقود fuelOptions جديد
معلومات حول شحن المركبات الكهربائية في مكان معيّن evChargeOptions جديد
سمات الأماكن outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports جديد

تغييرات في ردّ "البحث النصي"

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

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

تغييرات في ردّ "بحث في الجوار"

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

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

تغييرات في ردّ "تفاصيل المكان"

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

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