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

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

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

• تغييرات في ردّ "بحث النص"
• تغييرات في ردّ "بحث Google" عن الأماكن المجاورة
• تغييرات في استجابة "تفاصيل المكان"

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

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

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

الحقل	عنصر مكان حالي	عنصر "مكان جديد"	ملاحظات
مكوّن العنوان	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 مصفوفة عنصر المكان الحالي	places مصفوفة عنصر المكان الجديد
حالة الطلب	status		تم نقله إلى استجابة HTTP العادية (رمز استجابة HTTP ورسالته)
أي رسائل خطأ	error_message		تم نقله إلى استجابة HTTP العادية (رمز استجابة HTTP ورسالته)
أي رسائل معلومات	info_messages		مُزال
رمز مفتاح الصفحة	next_page_token		مُزال

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

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

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

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

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

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