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

مقدمة

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

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

• التغييرات في الردود على طلبات البحث النصي
• التغييرات في الردود على طلبات البحث في الجوار
• التغييرات في الردود على طلبات تفاصيل المكان

التغييرات التي تم إجراؤها على عنصر Place في الردود

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

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

الحقل	عنصر Places API (قديمة)	عنصر Places API (جديدة)	ملاحظات
مكوّن العنوان	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
المراجعات	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	جديد

التغييرات في الردود على طلبات البحث النصي

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

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

التغييرات في الردود على طلبات البحث في الجوار

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

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

التغييرات في الردود على طلبات تفاصيل المكان (جديدة)

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

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