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

تنسيق الرد الجديد تفاصيل المكان البحث عن قرب، أو البحث النصي تم تغيير تنسيق واجهات برمجة التطبيقات الحالية. يكمن الاختلاف الرئيسي في تنسيق عنصر 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	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 للكائن 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 والرسالة)