مقدمة
تم تغيير تنسيق الرد لواجهات برمجة التطبيقات
تفاصيل المكان (جديدة) والبحث في الأماكن القريبة (جديدة) والبحث النصي (جديدة)
ليصبح مختلفًا عن تنسيق واجهات برمجة التطبيقات القديمة. ويكمن الاختلاف الرئيسي في تنسيق عنصر Place الذي تعرضه كل طريقة، كما هو موضّح في التغييرات على عنصر المكان في الرد.
بالإضافة إلى ذلك، تم أيضًا تغيير الحقول ذات المستوى الأعلى في عنصر الاستجابة لكل واجهة برمجة تطبيقات. يُرجى الاطّلاع على:
- التغييرات في استجابات "البحث النصي"
- التغييرات في ردود "البحث القريب"
- التغييرات في استجابة "تفاصيل المكان"
التغييرات على عنصر المكان الخاص بالرد
يعرض هذا الجدول التغييرات التي تم إجراؤها على العنصر الجديد
Place
في الردّ على طلبات Place Details (New) وNearby Search (New) وText Search (New) مقارنةً بالعنصر القديم
Place.
يستخدم عنصر الردّ الجديد طريقة الكتابة بحروف كبيرة وصغيرة متداخلة لأسماء الحقول، ويحتوي على حقول جديدة، ويعيد تسمية بعض الحقول القديمة.
| الحقل | عنصر Places API (قديمة) | عنصر Places API (جديدة) | ملاحظات |
|---|---|---|---|
| مكوّن العنوان | 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 مصفوفة من عنصر 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 الذي يحتوي على عنصر المكان القديم |
الكائن الجديد مكان | |
| حالة الطلب | status |
تم الانتقال إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
| رسائل المعلومات | info_messages |
تم الانتقال إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) |