لقد تم تغيير تنسيق الرد لواجهات برمجة التطبيقات الجديدة
تفاصيل المكان
والبحث عن قرب
والبحث النصي
من تنسيق واجهات برمجة التطبيقات الحالية. يتمثل الاختلاف الرئيسي في
تنسيق الكائن Place
الذي تعرضه كل طريقة، كما هو موضح في
التغييرات في كائن مكان الاستجابة.
بالإضافة إلى ذلك، تغيّرت أيضًا حقول المستوى الأعلى لكائن الاستجابة لكل واجهة برمجة تطبيقات. يُرجى الاطّلاع على:
- التغييرات في الردود على ميزة "البحث النصي"
- التغييرات في الردود على ميزة "البحث عن قرب"
- التغييرات على الردّ على تفاصيل المكان
التغييرات على كائن "مكان" في الاستجابة
يعرض هذا الجدول التغييرات التي تم إجراؤها على عنصر
Place
الجديد
في الاستجابة لكل من "تفاصيل المكان" (جديد)
والبحث عن قرب (جديد)
والبحث النصي (جديد) مقارنةً بعنصر
Place
الحالي.
يستخدم كائن الاستجابة الجديد حالة الجمل لأسماء الحقول ويحتوي على حقول جديدة ويعيد تسمية بعض الحقول الموجودة.
حقل | كائن المكان الحالي | كائن مكان جديد | Notes |
---|---|---|---|
مكوّن العنوان | 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 |
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 الجديد لكل مكان كـ place.attributions |
|
مصفوفة من الأماكن | مصفوفة results لكائن Place الحالي |
مصفوفة places للعنصر Place الجديد |
|
حالة الطلب | status |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أي رسائل خطأ | error_message |
تم النقل إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
أيّ رسائل معلومات | info_messages |
تمت إزالتها | |
الرمز المميز للصفحة | next_page_token |
تمت إزالتها |
التغييرات التي طرأت على الردّ في ميزة "البحث عن قرب"
يوضح الجدول التالي التغييرات التي تم إجراؤها على حقول المستوى الأعلى لكائن الاستجابة للبحث عن الأجهزة المجاورة وكائن الاستجابة للبحث عن قرب (جديد). وبالنسبة إلى واجهة برمجة التطبيقات الجديدة، لا يكون المصفوفة places
هي حقل المستوى الأعلى الوحيد في الرد.
حقل | البحث عن قرب (حالي) | بحث قريب (جديد) | Notes |
---|---|---|---|
إحالات الأماكن | html_attributions |
تم نقله إلى كائن Place الجديد لكل مكان باسم 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 والرسالة) |