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

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

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

• التغييرات في الردود على ميزة "البحث النصي"
• التغييرات في استجابة "بحث عن قرب"
• التغييرات في الردود على "تفاصيل المكان"

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

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

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

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

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

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

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

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

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

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

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

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

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