مقدمة
لقد تغيّر تنسيق الاستجابة في واجهات برمجة التطبيقات
تفاصيل المكان (جديدة)
وبحث في الجوار (جديدة)
والبحث النصي (جديدة)
مقارنةً بتنسيق واجهات برمجة التطبيقات القديمة. ويكمن الاختلاف الرئيسي في
تنسيق عنصر Place الذي تعرضه كل طريقة، كما هو موضّح في
التغييرات على عنصر "المكان" في الاستجابة.
بالإضافة إلى ذلك، تم أيضًا تغيير حقول المستوى الأعلى لعنصر الاستجابة لكل واجهة برمجة تطبيقات. يُرجى الاطّلاع على:
التغييرات في عنصر 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" |
In the legacy API, the name field contained the
place name as a text string. في واجهة برمجة التطبيقات الجديدة، تتوفّر هذه المعلومات في 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 لعنصر المكان الجديد |
|
| حالة الطلب | status |
تم نقلها إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
| أي رسائل خطأ | error_message |
تم نقلها إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
| أي رسائل معلومات | info_messages |
تمّت إزالته | |
| الرمز المميّز للصفحة | next_page_token |
تمّت إزالته |
التغييرات في استجابة بحث في الجوار
يوضّح الجدول التالي التغييرات التي طرأت على الحقول ذات المستوى الأعلى في كائن الاستجابة
لخدمة "البحث في الجوار (القديمة)" وكائن الاستجابة
لخدمة "البحث في الجوار (الجديدة)". في واجهة برمجة التطبيقات الجديدة، يكون الحقل الوحيد ذو المستوى الأعلى في الاستجابة هو مصفوفة places.
| الحقل | بحث في الجوار (الإصدار القديم) | Nearby Search (New) | ملاحظات |
|---|---|---|---|
| نَسب الأماكن إلى مؤلفيها | 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 القديم |
عنصر المكان الجديد | |
| حالة الطلب | status |
تم نقلها إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) | |
| أي رسائل معلومات | info_messages |
تم نقلها إلى استجابة HTTP العادية (رمز استجابة HTTP والرسالة) |