تنسيق الرد الجديد
تفاصيل المكان
البحث عن قرب،
أو
البحث النصي
تم تغيير تنسيق واجهات برمجة التطبيقات الحالية. يتمثل الاختلاف الرئيسي في
تنسيق الكائن 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 والرسالة) |