مقدمة
تغيّر تنسيق الردود لواجهات برمجة التطبيقات
تفاصيل المكان (جديدة) والبحث في الأماكن القريبة (جديدة) والبحث النصي (جديدة)
عن تنسيق واجهات برمجة التطبيقات القديمة. ويكمن الاختلاف الرئيسي في تنسيق العنصر 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_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 يحتوي على عنصر Place القديم |
الكائن الجديد Place | |
| حالة الطلب | status |
تم الانتقال إلى استجابة HTTP العادية (رمز استجابة HTTP ورسالتها) | |
| رسائل المعلومات | info_messages |
تم الانتقال إلى استجابة HTTP العادية (رمز استجابة HTTP ورسالتها) |