تم تغيير تنسيق الاستجابة لواجهات برمجة التطبيقات الجديدة مثل تفاصيل المكان والبحث عن قرب والبحث النصي من تنسيق واجهات برمجة التطبيقات الحالية. ويكمن الاختلاف الرئيسي في تنسيق عنصر Place
الذي تعرضه كل طريقة، كما هو موضّح في مقالة التغييرات على عنصر الاستجابة Place.
بالإضافة إلى ذلك، تم أيضًا تغيير حقول المستوى الأعلى لكائن الردّ لكل واجهة برمجة تطبيقات. يمكنك الاطّلاع على:
- التغييرات في الردود على ميزة "البحث النصي"
- التغييرات في استجابة "بحث عن قرب"
- التغييرات في الردود على "تفاصيل المكان"
التغييرات التي طرأت على كائن "Place" (المكان)
يعرض هذا الجدول التغييرات التي أُجريت على الكائن الجديد
Place
في الاستجابة لكل من تفاصيل المكان (جديد)
والبحث عن قرب (جديد)
والبحث النصي (جديد) مقارنةً بالكائن Place
الحالي
.
يستخدم كائن الاستجابة الجديد حالة الجمل لأسماء الحقول ويحتوي على حقول جديدة ويعيد تسمية بعض الحقول الحالية.
الحقل | عنصر مكان حالي | كائن "مكان" جديد | Notes |
---|---|---|---|
مكوّن العنوان | 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 |
New | |
وضع النوع الأساسي كسلسلة نصية | primaryTypeDisplayName |
New | |
ساعات العمل الثانوية المنتظمة الأسبوعية، مع الاستثناءات وجميع البيانات الأخرى | regularSecondaryOpeningHours |
New | |
خيارات الدفع التي يقبلها المكان | paymentOptions |
New | |
خيارات مواقف السيارات | parkingOptions |
New | |
قائمة بالوجهات الفرعية المرتبطة بالمكان | subDestinations |
New | |
أحدث المعلومات حول خيارات الوقود في محطة وقود | fuelOptions |
New | |
معلومات عن شحن المركبات الكهربائية لأحد الأماكن | evChargeOptions |
New | |
سمات الأماكن | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
New |
تغييرات استجابة البحث النصي
يعرض الجدول التالي التغييرات التي طرأت على حقول المستوى الأعلى في
كائن الاستجابة
للبحث النصي الحالي وكائن الاستجابة
للبحث النصي (جديد). بالنسبة إلى واجهة برمجة التطبيقات الجديدة، إنّ مصفوفة places
هي حقل المستوى الأعلى الوحيد في الاستجابة.
الحقل | البحث النصي (الحالي) | البحث النصي (جديد) | Notes |
---|---|---|---|
إحالات الأماكن | html_attributions |
تم نقل العنصر إلى العنصر المكان الجديد لكل مكان باعتباره place.attributions . |
|
مجموعة الأماكن | المصفوفة results للكائن Place الحالي |
المصفوفة places للكائن الجديد Place |
|
حالة الطلب | status |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أي رسائل خطأ | error_message |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أي رسائل تتضمّن معلومات | info_messages |
تمت إزالته | |
الرمز المميز للصفحة | next_page_token |
تمت إزالته |
التغييرات في استجابة "بحث عن قرب"
يعرض الجدول التالي التغييرات التي طرأت على حقول المستوى الأعلى لـ كائن
الاستجابة
في البحث عن الأجهزة المجاورة وكائن
الاستجابة
للبحث عن قرب (جديد). بالنسبة إلى واجهة برمجة التطبيقات الجديدة، إنّ مصفوفة places
هي حقل المستوى الأعلى الوحيد في الردّ.
الحقل | بحث قريب (حالي) | البحث عن قرب (جديد) | Notes |
---|---|---|---|
إحالات الأماكن | html_attributions |
تم النقل إلى عنصر المكان الجديد لكل مكان باسم place.attributions . |
|
مجموعة الأماكن | المصفوفة results للكائن Place الحالي |
المصفوفة places للكائن الجديد Place |
|
حالة الطلب | status |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أي رسائل خطأ | error_message |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أي رسائل تتضمّن معلومات | info_messages |
تمت إزالته | |
الرمز المميز للصفحة | next_page_token |
تمت إزالته |
التغييرات على الردود على تفاصيل المكان
يعرض الجدول التالي التغييرات التي طرأت على حقول المستوى الأعلى لـ كائن
الاستجابة
لتفاصيل المكان الحالية وكائن
الاستجابة
لتفاصيل المكان (جديد). بالنسبة إلى واجهة برمجة التطبيقات الجديدة، إنّ مصفوفة places
هي حقل المستوى الأعلى الوحيد في الردّ.
الحقل | تفاصيل المكان (الحالية) | تفاصيل المكان (جديد) | Notes |
---|---|---|---|
إحالات الأماكن | html_attributions |
تم النقل إلى كائن Place الجديد باسم attributions |
|
تفاصيل المكان | result التي تحتوي على العنصر Place الحالي |
الكائن Place الجديد | |
حالة الطلب | status |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أي رسائل تتضمّن معلومات | info_messages |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) |